github.com/mforkel/docker-ce-i386@v17.12.1-ce-rc2+incompatible/components/engine/registry/session.go (about)

     1  package registry
     2  
     3  import (
     4  	"bytes"
     5  	"crypto/sha256"
     6  	"sync"
     7  	// this is required for some certificates
     8  	_ "crypto/sha512"
     9  	"encoding/hex"
    10  	"encoding/json"
    11  	"fmt"
    12  	"io"
    13  	"io/ioutil"
    14  	"net/http"
    15  	"net/http/cookiejar"
    16  	"net/url"
    17  	"strconv"
    18  	"strings"
    19  
    20  	"github.com/docker/distribution/reference"
    21  	"github.com/docker/distribution/registry/api/errcode"
    22  	"github.com/docker/docker/api/types"
    23  	registrytypes "github.com/docker/docker/api/types/registry"
    24  	"github.com/docker/docker/pkg/ioutils"
    25  	"github.com/docker/docker/pkg/jsonmessage"
    26  	"github.com/docker/docker/pkg/stringid"
    27  	"github.com/docker/docker/pkg/tarsum"
    28  	"github.com/docker/docker/registry/resumable"
    29  	"github.com/pkg/errors"
    30  	"github.com/sirupsen/logrus"
    31  )
    32  
    33  var (
    34  	// ErrRepoNotFound is returned if the repository didn't exist on the
    35  	// remote side
    36  	ErrRepoNotFound notFoundError = "Repository not found"
    37  )
    38  
    39  // A Session is used to communicate with a V1 registry
    40  type Session struct {
    41  	indexEndpoint *V1Endpoint
    42  	client        *http.Client
    43  	// TODO(tiborvass): remove authConfig
    44  	authConfig *types.AuthConfig
    45  	id         string
    46  }
    47  
    48  type authTransport struct {
    49  	http.RoundTripper
    50  	*types.AuthConfig
    51  
    52  	alwaysSetBasicAuth bool
    53  	token              []string
    54  
    55  	mu     sync.Mutex                      // guards modReq
    56  	modReq map[*http.Request]*http.Request // original -> modified
    57  }
    58  
    59  // AuthTransport handles the auth layer when communicating with a v1 registry (private or official)
    60  //
    61  // For private v1 registries, set alwaysSetBasicAuth to true.
    62  //
    63  // For the official v1 registry, if there isn't already an Authorization header in the request,
    64  // but there is an X-Docker-Token header set to true, then Basic Auth will be used to set the Authorization header.
    65  // After sending the request with the provided base http.RoundTripper, if an X-Docker-Token header, representing
    66  // a token, is present in the response, then it gets cached and sent in the Authorization header of all subsequent
    67  // requests.
    68  //
    69  // If the server sends a token without the client having requested it, it is ignored.
    70  //
    71  // This RoundTripper also has a CancelRequest method important for correct timeout handling.
    72  func AuthTransport(base http.RoundTripper, authConfig *types.AuthConfig, alwaysSetBasicAuth bool) http.RoundTripper {
    73  	if base == nil {
    74  		base = http.DefaultTransport
    75  	}
    76  	return &authTransport{
    77  		RoundTripper:       base,
    78  		AuthConfig:         authConfig,
    79  		alwaysSetBasicAuth: alwaysSetBasicAuth,
    80  		modReq:             make(map[*http.Request]*http.Request),
    81  	}
    82  }
    83  
    84  // cloneRequest returns a clone of the provided *http.Request.
    85  // The clone is a shallow copy of the struct and its Header map.
    86  func cloneRequest(r *http.Request) *http.Request {
    87  	// shallow copy of the struct
    88  	r2 := new(http.Request)
    89  	*r2 = *r
    90  	// deep copy of the Header
    91  	r2.Header = make(http.Header, len(r.Header))
    92  	for k, s := range r.Header {
    93  		r2.Header[k] = append([]string(nil), s...)
    94  	}
    95  
    96  	return r2
    97  }
    98  
    99  // RoundTrip changes an HTTP request's headers to add the necessary
   100  // authentication-related headers
   101  func (tr *authTransport) RoundTrip(orig *http.Request) (*http.Response, error) {
   102  	// Authorization should not be set on 302 redirect for untrusted locations.
   103  	// This logic mirrors the behavior in addRequiredHeadersToRedirectedRequests.
   104  	// As the authorization logic is currently implemented in RoundTrip,
   105  	// a 302 redirect is detected by looking at the Referrer header as go http package adds said header.
   106  	// This is safe as Docker doesn't set Referrer in other scenarios.
   107  	if orig.Header.Get("Referer") != "" && !trustedLocation(orig) {
   108  		return tr.RoundTripper.RoundTrip(orig)
   109  	}
   110  
   111  	req := cloneRequest(orig)
   112  	tr.mu.Lock()
   113  	tr.modReq[orig] = req
   114  	tr.mu.Unlock()
   115  
   116  	if tr.alwaysSetBasicAuth {
   117  		if tr.AuthConfig == nil {
   118  			return nil, errors.New("unexpected error: empty auth config")
   119  		}
   120  		req.SetBasicAuth(tr.Username, tr.Password)
   121  		return tr.RoundTripper.RoundTrip(req)
   122  	}
   123  
   124  	// Don't override
   125  	if req.Header.Get("Authorization") == "" {
   126  		if req.Header.Get("X-Docker-Token") == "true" && tr.AuthConfig != nil && len(tr.Username) > 0 {
   127  			req.SetBasicAuth(tr.Username, tr.Password)
   128  		} else if len(tr.token) > 0 {
   129  			req.Header.Set("Authorization", "Token "+strings.Join(tr.token, ","))
   130  		}
   131  	}
   132  	resp, err := tr.RoundTripper.RoundTrip(req)
   133  	if err != nil {
   134  		delete(tr.modReq, orig)
   135  		return nil, err
   136  	}
   137  	if len(resp.Header["X-Docker-Token"]) > 0 {
   138  		tr.token = resp.Header["X-Docker-Token"]
   139  	}
   140  	resp.Body = &ioutils.OnEOFReader{
   141  		Rc: resp.Body,
   142  		Fn: func() {
   143  			tr.mu.Lock()
   144  			delete(tr.modReq, orig)
   145  			tr.mu.Unlock()
   146  		},
   147  	}
   148  	return resp, nil
   149  }
   150  
   151  // CancelRequest cancels an in-flight request by closing its connection.
   152  func (tr *authTransport) CancelRequest(req *http.Request) {
   153  	type canceler interface {
   154  		CancelRequest(*http.Request)
   155  	}
   156  	if cr, ok := tr.RoundTripper.(canceler); ok {
   157  		tr.mu.Lock()
   158  		modReq := tr.modReq[req]
   159  		delete(tr.modReq, req)
   160  		tr.mu.Unlock()
   161  		cr.CancelRequest(modReq)
   162  	}
   163  }
   164  
   165  func authorizeClient(client *http.Client, authConfig *types.AuthConfig, endpoint *V1Endpoint) error {
   166  	var alwaysSetBasicAuth bool
   167  
   168  	// If we're working with a standalone private registry over HTTPS, send Basic Auth headers
   169  	// alongside all our requests.
   170  	if endpoint.String() != IndexServer && endpoint.URL.Scheme == "https" {
   171  		info, err := endpoint.Ping()
   172  		if err != nil {
   173  			return err
   174  		}
   175  		if info.Standalone && authConfig != nil {
   176  			logrus.Debugf("Endpoint %s is eligible for private registry. Enabling decorator.", endpoint.String())
   177  			alwaysSetBasicAuth = true
   178  		}
   179  	}
   180  
   181  	// Annotate the transport unconditionally so that v2 can
   182  	// properly fallback on v1 when an image is not found.
   183  	client.Transport = AuthTransport(client.Transport, authConfig, alwaysSetBasicAuth)
   184  
   185  	jar, err := cookiejar.New(nil)
   186  	if err != nil {
   187  		return errors.New("cookiejar.New is not supposed to return an error")
   188  	}
   189  	client.Jar = jar
   190  
   191  	return nil
   192  }
   193  
   194  func newSession(client *http.Client, authConfig *types.AuthConfig, endpoint *V1Endpoint) *Session {
   195  	return &Session{
   196  		authConfig:    authConfig,
   197  		client:        client,
   198  		indexEndpoint: endpoint,
   199  		id:            stringid.GenerateRandomID(),
   200  	}
   201  }
   202  
   203  // NewSession creates a new session
   204  // TODO(tiborvass): remove authConfig param once registry client v2 is vendored
   205  func NewSession(client *http.Client, authConfig *types.AuthConfig, endpoint *V1Endpoint) (*Session, error) {
   206  	if err := authorizeClient(client, authConfig, endpoint); err != nil {
   207  		return nil, err
   208  	}
   209  
   210  	return newSession(client, authConfig, endpoint), nil
   211  }
   212  
   213  // ID returns this registry session's ID.
   214  func (r *Session) ID() string {
   215  	return r.id
   216  }
   217  
   218  // GetRemoteHistory retrieves the history of a given image from the registry.
   219  // It returns a list of the parent's JSON files (including the requested image).
   220  func (r *Session) GetRemoteHistory(imgID, registry string) ([]string, error) {
   221  	res, err := r.client.Get(registry + "images/" + imgID + "/ancestry")
   222  	if err != nil {
   223  		return nil, err
   224  	}
   225  	defer res.Body.Close()
   226  	if res.StatusCode != 200 {
   227  		if res.StatusCode == 401 {
   228  			return nil, errcode.ErrorCodeUnauthorized.WithArgs()
   229  		}
   230  		return nil, newJSONError(fmt.Sprintf("Server error: %d trying to fetch remote history for %s", res.StatusCode, imgID), res)
   231  	}
   232  
   233  	var history []string
   234  	if err := json.NewDecoder(res.Body).Decode(&history); err != nil {
   235  		return nil, fmt.Errorf("Error while reading the http response: %v", err)
   236  	}
   237  
   238  	logrus.Debugf("Ancestry: %v", history)
   239  	return history, nil
   240  }
   241  
   242  // LookupRemoteImage checks if an image exists in the registry
   243  func (r *Session) LookupRemoteImage(imgID, registry string) error {
   244  	res, err := r.client.Get(registry + "images/" + imgID + "/json")
   245  	if err != nil {
   246  		return err
   247  	}
   248  	res.Body.Close()
   249  	if res.StatusCode != 200 {
   250  		return newJSONError(fmt.Sprintf("HTTP code %d", res.StatusCode), res)
   251  	}
   252  	return nil
   253  }
   254  
   255  // GetRemoteImageJSON retrieves an image's JSON metadata from the registry.
   256  func (r *Session) GetRemoteImageJSON(imgID, registry string) ([]byte, int64, error) {
   257  	res, err := r.client.Get(registry + "images/" + imgID + "/json")
   258  	if err != nil {
   259  		return nil, -1, fmt.Errorf("Failed to download json: %s", err)
   260  	}
   261  	defer res.Body.Close()
   262  	if res.StatusCode != 200 {
   263  		return nil, -1, newJSONError(fmt.Sprintf("HTTP code %d", res.StatusCode), res)
   264  	}
   265  	// if the size header is not present, then set it to '-1'
   266  	imageSize := int64(-1)
   267  	if hdr := res.Header.Get("X-Docker-Size"); hdr != "" {
   268  		imageSize, err = strconv.ParseInt(hdr, 10, 64)
   269  		if err != nil {
   270  			return nil, -1, err
   271  		}
   272  	}
   273  
   274  	jsonString, err := ioutil.ReadAll(res.Body)
   275  	if err != nil {
   276  		return nil, -1, fmt.Errorf("Failed to parse downloaded json: %v (%s)", err, jsonString)
   277  	}
   278  	return jsonString, imageSize, nil
   279  }
   280  
   281  // GetRemoteImageLayer retrieves an image layer from the registry
   282  func (r *Session) GetRemoteImageLayer(imgID, registry string, imgSize int64) (io.ReadCloser, error) {
   283  	var (
   284  		statusCode = 0
   285  		res        *http.Response
   286  		err        error
   287  		imageURL   = fmt.Sprintf("%simages/%s/layer", registry, imgID)
   288  	)
   289  
   290  	req, err := http.NewRequest("GET", imageURL, nil)
   291  	if err != nil {
   292  		return nil, fmt.Errorf("Error while getting from the server: %v", err)
   293  	}
   294  
   295  	res, err = r.client.Do(req)
   296  	if err != nil {
   297  		logrus.Debugf("Error contacting registry %s: %v", registry, err)
   298  		// the only case err != nil && res != nil is https://golang.org/src/net/http/client.go#L515
   299  		if res != nil {
   300  			if res.Body != nil {
   301  				res.Body.Close()
   302  			}
   303  			statusCode = res.StatusCode
   304  		}
   305  		return nil, fmt.Errorf("Server error: Status %d while fetching image layer (%s)",
   306  			statusCode, imgID)
   307  	}
   308  
   309  	if res.StatusCode != 200 {
   310  		res.Body.Close()
   311  		return nil, fmt.Errorf("Server error: Status %d while fetching image layer (%s)",
   312  			res.StatusCode, imgID)
   313  	}
   314  
   315  	if res.Header.Get("Accept-Ranges") == "bytes" && imgSize > 0 {
   316  		logrus.Debug("server supports resume")
   317  		return resumable.NewRequestReaderWithInitialResponse(r.client, req, 5, imgSize, res), nil
   318  	}
   319  	logrus.Debug("server doesn't support resume")
   320  	return res.Body, nil
   321  }
   322  
   323  // GetRemoteTag retrieves the tag named in the askedTag argument from the given
   324  // repository. It queries each of the registries supplied in the registries
   325  // argument, and returns data from the first one that answers the query
   326  // successfully.
   327  func (r *Session) GetRemoteTag(registries []string, repositoryRef reference.Named, askedTag string) (string, error) {
   328  	repository := reference.Path(repositoryRef)
   329  
   330  	if strings.Count(repository, "/") == 0 {
   331  		// This will be removed once the registry supports auto-resolution on
   332  		// the "library" namespace
   333  		repository = "library/" + repository
   334  	}
   335  	for _, host := range registries {
   336  		endpoint := fmt.Sprintf("%srepositories/%s/tags/%s", host, repository, askedTag)
   337  		res, err := r.client.Get(endpoint)
   338  		if err != nil {
   339  			return "", err
   340  		}
   341  
   342  		logrus.Debugf("Got status code %d from %s", res.StatusCode, endpoint)
   343  		defer res.Body.Close()
   344  
   345  		if res.StatusCode == 404 {
   346  			return "", ErrRepoNotFound
   347  		}
   348  		if res.StatusCode != 200 {
   349  			continue
   350  		}
   351  
   352  		var tagID string
   353  		if err := json.NewDecoder(res.Body).Decode(&tagID); err != nil {
   354  			return "", err
   355  		}
   356  		return tagID, nil
   357  	}
   358  	return "", fmt.Errorf("Could not reach any registry endpoint")
   359  }
   360  
   361  // GetRemoteTags retrieves all tags from the given repository. It queries each
   362  // of the registries supplied in the registries argument, and returns data from
   363  // the first one that answers the query successfully. It returns a map with
   364  // tag names as the keys and image IDs as the values.
   365  func (r *Session) GetRemoteTags(registries []string, repositoryRef reference.Named) (map[string]string, error) {
   366  	repository := reference.Path(repositoryRef)
   367  
   368  	if strings.Count(repository, "/") == 0 {
   369  		// This will be removed once the registry supports auto-resolution on
   370  		// the "library" namespace
   371  		repository = "library/" + repository
   372  	}
   373  	for _, host := range registries {
   374  		endpoint := fmt.Sprintf("%srepositories/%s/tags", host, repository)
   375  		res, err := r.client.Get(endpoint)
   376  		if err != nil {
   377  			return nil, err
   378  		}
   379  
   380  		logrus.Debugf("Got status code %d from %s", res.StatusCode, endpoint)
   381  		defer res.Body.Close()
   382  
   383  		if res.StatusCode == 404 {
   384  			return nil, ErrRepoNotFound
   385  		}
   386  		if res.StatusCode != 200 {
   387  			continue
   388  		}
   389  
   390  		result := make(map[string]string)
   391  		if err := json.NewDecoder(res.Body).Decode(&result); err != nil {
   392  			return nil, err
   393  		}
   394  		return result, nil
   395  	}
   396  	return nil, fmt.Errorf("Could not reach any registry endpoint")
   397  }
   398  
   399  func buildEndpointsList(headers []string, indexEp string) ([]string, error) {
   400  	var endpoints []string
   401  	parsedURL, err := url.Parse(indexEp)
   402  	if err != nil {
   403  		return nil, err
   404  	}
   405  	var urlScheme = parsedURL.Scheme
   406  	// The registry's URL scheme has to match the Index'
   407  	for _, ep := range headers {
   408  		epList := strings.Split(ep, ",")
   409  		for _, epListElement := range epList {
   410  			endpoints = append(
   411  				endpoints,
   412  				fmt.Sprintf("%s://%s/v1/", urlScheme, strings.TrimSpace(epListElement)))
   413  		}
   414  	}
   415  	return endpoints, nil
   416  }
   417  
   418  // GetRepositoryData returns lists of images and endpoints for the repository
   419  func (r *Session) GetRepositoryData(name reference.Named) (*RepositoryData, error) {
   420  	repositoryTarget := fmt.Sprintf("%srepositories/%s/images", r.indexEndpoint.String(), reference.Path(name))
   421  
   422  	logrus.Debugf("[registry] Calling GET %s", repositoryTarget)
   423  
   424  	req, err := http.NewRequest("GET", repositoryTarget, nil)
   425  	if err != nil {
   426  		return nil, err
   427  	}
   428  	// this will set basic auth in r.client.Transport and send cached X-Docker-Token headers for all subsequent requests
   429  	req.Header.Set("X-Docker-Token", "true")
   430  	res, err := r.client.Do(req)
   431  	if err != nil {
   432  		// check if the error is because of i/o timeout
   433  		// and return a non-obtuse error message for users
   434  		// "Get https://index.docker.io/v1/repositories/library/busybox/images: i/o timeout"
   435  		// was a top search on the docker user forum
   436  		if isTimeout(err) {
   437  			return nil, fmt.Errorf("network timed out while trying to connect to %s. You may want to check your internet connection or if you are behind a proxy", repositoryTarget)
   438  		}
   439  		return nil, fmt.Errorf("Error while pulling image: %v", err)
   440  	}
   441  	defer res.Body.Close()
   442  	if res.StatusCode == 401 {
   443  		return nil, errcode.ErrorCodeUnauthorized.WithArgs()
   444  	}
   445  	// TODO: Right now we're ignoring checksums in the response body.
   446  	// In the future, we need to use them to check image validity.
   447  	if res.StatusCode == 404 {
   448  		return nil, newJSONError(fmt.Sprintf("HTTP code: %d", res.StatusCode), res)
   449  	} else if res.StatusCode != 200 {
   450  		errBody, err := ioutil.ReadAll(res.Body)
   451  		if err != nil {
   452  			logrus.Debugf("Error reading response body: %s", err)
   453  		}
   454  		return nil, newJSONError(fmt.Sprintf("Error: Status %d trying to pull repository %s: %q", res.StatusCode, reference.Path(name), errBody), res)
   455  	}
   456  
   457  	var endpoints []string
   458  	if res.Header.Get("X-Docker-Endpoints") != "" {
   459  		endpoints, err = buildEndpointsList(res.Header["X-Docker-Endpoints"], r.indexEndpoint.String())
   460  		if err != nil {
   461  			return nil, err
   462  		}
   463  	} else {
   464  		// Assume the endpoint is on the same host
   465  		endpoints = append(endpoints, fmt.Sprintf("%s://%s/v1/", r.indexEndpoint.URL.Scheme, req.URL.Host))
   466  	}
   467  
   468  	remoteChecksums := []*ImgData{}
   469  	if err := json.NewDecoder(res.Body).Decode(&remoteChecksums); err != nil {
   470  		return nil, err
   471  	}
   472  
   473  	// Forge a better object from the retrieved data
   474  	imgsData := make(map[string]*ImgData, len(remoteChecksums))
   475  	for _, elem := range remoteChecksums {
   476  		imgsData[elem.ID] = elem
   477  	}
   478  
   479  	return &RepositoryData{
   480  		ImgList:   imgsData,
   481  		Endpoints: endpoints,
   482  	}, nil
   483  }
   484  
   485  // PushImageChecksumRegistry uploads checksums for an image
   486  func (r *Session) PushImageChecksumRegistry(imgData *ImgData, registry string) error {
   487  	u := registry + "images/" + imgData.ID + "/checksum"
   488  
   489  	logrus.Debugf("[registry] Calling PUT %s", u)
   490  
   491  	req, err := http.NewRequest("PUT", u, nil)
   492  	if err != nil {
   493  		return err
   494  	}
   495  	req.Header.Set("X-Docker-Checksum", imgData.Checksum)
   496  	req.Header.Set("X-Docker-Checksum-Payload", imgData.ChecksumPayload)
   497  
   498  	res, err := r.client.Do(req)
   499  	if err != nil {
   500  		return fmt.Errorf("Failed to upload metadata: %v", err)
   501  	}
   502  	defer res.Body.Close()
   503  	if len(res.Cookies()) > 0 {
   504  		r.client.Jar.SetCookies(req.URL, res.Cookies())
   505  	}
   506  	if res.StatusCode != 200 {
   507  		errBody, err := ioutil.ReadAll(res.Body)
   508  		if err != nil {
   509  			return fmt.Errorf("HTTP code %d while uploading metadata and error when trying to parse response body: %s", res.StatusCode, err)
   510  		}
   511  		var jsonBody map[string]string
   512  		if err := json.Unmarshal(errBody, &jsonBody); err != nil {
   513  			errBody = []byte(err.Error())
   514  		} else if jsonBody["error"] == "Image already exists" {
   515  			return ErrAlreadyExists
   516  		}
   517  		return fmt.Errorf("HTTP code %d while uploading metadata: %q", res.StatusCode, errBody)
   518  	}
   519  	return nil
   520  }
   521  
   522  // PushImageJSONRegistry pushes JSON metadata for a local image to the registry
   523  func (r *Session) PushImageJSONRegistry(imgData *ImgData, jsonRaw []byte, registry string) error {
   524  
   525  	u := registry + "images/" + imgData.ID + "/json"
   526  
   527  	logrus.Debugf("[registry] Calling PUT %s", u)
   528  
   529  	req, err := http.NewRequest("PUT", u, bytes.NewReader(jsonRaw))
   530  	if err != nil {
   531  		return err
   532  	}
   533  	req.Header.Add("Content-type", "application/json")
   534  
   535  	res, err := r.client.Do(req)
   536  	if err != nil {
   537  		return fmt.Errorf("Failed to upload metadata: %s", err)
   538  	}
   539  	defer res.Body.Close()
   540  	if res.StatusCode == 401 && strings.HasPrefix(registry, "http://") {
   541  		return newJSONError("HTTP code 401, Docker will not send auth headers over HTTP.", res)
   542  	}
   543  	if res.StatusCode != 200 {
   544  		errBody, err := ioutil.ReadAll(res.Body)
   545  		if err != nil {
   546  			return newJSONError(fmt.Sprintf("HTTP code %d while uploading metadata and error when trying to parse response body: %s", res.StatusCode, err), res)
   547  		}
   548  		var jsonBody map[string]string
   549  		if err := json.Unmarshal(errBody, &jsonBody); err != nil {
   550  			errBody = []byte(err.Error())
   551  		} else if jsonBody["error"] == "Image already exists" {
   552  			return ErrAlreadyExists
   553  		}
   554  		return newJSONError(fmt.Sprintf("HTTP code %d while uploading metadata: %q", res.StatusCode, errBody), res)
   555  	}
   556  	return nil
   557  }
   558  
   559  // PushImageLayerRegistry sends the checksum of an image layer to the registry
   560  func (r *Session) PushImageLayerRegistry(imgID string, layer io.Reader, registry string, jsonRaw []byte) (checksum string, checksumPayload string, err error) {
   561  	u := registry + "images/" + imgID + "/layer"
   562  
   563  	logrus.Debugf("[registry] Calling PUT %s", u)
   564  
   565  	tarsumLayer, err := tarsum.NewTarSum(layer, false, tarsum.Version0)
   566  	if err != nil {
   567  		return "", "", err
   568  	}
   569  	h := sha256.New()
   570  	h.Write(jsonRaw)
   571  	h.Write([]byte{'\n'})
   572  	checksumLayer := io.TeeReader(tarsumLayer, h)
   573  
   574  	req, err := http.NewRequest("PUT", u, checksumLayer)
   575  	if err != nil {
   576  		return "", "", err
   577  	}
   578  	req.Header.Add("Content-Type", "application/octet-stream")
   579  	req.ContentLength = -1
   580  	req.TransferEncoding = []string{"chunked"}
   581  	res, err := r.client.Do(req)
   582  	if err != nil {
   583  		return "", "", fmt.Errorf("Failed to upload layer: %v", err)
   584  	}
   585  	if rc, ok := layer.(io.Closer); ok {
   586  		if err := rc.Close(); err != nil {
   587  			return "", "", err
   588  		}
   589  	}
   590  	defer res.Body.Close()
   591  
   592  	if res.StatusCode != 200 {
   593  		errBody, err := ioutil.ReadAll(res.Body)
   594  		if err != nil {
   595  			return "", "", newJSONError(fmt.Sprintf("HTTP code %d while uploading metadata and error when trying to parse response body: %s", res.StatusCode, err), res)
   596  		}
   597  		return "", "", newJSONError(fmt.Sprintf("Received HTTP code %d while uploading layer: %q", res.StatusCode, errBody), res)
   598  	}
   599  
   600  	checksumPayload = "sha256:" + hex.EncodeToString(h.Sum(nil))
   601  	return tarsumLayer.Sum(jsonRaw), checksumPayload, nil
   602  }
   603  
   604  // PushRegistryTag pushes a tag on the registry.
   605  // Remote has the format '<user>/<repo>
   606  func (r *Session) PushRegistryTag(remote reference.Named, revision, tag, registry string) error {
   607  	// "jsonify" the string
   608  	revision = "\"" + revision + "\""
   609  	path := fmt.Sprintf("repositories/%s/tags/%s", reference.Path(remote), tag)
   610  
   611  	req, err := http.NewRequest("PUT", registry+path, strings.NewReader(revision))
   612  	if err != nil {
   613  		return err
   614  	}
   615  	req.Header.Add("Content-type", "application/json")
   616  	req.ContentLength = int64(len(revision))
   617  	res, err := r.client.Do(req)
   618  	if err != nil {
   619  		return err
   620  	}
   621  	res.Body.Close()
   622  	if res.StatusCode != 200 && res.StatusCode != 201 {
   623  		return newJSONError(fmt.Sprintf("Internal server error: %d trying to push tag %s on %s", res.StatusCode, tag, reference.Path(remote)), res)
   624  	}
   625  	return nil
   626  }
   627  
   628  // PushImageJSONIndex uploads an image list to the repository
   629  func (r *Session) PushImageJSONIndex(remote reference.Named, imgList []*ImgData, validate bool, regs []string) (*RepositoryData, error) {
   630  	cleanImgList := []*ImgData{}
   631  	if validate {
   632  		for _, elem := range imgList {
   633  			if elem.Checksum != "" {
   634  				cleanImgList = append(cleanImgList, elem)
   635  			}
   636  		}
   637  	} else {
   638  		cleanImgList = imgList
   639  	}
   640  
   641  	imgListJSON, err := json.Marshal(cleanImgList)
   642  	if err != nil {
   643  		return nil, err
   644  	}
   645  	var suffix string
   646  	if validate {
   647  		suffix = "images"
   648  	}
   649  	u := fmt.Sprintf("%srepositories/%s/%s", r.indexEndpoint.String(), reference.Path(remote), suffix)
   650  	logrus.Debugf("[registry] PUT %s", u)
   651  	logrus.Debugf("Image list pushed to index:\n%s", imgListJSON)
   652  	headers := map[string][]string{
   653  		"Content-type": {"application/json"},
   654  		// this will set basic auth in r.client.Transport and send cached X-Docker-Token headers for all subsequent requests
   655  		"X-Docker-Token": {"true"},
   656  	}
   657  	if validate {
   658  		headers["X-Docker-Endpoints"] = regs
   659  	}
   660  
   661  	// Redirect if necessary
   662  	var res *http.Response
   663  	for {
   664  		if res, err = r.putImageRequest(u, headers, imgListJSON); err != nil {
   665  			return nil, err
   666  		}
   667  		if !shouldRedirect(res) {
   668  			break
   669  		}
   670  		res.Body.Close()
   671  		u = res.Header.Get("Location")
   672  		logrus.Debugf("Redirected to %s", u)
   673  	}
   674  	defer res.Body.Close()
   675  
   676  	if res.StatusCode == 401 {
   677  		return nil, errcode.ErrorCodeUnauthorized.WithArgs()
   678  	}
   679  
   680  	var tokens, endpoints []string
   681  	if !validate {
   682  		if res.StatusCode != 200 && res.StatusCode != 201 {
   683  			errBody, err := ioutil.ReadAll(res.Body)
   684  			if err != nil {
   685  				logrus.Debugf("Error reading response body: %s", err)
   686  			}
   687  			return nil, newJSONError(fmt.Sprintf("Error: Status %d trying to push repository %s: %q", res.StatusCode, reference.Path(remote), errBody), res)
   688  		}
   689  		tokens = res.Header["X-Docker-Token"]
   690  		logrus.Debugf("Auth token: %v", tokens)
   691  
   692  		if res.Header.Get("X-Docker-Endpoints") == "" {
   693  			return nil, fmt.Errorf("Index response didn't contain any endpoints")
   694  		}
   695  		endpoints, err = buildEndpointsList(res.Header["X-Docker-Endpoints"], r.indexEndpoint.String())
   696  		if err != nil {
   697  			return nil, err
   698  		}
   699  	} else {
   700  		if res.StatusCode != 204 {
   701  			errBody, err := ioutil.ReadAll(res.Body)
   702  			if err != nil {
   703  				logrus.Debugf("Error reading response body: %s", err)
   704  			}
   705  			return nil, newJSONError(fmt.Sprintf("Error: Status %d trying to push checksums %s: %q", res.StatusCode, reference.Path(remote), errBody), res)
   706  		}
   707  	}
   708  
   709  	return &RepositoryData{
   710  		Endpoints: endpoints,
   711  	}, nil
   712  }
   713  
   714  func (r *Session) putImageRequest(u string, headers map[string][]string, body []byte) (*http.Response, error) {
   715  	req, err := http.NewRequest("PUT", u, bytes.NewReader(body))
   716  	if err != nil {
   717  		return nil, err
   718  	}
   719  	req.ContentLength = int64(len(body))
   720  	for k, v := range headers {
   721  		req.Header[k] = v
   722  	}
   723  	response, err := r.client.Do(req)
   724  	if err != nil {
   725  		return nil, err
   726  	}
   727  	return response, nil
   728  }
   729  
   730  func shouldRedirect(response *http.Response) bool {
   731  	return response.StatusCode >= 300 && response.StatusCode < 400
   732  }
   733  
   734  // SearchRepositories performs a search against the remote repository
   735  func (r *Session) SearchRepositories(term string, limit int) (*registrytypes.SearchResults, error) {
   736  	if limit < 1 || limit > 100 {
   737  		return nil, validationError{errors.Errorf("Limit %d is outside the range of [1, 100]", limit)}
   738  	}
   739  	logrus.Debugf("Index server: %s", r.indexEndpoint)
   740  	u := r.indexEndpoint.String() + "search?q=" + url.QueryEscape(term) + "&n=" + url.QueryEscape(fmt.Sprintf("%d", limit))
   741  
   742  	req, err := http.NewRequest("GET", u, nil)
   743  	if err != nil {
   744  		return nil, errors.Wrap(validationError{err}, "Error building request")
   745  	}
   746  	// Have the AuthTransport send authentication, when logged in.
   747  	req.Header.Set("X-Docker-Token", "true")
   748  	res, err := r.client.Do(req)
   749  	if err != nil {
   750  		return nil, systemError{err}
   751  	}
   752  	defer res.Body.Close()
   753  	if res.StatusCode != 200 {
   754  		return nil, newJSONError(fmt.Sprintf("Unexpected status code %d", res.StatusCode), res)
   755  	}
   756  	result := new(registrytypes.SearchResults)
   757  	return result, errors.Wrap(json.NewDecoder(res.Body).Decode(result), "error decoding registry search results")
   758  }
   759  
   760  func isTimeout(err error) bool {
   761  	type timeout interface {
   762  		Timeout() bool
   763  	}
   764  	e := err
   765  	switch urlErr := err.(type) {
   766  	case *url.Error:
   767  		e = urlErr.Err
   768  	}
   769  	t, ok := e.(timeout)
   770  	return ok && t.Timeout()
   771  }
   772  
   773  func newJSONError(msg string, res *http.Response) error {
   774  	return &jsonmessage.JSONError{
   775  		Message: msg,
   776  		Code:    res.StatusCode,
   777  	}
   778  }