docker compose rm

O comando docker compose rm é utilizado para remover contêineres que foram criados por um arquivo docker-compose.yml. Ele é útil para limpar o ambiente, removendo contêineres que não estão mais em uso ou que foram parados, liberando recursos e prevenindo conflitos futuros.

Sintaxe

docker compose rm [OPÇÕES] [SERVIÇOS...]

Parâmetros

• SERVIÇOS: (Opcional) Lista de serviços cujos contêineres você deseja remover. Se não especificado, o comando irá remover os contêineres de todos os serviços definidos no arquivo docker-compose.yml que estão parados.

Opções

• -f, --force: Força a remoção dos contêineres sem pedir confirmação do usuário. Útil para automação ou quando você tem certeza de que deseja remover os contêineres.

• -s, --stop: Para os contêineres em execução antes de removê-los. Isso garante que os contêineres não estejam em execução ao serem removidos.

• -v, --volumes: Remove os volumes associados aos contêineres além dos próprios contêineres. Use com cautela, pois isso também irá remover dados persistidos nos volumes.

Exemplo de Uso

1. Remover Todos os Contêineres Parados: Para remover todos os contêineres parados definidos no arquivo docker-compose.yml:

   docker compose rm

2. Remover um Serviço Específico: Para remover apenas o contêiner do serviço web:

   docker compose rm web

3. Forçar a Remoção Sem Confirmação: Para forçar a remoção dos contêineres sem solicitar confirmação:

   docker compose rm -f

4. Parar e Remover Contêineres: Para parar e remover o contêiner do serviço web:

   docker compose rm -s web

5. Remover Contêineres e Seus Volumes Associados: Para remover os contêineres e também seus volumes associados:

   docker compose rm -v

6. Combinação de Opções: Para parar, remover um contêiner específico (web), e seus volumes, sem pedir confirmação:

   docker compose rm -fsv web

Considerações

• Impacto na Persistência de Dados: Ao utilizar a opção -v, os volumes que armazenam dados persistentes dos contêineres serão removidos. Isso significa que todos os dados armazenados nesses volumes serão perdidos. Use essa opção com cautela, especialmente em ambientes de produção.

• Confirmação: Por padrão, o comando docker compose rm solicita uma confirmação antes de remover contêineres. Isso é uma medida de segurança para prevenir a remoção acidental de contêineres importantes.

• Recursos Liberados: Remover contêineres que não estão mais em uso ajuda a liberar recursos do sistema, como espaço em disco e memória. Isso pode ser especialmente importante em servidores com recursos limitados.

• Uso em Scripts e CI/CD: A opção -f (force) é especialmente útil em scripts de automação e pipelines CI/CD, onde não há interação humana e é necessário garantir que os contêineres sejam removidos sem solicitar confirmações.

O comando docker compose rm é uma ferramenta essencial para gerenciar e limpar ambientes de desenvolvimento e produção, garantindo que somente os contêineres necessários estejam em execução e que recursos sejam eficientemente utilizados.