The docker tag
command is used to create a new tag for an existing Docker image. It allows you to assign additional names or tags to an image, making it easier to reference and share.
Here’s the basic syntax of the docker tag
command:
docker tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG]
SOURCE_IMAGE
: The name or ID of the source image you want to tag.TAG
(optional): The tag of the source image. If not specified, it defaults to latest
.TARGET_IMAGE
: The name or ID of the target image with the new tag.TAG
(optional): The new tag to assign to the target image. If not specified, it defaults to latest
.Here’s an example of using the docker tag
command:
docker tag my-image:tag my-image:new-tag
This command will create a new tag new-tag
for the my-image:tag
Docker image. The resulting image will have both my-image:tag
and my-image:new-tag
as valid tags.
You can use the docker tag
command to assign multiple tags to the same image, making it easier to reference the image using different names or versions. This can be useful when sharing images with others or when deploying different versions of an application.
Note that the docker tag
command does not create a new image or modify the existing image. It simply creates a new reference to the same image with a different name or tag.
You can verify the new tag by running the docker images
command, which will display both the original and tagged images.
docker images
You can refer to the Docker documentation for more details on using the docker tag
command and its available options.