docker ps
100%

Docker · Lição 4

docker ps

Aprenda a listar contêineres do Docker e saber quais estão em execução ou já terminaram.

O servidor web que você iniciou no Docker ainda está em execução? Use docker ps para verificar. Uma imagem reúne o programa e os arquivos de que ele precisa. Um contêiner é uma instância criada a partir dessa imagem. O comando mostra a lista de contêineres no momento da consulta.

Listando os contêineres em execução

Por padrão, docker ps lista os contêineres em execução. Os exemplos mostram algumas colunas de um ambiente Docker já preparado, então você pode ler a saída sem configurar o Docker. No terminal, digite o comando que vem depois do prompt $.

$ docker ps
IMAGE         STATUS         NAMES
nginx:alpine  Up 4 minutes   web
nginx:alpine  Up 30 seconds  demo

Se o Docker exibir apenas os cabeçalhos das colunas, a lista de contêineres em execução está vazia. O ambiente ainda pode ter contêineres parados.

Ao executar docker ps, o Docker mostra só os cabeçalhos. O que você pode concluir?

Lendo nomes e estados

Comece pela coluna NAMES para localizar o contêiner desejado. As duas linhas mostram a mesma imagem, nginx:alpine, em IMAGE. Encontre web na última coluna e leia STATUS na mesma linha. Up 4 minutes significa que o contêiner está em execução há cerca de quatro minutos.

Qual linha corresponde a um contêiner que está em execução há cerca de 30 segundos?

Incluindo contêineres que já terminaram

Se um contêiner que você esperava não aparecer, tente docker ps -a. A opção -a é a abreviação de --all. Ela inclui os contêineres parados que ainda existem. O exemplo também inclui uma tarefa de demonstração chamada preview.

$ docker ps -a
IMAGE         STATUS                         NAMES
nginx:alpine  Up 4 minutes                   web
nginx:alpine  Up 30 seconds                  demo
busybox:1.36  Exited (0) 2 minutes ago       report
busybox:1.36  Exited (1) About a minute ago  preview

Um contêiner executa um programa principal, como um servidor web ou um script. Exited indica que esse programa parou. O número entre parênteses é o código de saída, o resultado que o programa informou ao terminar. Zero geralmente indica sucesso. Um código diferente de zero costuma indicar erro. A tarefa report mostra Exited (0), o resultado esperado para uma tarefa concluída com sucesso.

Terminal da LabEx com contêineres em execução e terminados, report com código 0 e preview com código 1

A captura da LabEx mostra só os nomes e estados dos quatro contêineres de exemplo. Os tempos variam de acordo com o momento em que você executa o comando.

Pelo código de saída, em qual linha você investigaria um possível erro?

Escolhendo a próxima verificação

O código de saída ajuda a decidir o que investigar. Para ver se preview exibiu um erro, use docker logs seguido do nome. O comando mostra a saída que o Docker coletou desse contêiner.

$ docker logs preview

Se o servidor web estiver em execução, você também pode verificar se um visitante consegue abrir a página. Abra-a no computador que precisa acessá-la. Up descreve o programa dentro do contêiner. Uma solicitação bem-sucedida confirma que a página está acessível do computador usado no teste.

A página abre no computador que executa o Docker. Outra pessoa precisa abri-la de um computador diferente. Qual teste confirma se ela consegue acessar?

Lição concluída

Você concluiu docker ps

Agora você pode usar a lista para localizar um contêiner, ler seu estado e escolher o que verificar depois.

  • Usar docker ps para listar contêineres em execução.

  • Localizar um contêiner pelo nome e ler seu estado.

  • Usar docker ps -a para incluir contêineres que já terminaram.

  • Consultar os logs ou fazer uma solicitação no navegador quando o estado não bastar.

Salve seu progresso

Crie uma conta gratuita para salvar esta lição e continuar em qualquer dispositivo.

Criar uma conta gratuita
Próxima Lição
Voltar para Docker