Renomear imagens com Docker Tag

O comando docker tag é utilizado para criar uma nova tag para uma imagem Docker existente. Isso é útil para renomear ou reclassificar uma imagem sem duplicar seu conteúdo. Aqui estão os passos para renomear uma imagem com docker tag:

Sintaxe do Comando

docker tag <imagem_existente>:<tag_existente> <novo_repositório>:<nova_tag>

• <imagem_existente>: Nome ou ID da imagem que você deseja renomear.

• <tag_existente>: Tag atual da imagem. (Se não especificado, assume-se latest).

• <novo_repositório>: Nome do novo repositório ou nome que você deseja dar à imagem.

• <nova_tag>: Nova tag que você deseja atribuir à imagem.

docker image tag

Exemplo Prático

Vamos supor que você tenha uma imagem com o nome conversao-temperatura-dockerfile e a tag latest, e queira renomeá-la para meu_usuario/conversao-temperatura com a tag v1.0.

1. Verificar a Imagem Atual:

   docker image ls

   Saída:

   REPOSITORY                         TAG       IMAGE ID       CREATED             SIZE
   conversao-temperatura-dockerfile   latest    4c32eaa602c1   8 hours ago         381MB

2. Criar a Nova Tag (Renomear):

   docker tag conversao-temperatura-dockerfile:latest meu_usuario/conversao-temperatura:v1.0

3. Verificar as Imagens Após o Tagging:

   docker image ls

   Saída Esperada:

   REPOSITORY                         TAG       IMAGE ID       CREATED             SIZE
   conversao-temperatura-dockerfile   latest    4c32eaa602c1   8 hours ago         381MB
   meu_usuario/conversao-temperatura  v1.0      4c32eaa602c1   8 hours ago         381MB

   Agora você tem a mesma imagem com um novo nome e tag.

4. (Opcional) Remover a Tag Antiga: Se não precisar mais da tag antiga, você pode removê-la:

   docker rmi conversao-temperatura-dockerfile:latest

   Nota: Isso não removerá a imagem, apenas a tag.

5. Fazer o Push para o Docker Hub: Caso deseje enviar a imagem com a nova tag para o Docker Hub:

   docker push meu_usuario/conversao-temperatura:v1.0

Essa sequência permite que você renomeie e reclassifique imagens de forma simples e eficiente.

Laboratório

$ docker image ls
REPOSITORY                         TAG       IMAGE ID       CREATED             SIZE
conversao-temperatura-dockerfile   latest    4c32eaa602c1   8 hours ago         381MB

$ docker tag conversao-temperatura-dockerfile:latest marcelodpbarbieri/conversao-temperatura:v1
$ docker image ls
REPOSITORY                                TAG       IMAGE ID       CREATED             SIZE
conversao-temperatura-dockerfile          latest    4c32eaa602c1   8 hours ago         381MB
marcelodpbarbieri/conversao-temperatura   v1        4c32eaa602c1   8 hours ago         381MB
$ docker image inspect 4c32eaa602c1
[
    {
        "Id": "sha256:4c32eaa602c1a3fb555018df5910f819d7061b0c708e11979798cb978fa8028d",
        "RepoTags": [
            "conversao-temperatura-dockerfile:latest",
            "marcelodpbarbieri/conversao-temperatura:v1"
        ],
        ...

docker tag adiciona um nome à imagem

Nome a imagem com a tag latest, para que sempre que seja possível recuperar uma imagem sem que a versão seja informada:

$ docker tag conversao-temperatura-dockerfile:latest marcelodpbarbieri/conversao-temperatura:latest
$ docker image ls
REPOSITORY                                TAG       IMAGE ID       CREATED        SIZE
conversao-temperatura-dockerfile          latest    4c32eaa602c1   8 hours ago    381MB
marcelodpbarbieri/conversao-temperatura   latest    4c32eaa602c1   8 hours ago    381MB
marcelodpbarbieri/conversao-temperatura   v1        4c32eaa602c1   8 hours ago    381MB
$ docker image inspect 4c32eaa602c1
[
    {
        "Id": "sha256:4c32eaa602c1a3fb555018df5910f819d7061b0c708e11979798cb978fa8028d",
        "RepoTags": [
            "conversao-temperatura-dockerfile:latest",
            "marcelodpbarbieri/conversao-temperatura:latest",
            "marcelodpbarbieri/conversao-temperatura:v1"
            ...