Container Lifecycle Management

Visualizando o Ciclo de Vida do Contêiner

Antes de mergulharmos nos comandos, é útil ter um modelo mental dos diferentes estados pelos quais um contêiner pode passar. Dado seu interesse em entender os fundamentos, pensar nisso como uma máquina de estados pode ser muito esclarecedor.

Os estados mais importantes para nossa lição de hoje são:

• Running: O contêiner está ativo e seu processo principal está em execução. Você chega aqui com docker run ou docker start.
• Exited (Stopped): O processo principal do contêiner foi finalizado. O contêiner ainda existe no sistema (seu sistema de arquivos e configuração são preservados), mas não está consumindo CPU. Você chega aqui com docker stop ou quando o processo principal termina por conta própria.
• (Removed): O estado final, onde o contêiner é permanentemente excluído do sistema usando docker rm.

Parando e Iniciando Contêineres

Na lição anterior, você iniciou contêineres com docker run. Agora, vamos aprender a gerenciá-los sem precisar recriá-los toda vez.

Vamos começar um contêiner Nginx em modo detached e dar a ele um nome para facilitar a referência:

docker run -d --name webserver nginx

Você pode verificar que ele está rodando com docker ps.

docker stop: A Parada Controlada

Para parar um contêiner em execução, usamos o comando docker stop.

docker stop webserver

Como funciona?
Isso é mais sofisticado do que simplesmente "matar" o processo. Por padrão, docker stop faz o seguinte:

1. Envia um sinal SIGTERM ao processo principal dentro do contêiner. Este é um sinal de término "gentil", que permite que a aplicação realize um desligamento controlado (por exemplo, finalizar requisições em andamento, salvar dados em disco, fechar conexões de banco de dados).
2. Aguarda um período de carência (o padrão é 10 segundos).
3. Se o processo não terminar nesse tempo, o Docker envia um sinal SIGKILL, que força o encerramento imediato do processo pelo sistema operacional.

Essa abordagem de desligamento controlado é crucial em ambientes de produção para evitar corrupção de dados e garantir a integridade do sistema, um conceito com o qual você, como desenvolvedor de back-end, já está familiarizado.

Após executar docker stop, se você rodar docker ps, o contêiner webserver não aparecerá mais. No entanto, ele não foi excluído. Para vê-lo, use a flag -a (all):

docker ps -a

Você verá o contêiner webserver com o status Exited.

docker start: Trazendo de Volta à Vida

Um contêiner parado pode ser reiniciado a qualquer momento com docker start.

docker start webserver

Este comando pega o contêiner existente, com seu ID, nome e sistema de arquivos (incluindo quaisquer alterações que tenham sido feitas) e inicia seu processo principal novamente. Se você executar docker ps agora, verá o webserver rodando novamente.

O vídeo a seguir demonstra rapidamente esses comandos em ação.

Reiniciando e Removendo Contêineres

docker restart: Uma Conveniência Útil

Se você precisa simplesmente reiniciar um contêiner que já está rodando (por exemplo, para que ele releia um arquivo de configuração que foi alterado), você pode usar o comando docker restart.

docker restart webserver

Internamente, docker restart executa um docker stop seguido por um docker start. Ele respeita o mesmo tempo de espera para o desligamento controlado antes de forçar a parada e reiniciar o contêiner.

docker rm: A Limpeza Final

Contêineres parados ainda ocupam espaço em disco, pois seus sistemas de arquivos são mantidos. Quando você tem certeza de que não precisa mais de um contêiner, pode removê-lo permanentemente com docker rm.

Primeiro, pare o contêiner:

docker stop webserver

Agora, remova-o:

docker rm webserver

Se você tentar remover um contêiner que ainda está em execução, o Docker retornará um erro. Isso é uma medida de segurança para evitar a remoção acidental de serviços ativos. Para contornar isso, você pode usar a flag -f (--force), que primeiro envia um sinal SIGKILL e depois remove o contêiner.

# Crie um novo contêiner para testar
docker run -d --name temp_web nginx

# Tente remover sem parar (vai falhar)
docker rm temp_web

# Force a remoção
docker rm -f temp_web

Para aprofundar seu conhecimento sobre o que acontece internamente durante cada um desses estágios, o recurso a seguir é uma excelente leitura.

Conclusão

Nesta lição, você aprendeu a gerenciar o ciclo de vida básico de um contêiner. Agora você está equipado para ir além de apenas criar contêineres e pode controlá-los de forma eficaz.

Principais pontos a reter:

• Ciclo de Vida: Contêineres transitam entre estados como running, exited, e são eventualmente removed.
• docker stop <nome>: Para um contêiner de forma controlada, enviando SIGTERM e depois SIGKILL.
• docker start <nome>: Inicia um contêiner que foi previamente parado, reutilizando seu estado.
• docker restart <nome>: Um atalho conveniente para stop seguido de start.
• docker rm <nome>: Remove permanentemente um contêiner parado. Use rm -f para forçar a remoção de um contêiner em execução.
• docker ps -a: Seu comando essencial para ver todos os contêineres, incluindo os que estão parados.

Agora que você pode criar e gerenciar o ciclo de vida básico de um contêiner, o próximo passo natural é aprender a configurar seu comportamento. Na próxima lição, focaremos em como passar informações para dentro de um contêiner no momento da execução, começando com o método fundamental de usar variáveis de ambiente (--env), algo que você usará constantemente para configurar suas aplicações .NET.