# Excluir imagem Docker: Instruções passo a passo Imagens Docker podem consumir quantidades consideráveis de **espaço em disco no sistema *host* e no registro de contêineres**. Ao excluir uma imagem Docker que não mais será utilizada ou que está desatualizada, você libera valioso espaço de armazenamento, possibilitando a criação de novas imagens. Cultive o hábito de excluir imagens Docker periodicamente, principalmente se você trabalha em um ambiente cujo espaço é limitado. ## Quando excluir uma imagem Docker? [Imagens Docker](https://www.ionos.com/digitalguide/server/know-how/docker-images/ "Imagens Docker") são construídas a partir de arquivos de texto simples, chamados **Dockerfiles**. São eles que descrevem os passos que configuram uma infraestrutura de contêineres. Imagens, por sua vez, são usadas para iniciar [contêineres Docker](https://www.ionos.com/digitalguide/server/know-how/docker-container/ "Container Docker"), responsáveis por rodar aplicações e serviços em um ambiente isolado e consistente. Quando um ambiente contém um grande número de imagens, essas podem afetar o desempenho de toda a infraestrutura de contêineres, por ocupar demasiado espaço em disco. É que sempre que o Docker procura por uma imagem, ele percorre todas elas até encontrar a que está buscando. Assim, quando você decide por remover imagens Docker desnecessárias, acaba por contribuir para o aumento da eficiência e para a **redução do tempo de busca**. Ainda, a prática protege o sistema contra riscos de segurança. Não menos importante, assim que **ciclos de desenvolvimento e de testes forem concluídos**, considere excluir as respectivas imagens, de uso temporário. Da mesma forma, elas liberarão espaço em disco. ## Como excluir uma ou mais imagens Docker? Se você deseja remover uma ou mais imagens do seu ambiente Docker de uma única vez, deverá encaminhar a lista de IDs ou de nomes das imagens ao comando `docker rmi`. ### Passo 1: Listar IDs e tags de imagens Use o comando a seguir para solicitar a elaboração de uma lista contendo todas as imagens Docker do seu sistema: ```bash docker images -a ``` O resultado gerado conterá informações como nome, ID, data de criação, tamanho e autoria da imagem. ### Passo 2: Excluir imagens Docker Se você deseja remover várias imagens ao mesmo tempo, insira os respectivos IDs ou nomes, **um após o outro e separados por espaços**, como orienta o exemplo abaixo: ```bash docker rmi Image Image ``` Importante destacar que você só conseguirá excluir uma imagem Docker se **ela não estiver sendo usada por nenhum contêiner ativo**. Do contrário, você terá de parar o contêiner ativo e depois excluí-lo para, somente aí, solicitar a remoção da imagem a ele associada. ## Como excluir imagens Docker não utilizadas? Imagens não utilizadas nada mais são que **imagens que não estão mais sendo usadas por contêineres ativos ou por outras imagens**. Esquecidas pelo tempo e desprovidas da importância que tiveram, elas continuarão a ocupar espaço em disco no Docker host, se não forem removidas. Recomendamos, então, que você exclua esse tipo de imagem com certa regularidade, para que o seu ambiente de desenvolvimento se mantenha sempre eficiente. ### Passo 1: Listar imagens não utilizadas Para começar, solicite a exibição da lista de imagens não utilizadas, para que elas possam ser posteriormente excluídas. Este é o comando relativo à solicitação: ```bash docker images -f dangling=true ``` ### Passo 2: Excluir imagens não utilizadas Já o próximo comando deve ser usado para remover todas as imagens não utilizadas e liberar o espaço de armazenamento até então ocupado: ```bash docker images purge ``` ## Como excluir imagens Docker que seguem um padrão? Opte por excluir imagens Docker **com um mesmo padrão ou prefixo** para livrar-se de todas elas de uma só vez. O recurso é especialmente útil àqueles que administram um grande número de imagens e que desejam excluir apenas aquelas que se encaixam em uma categoria específica. ### Passo 1: Listar imagens por *grep* Você pode combinar o comando `docker images` com o comando `grep` para solicitar a exibição de todas as imagens Docker que seguem um mesmo padrão. Observe: ```bash docker images -a | grep "pattern" ``` ### Passo 2: Excluir imagens Docker Depois de definir o padrão, faça uso do comando `awk` para configurar um filtro de resultados que extrairá somente os IDs das imagens exibidas. Feito isso, siga para o processo de exclusão, utilizando o comando `xargs docker rmi`. O exemplo de código ilustra o processo: ```bash docker images -a | grep "pattern" | awk '{print $3}' | xargs docker rmi ``` ## Como excluir todas as imagens Docker? Pense bem antes de optar por excluir todas as imagens Docker do seu sistema, pois **a ação é irreversível**. Na pior das hipóteses, todos os seus contêineres deixarão de funcionar, o que poderá lhe causar enorme prejuízo. ### Passo 1: Listar todas as imagens Para excluir todas as imagens Docker do seu sistema, comece por solicitar a exibição de uma lista contendo **todas as imagens, ativas e inativas**. Acompanhe, abaixo, o comando que executa essa ação: ```bash docker images -a ``` ### Passo 2: Excluir todas as imagens Docker Encaminhe o resultado gerado ao comando `docker rmi`. Ele fará com que todas as imagens sejam excluídas, como no exemplo: ```bash docker rmi $(Docker-Images -a -q) ``` Se você também busca por instruções para excluir um volume Docker ou para [remover um contêiner Docker](https://www.ionos.com/pt-br/digitalguide/servidor/configuracao/excluir-container-docker/), poderá encontrá-las nesses artigos do nosso Digital Guide. Aprofunde-se no tema consultado o texto [o que é Docker](https://www.ionos.com/digitalguide/server/know-how/what-is-docker/ "O que é Docker") e entenda os aspectos que diferenciam contêineres Docker de [volumes de contêineres Docker](https://www.ionos.com/digitalguide/server/know-how/docker-container-volumes/ "Volumes de contêineres Docker"). This is a markdown version of: [https://www.ionos.com/pt-br/digitalguide/servidor/configuracao/excluir-imagem-docker/](https://www.ionos.com/pt-br/digitalguide/servidor/configuracao/excluir-imagem-docker/) for AI/LLM consumption.