2014-08-08 06:58:58 +00:00
|
|
|
package graph
|
|
|
|
|
|
|
|
import (
|
|
|
|
"fmt"
|
|
|
|
"io"
|
|
|
|
|
2015-03-26 22:22:04 +00:00
|
|
|
"github.com/Sirupsen/logrus"
|
2015-04-22 12:06:58 +00:00
|
|
|
"github.com/docker/docker/cliconfig"
|
2015-09-10 22:01:18 +00:00
|
|
|
"github.com/docker/docker/context"
|
2015-03-18 02:18:41 +00:00
|
|
|
"github.com/docker/docker/pkg/streamformatter"
|
2014-08-08 06:58:58 +00:00
|
|
|
"github.com/docker/docker/registry"
|
|
|
|
"github.com/docker/docker/utils"
|
|
|
|
)
|
|
|
|
|
2015-07-21 16:21:45 +00:00
|
|
|
// ImagePullConfig stores pull configuration.
|
2015-04-15 11:43:15 +00:00
|
|
|
type ImagePullConfig struct {
|
2015-07-29 23:45:47 +00:00
|
|
|
// MetaHeaders stores HTTP headers with metadata about the image
|
|
|
|
// (DockerHeaders with prefix X-Meta- in the request).
|
2015-04-15 11:43:15 +00:00
|
|
|
MetaHeaders map[string][]string
|
2015-07-29 23:45:47 +00:00
|
|
|
// AuthConfig holds authentication credentials for authenticating with
|
|
|
|
// the registry.
|
2015-07-21 16:21:45 +00:00
|
|
|
AuthConfig *cliconfig.AuthConfig
|
2015-07-29 23:45:47 +00:00
|
|
|
// OutStream is the output writer for showing the status of the pull
|
|
|
|
// operation.
|
2015-07-21 16:21:45 +00:00
|
|
|
OutStream io.Writer
|
2015-04-15 11:43:15 +00:00
|
|
|
}
|
|
|
|
|
2015-07-29 23:45:47 +00:00
|
|
|
// Puller is an interface that abstracts pulling for different API versions.
|
2015-02-12 18:23:22 +00:00
|
|
|
type Puller interface {
|
|
|
|
// Pull tries to pull the image referenced by `tag`
|
|
|
|
// Pull returns an error if any, as well as a boolean that determines whether to retry Pull on the next configured endpoint.
|
|
|
|
//
|
|
|
|
// TODO(tiborvass): have Pull() take a reference to repository + tag, so that the puller itself is repository-agnostic.
|
|
|
|
Pull(tag string) (fallback bool, err error)
|
|
|
|
}
|
|
|
|
|
2015-07-29 23:45:47 +00:00
|
|
|
// NewPuller returns a Puller interface that will pull from either a v1 or v2
|
|
|
|
// registry. The endpoint argument contains a Version field that determines
|
|
|
|
// whether a v1 or v2 puller will be created. The other parameters are passed
|
|
|
|
// through to the underlying puller implementation for use during the actual
|
|
|
|
// pull operation.
|
2015-02-12 18:23:22 +00:00
|
|
|
func NewPuller(s *TagStore, endpoint registry.APIEndpoint, repoInfo *registry.RepositoryInfo, imagePullConfig *ImagePullConfig, sf *streamformatter.StreamFormatter) (Puller, error) {
|
|
|
|
switch endpoint.Version {
|
|
|
|
case registry.APIVersion2:
|
|
|
|
return &v2Puller{
|
|
|
|
TagStore: s,
|
|
|
|
endpoint: endpoint,
|
|
|
|
config: imagePullConfig,
|
|
|
|
sf: sf,
|
|
|
|
repoInfo: repoInfo,
|
|
|
|
}, nil
|
|
|
|
case registry.APIVersion1:
|
|
|
|
return &v1Puller{
|
|
|
|
TagStore: s,
|
|
|
|
endpoint: endpoint,
|
|
|
|
config: imagePullConfig,
|
|
|
|
sf: sf,
|
|
|
|
repoInfo: repoInfo,
|
|
|
|
}, nil
|
|
|
|
}
|
|
|
|
return nil, fmt.Errorf("unknown version %d for registry %s", endpoint.Version, endpoint.URL)
|
|
|
|
}
|
|
|
|
|
2015-07-29 23:45:47 +00:00
|
|
|
// Pull initiates a pull operation. image is the repository name to pull, and
|
|
|
|
// tag may be either empty, or indicate a specific tag to pull.
|
2015-09-10 22:01:18 +00:00
|
|
|
func (s *TagStore) Pull(ctx context.Context, image string, tag string, imagePullConfig *ImagePullConfig) error {
|
2015-02-12 18:23:22 +00:00
|
|
|
var sf = streamformatter.NewJSONStreamFormatter()
|
2014-10-03 22:24:14 +00:00
|
|
|
|
2014-10-07 01:54:52 +00:00
|
|
|
// Resolve the Repository name from fqn to RepositoryInfo
|
2015-04-15 11:43:15 +00:00
|
|
|
repoInfo, err := s.registryService.ResolveRepository(image)
|
2014-10-07 01:54:52 +00:00
|
|
|
if err != nil {
|
2015-03-25 07:44:12 +00:00
|
|
|
return err
|
2014-10-07 01:54:52 +00:00
|
|
|
}
|
|
|
|
|
2015-02-12 18:23:22 +00:00
|
|
|
// makes sure name is not empty or `scratch`
|
2015-04-22 21:41:24 +00:00
|
|
|
if err := validateRepoName(repoInfo.LocalName); err != nil {
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
|
2015-08-06 21:41:59 +00:00
|
|
|
endpoints, err := s.registryService.LookupPullEndpoints(repoInfo.CanonicalName)
|
2014-08-08 06:58:58 +00:00
|
|
|
if err != nil {
|
2015-03-25 07:44:12 +00:00
|
|
|
return err
|
2014-08-08 06:58:58 +00:00
|
|
|
}
|
|
|
|
|
2015-05-16 00:48:20 +00:00
|
|
|
logName := repoInfo.LocalName
|
|
|
|
if tag != "" {
|
|
|
|
logName = utils.ImageReference(logName, tag)
|
|
|
|
}
|
|
|
|
|
2015-02-12 18:23:22 +00:00
|
|
|
var (
|
|
|
|
lastErr error
|
|
|
|
|
|
|
|
// discardNoSupportErrors is used to track whether an endpoint encountered an error of type registry.ErrNoSupport
|
|
|
|
// By default it is false, which means that if a ErrNoSupport error is encountered, it will be saved in lastErr.
|
|
|
|
// As soon as another kind of error is encountered, discardNoSupportErrors is set to true, avoiding the saving of
|
|
|
|
// any subsequent ErrNoSupport errors in lastErr.
|
|
|
|
// It's needed for pull-by-digest on v1 endpoints: if there are only v1 endpoints configured, the error should be
|
|
|
|
// returned and displayed, but if there was a v2 endpoint which supports pull-by-digest, then the last relevant
|
|
|
|
// error is the ones from v2 endpoints not v1.
|
|
|
|
discardNoSupportErrors bool
|
2015-05-16 01:35:04 +00:00
|
|
|
)
|
2015-02-12 18:23:22 +00:00
|
|
|
for _, endpoint := range endpoints {
|
|
|
|
logrus.Debugf("Trying to pull %s from %s %s", repoInfo.LocalName, endpoint.URL, endpoint.Version)
|
2014-10-07 18:00:17 +00:00
|
|
|
|
2015-02-12 18:23:22 +00:00
|
|
|
if !endpoint.Mirror && (endpoint.Official || endpoint.Version == registry.APIVersion2) {
|
|
|
|
if repoInfo.Official {
|
|
|
|
s.trustService.UpdateBase()
|
|
|
|
}
|
2014-10-07 18:00:17 +00:00
|
|
|
}
|
2014-12-23 21:40:06 +00:00
|
|
|
|
2015-02-12 18:23:22 +00:00
|
|
|
puller, err := NewPuller(s, endpoint, repoInfo, imagePullConfig, sf)
|
2015-05-16 00:48:20 +00:00
|
|
|
if err != nil {
|
2015-02-12 18:23:22 +00:00
|
|
|
lastErr = err
|
2015-05-16 00:48:20 +00:00
|
|
|
continue
|
|
|
|
}
|
2015-02-12 18:23:22 +00:00
|
|
|
if fallback, err := puller.Pull(tag); err != nil {
|
|
|
|
if fallback {
|
|
|
|
if _, ok := err.(registry.ErrNoSupport); !ok {
|
|
|
|
// Because we found an error that's not ErrNoSupport, discard all subsequent ErrNoSupport errors.
|
|
|
|
discardNoSupportErrors = true
|
|
|
|
// save the current error
|
|
|
|
lastErr = err
|
|
|
|
} else if !discardNoSupportErrors {
|
|
|
|
// Save the ErrNoSupport error, because it's either the first error or all encountered errors
|
|
|
|
// were also ErrNoSupport errors.
|
|
|
|
lastErr = err
|
|
|
|
}
|
|
|
|
continue
|
2014-08-08 06:58:58 +00:00
|
|
|
}
|
2015-02-12 18:23:22 +00:00
|
|
|
logrus.Debugf("Not continuing with error: %v", err)
|
2014-08-08 06:58:58 +00:00
|
|
|
return err
|
|
|
|
|
|
|
|
}
|
|
|
|
|
2015-09-10 22:01:18 +00:00
|
|
|
s.eventsService.Log(ctx, "pull", logName, "")
|
2015-02-12 18:23:22 +00:00
|
|
|
return nil
|
|
|
|
}
|
2014-08-08 06:58:58 +00:00
|
|
|
|
2015-02-12 18:23:22 +00:00
|
|
|
if lastErr == nil {
|
|
|
|
lastErr = fmt.Errorf("no endpoints found for %s", image)
|
2014-09-23 22:53:43 +00:00
|
|
|
}
|
2015-02-12 18:23:22 +00:00
|
|
|
return lastErr
|
2014-09-23 22:53:43 +00:00
|
|
|
}
|
2014-08-08 06:58:58 +00:00
|
|
|
|
2015-07-29 23:45:47 +00:00
|
|
|
// writeStatus writes a status message to out. If layersDownloaded is true, the
|
|
|
|
// status message indicates that a newer image was downloaded. Otherwise, it
|
|
|
|
// indicates that the image is up to date. requestedTag is the tag the message
|
|
|
|
// will refer to.
|
2015-07-21 16:21:45 +00:00
|
|
|
func writeStatus(requestedTag string, out io.Writer, sf *streamformatter.StreamFormatter, layersDownloaded bool) {
|
2015-03-26 01:40:23 +00:00
|
|
|
if layersDownloaded {
|
2014-09-23 22:53:43 +00:00
|
|
|
out.Write(sf.FormatStatus("", "Status: Downloaded newer image for %s", requestedTag))
|
|
|
|
} else {
|
|
|
|
out.Write(sf.FormatStatus("", "Status: Image is up to date for %s", requestedTag))
|
2014-08-08 06:58:58 +00:00
|
|
|
}
|
|
|
|
}
|