2015-07-24 14:59:36 -04:00
|
|
|
// Package registry contains client primitives to interact with a remote Docker registry.
|
2018-02-05 16:05:59 -05:00
|
|
|
package registry // import "github.com/docker/docker/registry"
|
2013-05-14 21:41:39 -04:00
|
|
|
|
|
|
|
import (
|
2013-12-04 09:03:51 -05:00
|
|
|
"crypto/tls"
|
2013-05-15 16:22:57 -04:00
|
|
|
"errors"
|
2015-07-15 16:42:45 -04:00
|
|
|
"fmt"
|
|
|
|
"io/ioutil"
|
2013-08-04 20:42:24 -04:00
|
|
|
"net"
|
2013-05-14 21:41:39 -04:00
|
|
|
"net/http"
|
2013-12-04 09:03:51 -05:00
|
|
|
"os"
|
2015-07-15 16:42:45 -04:00
|
|
|
"path/filepath"
|
2013-05-14 21:41:39 -04:00
|
|
|
"strings"
|
2013-08-04 20:42:24 -04:00
|
|
|
"time"
|
2014-04-29 05:01:07 -04:00
|
|
|
|
2015-05-17 05:07:48 -04:00
|
|
|
"github.com/docker/distribution/registry/client/transport"
|
2019-11-25 05:12:54 -05:00
|
|
|
"github.com/docker/docker/pkg/homedir"
|
|
|
|
"github.com/docker/docker/rootless"
|
2020-01-06 10:01:02 -05:00
|
|
|
"github.com/docker/go-connections/tlsconfig"
|
|
|
|
"github.com/sirupsen/logrus"
|
2013-05-14 21:41:39 -04:00
|
|
|
)
|
|
|
|
|
2013-07-22 17:50:32 -04:00
|
|
|
var (
|
2015-07-21 15:40:36 -04:00
|
|
|
// ErrAlreadyExists is an error returned if an image being pushed
|
|
|
|
// already exists on the remote side
|
2015-01-07 18:42:01 -05:00
|
|
|
ErrAlreadyExists = errors.New("Image already exists")
|
2013-07-22 17:50:32 -04:00
|
|
|
)
|
2013-05-15 16:22:57 -04:00
|
|
|
|
2015-07-28 13:36:57 -04:00
|
|
|
func newTLSConfig(hostname string, isSecure bool) (*tls.Config, error) {
|
|
|
|
// PreferredServerCipherSuites should have no effect
|
2016-09-02 21:27:20 -04:00
|
|
|
tlsConfig := tlsconfig.ServerDefault()
|
2015-07-28 13:36:57 -04:00
|
|
|
|
|
|
|
tlsConfig.InsecureSkipVerify = !isSecure
|
|
|
|
|
2015-11-19 17:30:29 -05:00
|
|
|
if isSecure && CertsDir != "" {
|
2019-11-25 05:12:54 -05:00
|
|
|
certsDir := CertsDir
|
|
|
|
|
|
|
|
if rootless.RunningWithRootlessKit() {
|
|
|
|
configHome, err := homedir.GetConfigHome()
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
|
|
|
certsDir = filepath.Join(configHome, "docker/certs.d")
|
|
|
|
}
|
|
|
|
|
|
|
|
hostDir := filepath.Join(certsDir, cleanPath(hostname))
|
|
|
|
|
2015-07-28 13:36:57 -04:00
|
|
|
logrus.Debugf("hostDir: %s", hostDir)
|
2016-09-02 21:27:20 -04:00
|
|
|
if err := ReadCertsDirectory(tlsConfig, hostDir); err != nil {
|
2015-07-28 13:36:57 -04:00
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-09-02 21:27:20 -04:00
|
|
|
return tlsConfig, nil
|
2015-07-28 13:36:57 -04:00
|
|
|
}
|
|
|
|
|
2015-02-12 13:23:22 -05:00
|
|
|
func hasFile(files []os.FileInfo, name string) bool {
|
|
|
|
for _, f := range files {
|
|
|
|
if f.Name() == name {
|
|
|
|
return true
|
2013-12-04 09:03:51 -05:00
|
|
|
}
|
2014-08-25 12:50:18 -04:00
|
|
|
}
|
2015-02-12 13:23:22 -05:00
|
|
|
return false
|
2015-05-14 10:12:54 -04:00
|
|
|
}
|
|
|
|
|
2015-07-15 16:42:45 -04:00
|
|
|
// ReadCertsDirectory reads the directory for TLS certificates
|
|
|
|
// including roots and certificate pairs and updates the
|
|
|
|
// provided TLS configuration.
|
|
|
|
func ReadCertsDirectory(tlsConfig *tls.Config, directory string) error {
|
|
|
|
fs, err := ioutil.ReadDir(directory)
|
2020-02-25 05:47:58 -05:00
|
|
|
if err != nil && !os.IsNotExist(err) {
|
2015-07-15 16:42:45 -04:00
|
|
|
return err
|
|
|
|
}
|
|
|
|
|
|
|
|
for _, f := range fs {
|
|
|
|
if strings.HasSuffix(f.Name(), ".crt") {
|
|
|
|
if tlsConfig.RootCAs == nil {
|
2016-10-31 17:52:07 -04:00
|
|
|
systemPool, err := tlsconfig.SystemCertPool()
|
|
|
|
if err != nil {
|
|
|
|
return fmt.Errorf("unable to get system cert pool: %v", err)
|
|
|
|
}
|
|
|
|
tlsConfig.RootCAs = systemPool
|
2015-07-15 16:42:45 -04:00
|
|
|
}
|
|
|
|
logrus.Debugf("crt: %s", filepath.Join(directory, f.Name()))
|
|
|
|
data, err := ioutil.ReadFile(filepath.Join(directory, f.Name()))
|
|
|
|
if err != nil {
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
tlsConfig.RootCAs.AppendCertsFromPEM(data)
|
|
|
|
}
|
|
|
|
if strings.HasSuffix(f.Name(), ".cert") {
|
|
|
|
certName := f.Name()
|
|
|
|
keyName := certName[:len(certName)-5] + ".key"
|
|
|
|
logrus.Debugf("cert: %s", filepath.Join(directory, f.Name()))
|
|
|
|
if !hasFile(fs, keyName) {
|
2017-08-17 15:16:30 -04:00
|
|
|
return fmt.Errorf("missing key %s for client certificate %s. Note that CA certificates should use the extension .crt", keyName, certName)
|
2015-07-15 16:42:45 -04:00
|
|
|
}
|
|
|
|
cert, err := tls.LoadX509KeyPair(filepath.Join(directory, certName), filepath.Join(directory, keyName))
|
|
|
|
if err != nil {
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
tlsConfig.Certificates = append(tlsConfig.Certificates, cert)
|
|
|
|
}
|
|
|
|
if strings.HasSuffix(f.Name(), ".key") {
|
|
|
|
keyName := f.Name()
|
|
|
|
certName := keyName[:len(keyName)-4] + ".cert"
|
|
|
|
logrus.Debugf("key: %s", filepath.Join(directory, f.Name()))
|
|
|
|
if !hasFile(fs, certName) {
|
2016-01-20 13:53:41 -05:00
|
|
|
return fmt.Errorf("Missing client certificate %s for key %s", certName, keyName)
|
2015-07-15 16:42:45 -04:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
2017-10-25 08:39:51 -04:00
|
|
|
// Headers returns request modifiers with a User-Agent and metaHeaders
|
|
|
|
func Headers(userAgent string, metaHeaders http.Header) []transport.RequestModifier {
|
2016-01-04 13:36:01 -05:00
|
|
|
modifiers := []transport.RequestModifier{}
|
|
|
|
if userAgent != "" {
|
|
|
|
modifiers = append(modifiers, transport.NewHeaderRequestModifier(http.Header{
|
|
|
|
"User-Agent": []string{userAgent},
|
|
|
|
}))
|
2015-05-14 10:12:54 -04:00
|
|
|
}
|
2015-05-15 21:35:04 -04:00
|
|
|
if metaHeaders != nil {
|
|
|
|
modifiers = append(modifiers, transport.NewHeaderRequestModifier(metaHeaders))
|
2015-05-14 10:12:54 -04:00
|
|
|
}
|
2015-05-15 21:35:04 -04:00
|
|
|
return modifiers
|
2015-05-14 10:12:54 -04:00
|
|
|
}
|
|
|
|
|
2016-05-07 21:36:10 -04:00
|
|
|
// HTTPClient returns an HTTP client structure which uses the given transport
|
2015-07-21 15:40:36 -04:00
|
|
|
// and contains the necessary headers for redirected requests
|
2015-05-14 10:12:54 -04:00
|
|
|
func HTTPClient(transport http.RoundTripper) *http.Client {
|
|
|
|
return &http.Client{
|
|
|
|
Transport: transport,
|
2015-07-21 15:40:36 -04:00
|
|
|
CheckRedirect: addRequiredHeadersToRedirectedRequests,
|
2015-05-14 10:12:54 -04:00
|
|
|
}
|
2013-12-04 09:03:51 -05:00
|
|
|
}
|
|
|
|
|
2014-06-05 14:37:37 -04:00
|
|
|
func trustedLocation(req *http.Request) bool {
|
|
|
|
var (
|
|
|
|
trusteds = []string{"docker.com", "docker.io"}
|
|
|
|
hostname = strings.SplitN(req.Host, ":", 2)[0]
|
|
|
|
)
|
|
|
|
if req.URL.Scheme != "https" {
|
|
|
|
return false
|
|
|
|
}
|
|
|
|
|
|
|
|
for _, trusted := range trusteds {
|
2014-06-07 17:17:56 -04:00
|
|
|
if hostname == trusted || strings.HasSuffix(hostname, "."+trusted) {
|
2014-06-05 14:37:37 -04:00
|
|
|
return true
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return false
|
|
|
|
}
|
|
|
|
|
2015-07-21 15:40:36 -04:00
|
|
|
// addRequiredHeadersToRedirectedRequests adds the necessary redirection headers
|
|
|
|
// for redirected requests
|
|
|
|
func addRequiredHeadersToRedirectedRequests(req *http.Request, via []*http.Request) error {
|
2018-12-11 08:33:23 -05:00
|
|
|
if len(via) != 0 && via[0] != nil {
|
2014-06-05 14:37:37 -04:00
|
|
|
if trustedLocation(req) && trustedLocation(via[0]) {
|
|
|
|
req.Header = via[0].Header
|
2014-08-25 12:50:18 -04:00
|
|
|
return nil
|
|
|
|
}
|
|
|
|
for k, v := range via[0].Header {
|
|
|
|
if k != "Authorization" {
|
|
|
|
for _, vv := range v {
|
|
|
|
req.Header.Add(k, vv)
|
2014-06-05 14:37:37 -04:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2014-03-25 20:33:17 -04:00
|
|
|
}
|
|
|
|
return nil
|
|
|
|
}
|
2015-02-12 13:23:22 -05:00
|
|
|
|
2015-07-21 15:40:36 -04:00
|
|
|
// NewTransport returns a new HTTP transport. If tlsConfig is nil, it uses the
|
|
|
|
// default TLS configuration.
|
2015-02-12 13:23:22 -05:00
|
|
|
func NewTransport(tlsConfig *tls.Config) *http.Transport {
|
|
|
|
if tlsConfig == nil {
|
2016-09-02 21:27:20 -04:00
|
|
|
tlsConfig = tlsconfig.ServerDefault()
|
2015-02-12 13:23:22 -05:00
|
|
|
}
|
2016-04-25 07:54:48 -04:00
|
|
|
|
|
|
|
direct := &net.Dialer{
|
|
|
|
Timeout: 30 * time.Second,
|
|
|
|
KeepAlive: 30 * time.Second,
|
|
|
|
DualStack: true,
|
|
|
|
}
|
|
|
|
|
|
|
|
base := &http.Transport{
|
|
|
|
Proxy: http.ProxyFromEnvironment,
|
2019-09-18 07:53:39 -04:00
|
|
|
DialContext: direct.DialContext,
|
2015-02-12 13:23:22 -05:00
|
|
|
TLSHandshakeTimeout: 10 * time.Second,
|
|
|
|
TLSClientConfig: tlsConfig,
|
|
|
|
// TODO(dmcgowan): Call close idle connections when complete and use keep alive
|
|
|
|
DisableKeepAlives: true,
|
|
|
|
}
|
2016-04-25 07:54:48 -04:00
|
|
|
|
|
|
|
return base
|
2015-02-12 13:23:22 -05:00
|
|
|
}
|