github.com/docker/docker@v299999999.0.0-20200612211812-aaf470eca7b5+incompatible/daemon/images/image_tag.go (about)

     1  package images // import "github.com/docker/docker/daemon/images"
     2  
     3  import (
     4  	"github.com/docker/distribution/reference"
     5  	"github.com/docker/docker/image"
     6  )
     7  
     8  // TagImage creates the tag specified by newTag, pointing to the image named
     9  // imageName (alternatively, imageName can also be an image ID).
    10  func (i *ImageService) TagImage(imageName, repository, tag string) (string, error) {
    11  	img, err := i.GetImage(imageName, nil)
    12  	if err != nil {
    13  		return "", err
    14  	}
    15  
    16  	newTag, err := reference.ParseNormalizedNamed(repository)
    17  	if err != nil {
    18  		return "", err
    19  	}
    20  	if tag != "" {
    21  		if newTag, err = reference.WithTag(reference.TrimNamed(newTag), tag); err != nil {
    22  			return "", err
    23  		}
    24  	}
    25  
    26  	err = i.TagImageWithReference(img.ID(), newTag)
    27  	return reference.FamiliarString(newTag), err
    28  }
    29  
    30  // TagImageWithReference adds the given reference to the image ID provided.
    31  func (i *ImageService) TagImageWithReference(imageID image.ID, newTag reference.Named) error {
    32  	if err := i.referenceStore.AddTag(newTag, imageID.Digest(), true); err != nil {
    33  		return err
    34  	}
    35  
    36  	if err := i.imageStore.SetLastUpdated(imageID); err != nil {
    37  		return err
    38  	}
    39  	i.LogImageEvent(imageID.String(), reference.FamiliarString(newTag), "tag")
    40  	return nil
    41  }