Como usar o comando docker container rename para renomear um contêiner

DockerBeginner
Pratique Agora

Introdução

Neste laboratório, você aprenderá como gerenciar contêineres Docker renomeando-os. Você começará criando um contêiner Docker e atribuindo-lhe um nome específico para fácil identificação.

Após a criação, você verificará o nome do contêiner usando comandos Docker. O cerne deste laboratório envolve o uso do comando docker container rename para alterar o nome do contêiner e, finalmente, você verificará se a renomeação foi bem-sucedida, verificando o novo nome do contêiner.

Criar um contêiner com um nome específico

Nesta etapa, você aprenderá como criar um contêiner Docker e atribuir um nome específico a ele. Nomear contêineres facilita a identificação e o gerenciamento.

Primeiro, vamos baixar a imagem hello-world do Docker Hub. Esta é uma imagem muito pequena que é útil para testes.

docker pull hello-world

Você deve ver uma saída indicando que a imagem está sendo baixada.

Agora, executaremos um contêiner a partir da imagem hello-world e daremos a ele o nome my-hello-container. Usamos o comando docker run com a flag --name para especificar o nome do contêiner.

docker run --name my-hello-container hello-world

Quando você executar este comando, o Docker criará e iniciará um novo contêiner chamado my-hello-container com base na imagem hello-world. O contêiner hello-world simplesmente imprime uma mensagem e depois sai.

Após a execução do contêiner, você pode verificar se ele foi criado listando todos os contêineres (incluindo os que foram finalizados) usando o comando docker ps -a.

docker ps -a

Na saída, você deve ver um contêiner com o nome my-hello-container.

Verificar o nome do contêiner

Na etapa anterior, você criou um contêiner Docker e o nomeou my-hello-container. Nesta etapa, você verificará explicitamente se o contêiner existe e possui o nome correto usando comandos Docker.

O comando docker ps é usado para listar contêineres. Por padrão, ele mostra apenas os contêineres em execução. Como o contêiner hello-world sai após a execução, precisamos usar a flag -a para mostrar todos os contêineres, incluindo aqueles que foram finalizados.

Execute o seguinte comando para listar todos os contêineres:

docker ps -a

Observe a saída do comando. Você deve ver uma tabela com informações sobre seus contêineres. Encontre a linha correspondente ao contêiner que você acabou de criar. A coluna NAMES nesta tabela mostra o nome do contêiner. Verifique se o nome é realmente my-hello-container.

Para verificar especificamente a existência de um contêiner com um nome específico, você pode combinar docker ps -a com grep.

docker ps -a | grep my-hello-container

Se o contêiner chamado my-hello-container existir, este comando exibirá a linha de docker ps -a que contém as informações do contêiner. Se ele não existir, grep não encontrará uma correspondência e não haverá saída. Esta é uma maneira comum de verificar programaticamente a existência de um contêiner por nome.

Renomear o contêiner

Nas etapas anteriores, você criou e verificou o nome de um contêiner Docker. Às vezes, pode ser necessário alterar o nome de um contêiner existente. O Docker fornece o comando docker rename para essa finalidade.

O comando docker rename recebe dois argumentos: o nome atual do contêiner e o novo nome que você deseja atribuir.

Agora, renomearemos o contêiner atualmente chamado my-hello-container para renamed-hello-container.

docker rename my-hello-container renamed-hello-container

Se o comando for bem-sucedido, ele será concluído sem imprimir nenhuma saída. Isso indica que o contêiner foi renomeado com sucesso.

Para confirmar a renomeação, você pode novamente listar todos os contêineres usando docker ps -a e verificar a coluna NAMES.

docker ps -a

Você deve agora ver renamed-hello-container na coluna NAMES para o contêiner que você acabou de renomear, e my-hello-container não deve mais aparecer.

Verificar o novo nome do contêiner

Na etapa anterior, você renomeou o contêiner Docker de my-hello-container para renamed-hello-container. Nesta etapa final, você realizará uma verificação definitiva para garantir que o contêiner agora possui o novo nome e que o nome antigo não está mais associado a ele.

Usaremos o comando docker ps -a novamente para listar todos os contêineres e seus detalhes.

docker ps -a

Examine a saída cuidadosamente. Você deve ver o contêiner listado com o nome renamed-hello-container. É também importante confirmar que não há nenhum contêiner listado com o nome antigo, my-hello-container.

Para verificar especificamente a presença do novo nome e a ausência do nome antigo usando ferramentas de linha de comando, você pode usar grep.

Primeiro, verifique o novo nome:

docker ps -a | grep renamed-hello-container

Este comando deve retornar uma saída se o contêiner foi renomeado com sucesso.

Em seguida, verifique o nome antigo. Este comando não deve retornar nenhuma saída se a renomeação foi bem-sucedida.

docker ps -a | grep my-hello-container

Ao realizar ambas as verificações, você pode ter certeza de que o contêiner foi renomeado corretamente.

Resumo

Neste laboratório, você aprendeu como criar um contêiner Docker e atribuir a ele um nome específico usando o comando docker run --name. Em seguida, você verificou a existência e o nome do contêiner usando o comando docker ps -a, que lista todos os contêineres, incluindo aqueles que foram finalizados.

Após a criação e verificação, você praticou a renomeação do contêiner usando o comando docker container rename, alterando seu nome de my-hello-container para um novo nome. Finalmente, você confirmou a renomeação bem-sucedida usando novamente docker ps -a para verificar o nome atualizado do contêiner na saída.