docker image tag

A documentação oficial do comando docker tag fornece detalhes sobre como o comando é usado para criar tags adicionais para imagens Docker existentes. Aqui está um resumo dos principais pontos:

Finalidade do docker tag

O comando docker tag é usado para aplicar uma nova tag a uma imagem existente. Tags são usadas para identificar versões específicas de uma imagem, permitindo que você gerencie e publique imagens Docker de forma mais eficiente.

Sintaxe

docker tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG]

• SOURCE_IMAGE[:TAG]: Especifica a imagem de origem e, opcionalmente, a tag que deseja renomear. Se a tag não for especificada, a tag padrão latest será usada.

• TARGET_IMAGE[:TAG]: Especifica o nome e a tag da nova imagem. Se a tag não for especificada, latest será usada.

Exemplos

1. Criando uma nova tag para uma imagem:

   docker tag myapp:1.0 myrepo/myapp:stable

   Isso cria uma nova tag chamada stable para a imagem myapp:1.0 e a coloca no repositório myrepo.

2. Renomeando uma imagem:

   docker tag oldrepo/oldname:oldtag newrepo/newname:newtag

   Isso renomeia a imagem de oldrepo/oldname:oldtag para newrepo/newname:newtag.

3. Preparando uma imagem para push: Antes de fazer o push de uma imagem para o Docker Hub, você pode renomeá-la para coincidir com o nome do seu repositório:

   docker tag local-image:latest meu_usuario/minha-imagem:1.0
   docker push meu_usuario/minha-imagem:1.0

Como Funciona

• O comando docker tag não copia a imagem ou cria um novo objeto de imagem. Ele apenas cria uma nova referência (ou alias) para a imagem existente.

• Uma imagem pode ter múltiplas tags, e todas elas referenciam o mesmo ID de imagem.

Usos Comuns

• Gerenciamento de Versões: Criar tags para diferentes versões da sua aplicação, como v1.0, v2.0, etc.

• Organização de Repositórios: Mover imagens entre repositórios diferentes ou renomear imagens para atender a padrões específicos.

• Preparação para Deploy: Atribuir tags específicas para ambientes de produção, teste, ou desenvolvimento.

Referência Oficial

Você pode consultar a documentação completa do Docker para o comando docker tag diretamente no site oficial do Docker. Lá, você encontrará exemplos adicionais, detalhes sobre o comportamento do comando, e informações sobre como utilizá-lo em diferentes cenários.