Introdução
Neste laboratório, você aprenderá como usar efetivamente o comando docker buildx du para inspecionar e entender o uso de disco do seu cache de construção do Docker. Você começará verificando o uso básico de disco para o seu construtor atual e compreendendo o significado das colunas de saída, incluindo CACHE ID, SIZE e LAST ACCESSED.
Além disso, você explorará como usar a saída verbose para obter informações mais detalhadas sobre registros de cache individuais e aprenderá como verificar o uso de disco para uma instância específica do construtor, permitindo que você gerencie e otimize seu cache de construção de forma mais eficaz.
Mostrar o uso de disco para o construtor atual
Nesta etapa, você aprenderá como verificar o uso de disco do seu construtor Docker atual. O comando docker buildx du é usado para exibir o uso de disco do cache de construção. Isso é útil para entender quanto espaço seu cache de construção está consumindo e para identificar áreas potenciais para limpeza.
Primeiro, vamos executar o comando docker buildx du sem nenhuma opção para ver as informações básicas de uso de disco para o construtor atual.
docker buildx du
Você deve ver uma saída semelhante a esta, mostrando o tamanho total do cache de construção. O tamanho exato variará dependendo das suas atividades de construção anteriores.
CACHE ID SIZE LAST ACCESSED
... (a saída irá variar)
TOTAL: 123.4MB
A saída mostra uma lista de entradas de cache com seu ID, tamanho e hora do último acesso. A linha TOTAL no final indica o espaço total em disco usado pelo cache de construção para o construtor atual.
Entender a saída do docker buildx du
Na etapa anterior, você executou o comando docker buildx du e viu a saída mostrando as entradas de cache e um tamanho total. Nesta etapa, vamos nos aprofundar na compreensão das diferentes colunas na saída.
Vamos olhar a saída novamente:
CACHE ID SIZE LAST ACCESSED
... (a saída irá variar)
TOTAL: 123.4MB
- CACHE ID: Este é um identificador único para cada entrada de cache. Esses IDs são gerados pelo BuildKit e representam diferentes camadas ou estágios no seu processo de construção que foram armazenados em cache.
- SIZE: Esta coluna mostra o tamanho da entrada de cache específica. Esta é a quantidade de espaço em disco que esta camada ou estágio em cache em particular está consumindo.
- LAST ACCESSED: Isso indica a última vez que esta entrada de cache foi usada durante uma construção. Essa informação é útil para identificar entradas de cache que não estão mais sendo usadas ativamente e que poderiam ser removidas para liberar espaço.
A linha TOTAL na parte inferior fornece a soma dos tamanhos de todas as entradas de cache listadas, dando a você o uso geral de disco do cache de construção para o construtor atual. Entender essas colunas ajuda você a analisar seu cache de construção e gerenciar seu tamanho de forma eficaz.
Usar a saída verbose para inspecionar os registros de uso de disco
Nesta etapa, você aprenderá como obter informações mais detalhadas sobre as entradas de cache de construção usando a opção de saída verbose com o comando docker buildx du. A saída verbose fornece detalhes adicionais que podem ser úteis para depurar e entender a origem das camadas em cache.
Para obter a saída verbose, use a flag -v ou --verbose com o comando docker buildx du:
docker buildx du -v
A saída agora incluirá mais colunas, como USAGE, DESCRIPTION e, possivelmente, outras, dependendo do tipo de entrada de cache.
CACHE ID SIZE LAST ACCESSED USAGE DESCRIPTION
... (a saída irá variar)
TOTAL: 123.4MB
- USAGE: Esta coluna pode fornecer informações sobre como a entrada de cache está sendo usada ou referenciada.
- DESCRIPTION: Esta coluna geralmente contém uma descrição da etapa de construção ou instrução que gerou esta entrada de cache. Isso é muito útil para identificar quais partes do seu Dockerfile ou processo de construção estão contribuindo para o tamanho do cache.
Ao examinar a coluna DESCRIPTION na saída verbose, você pode ver quais instruções de construção específicas (como RUN, COPY, etc.) correspondem a cada entrada de cache. Isso ajuda você a entender a estrutura do seu cache de construção e identificar áreas onde você pode otimizar seu Dockerfile para reduzir o tamanho do cache.
Verificar o uso de disco para uma instância específica do builder
Nesta etapa, você aprenderá como verificar o uso de disco para uma instância de construtor (builder) Docker específica. Por padrão, docker buildx du mostra o uso de disco para o construtor atualmente ativo. No entanto, você pode ter várias instâncias de construtor configuradas e pode querer inspecionar o uso do cache para uma diferente.
Primeiro, vamos listar as instâncias de construtor disponíveis para identificar aquela que você deseja inspecionar. Você pode fazer isso usando o comando docker buildx ls:
docker buildx ls
A saída mostrará uma lista de suas instâncias de construtor. Procure a coluna NAME para identificar o nome do construtor que lhe interessa. O construtor atualmente ativo será marcado com um asterisco (*).
NAME/NODE DRIVER/ENDPOINT STATUS BUILDKIT PLATFORMS
default * docker running v0.10.5+a34f333b1f linux/amd64, linux/arm64, linux/riscv64, linux/ppc64le, linux/s390x, linux/386, linux/arm/v7, linux/arm/v6
mybuilder docker-container running v0.10.5+a34f333b1f linux/amd64, linux/arm64, linux/riscv64, linux/ppc64le, linux/s390x, linux/386, linux/arm/v7, linux/arm/v6
Agora, para verificar o uso de disco para uma instância de construtor específica, você pode usar a flag --builder seguida pelo nome do construtor. Por exemplo, se você tiver um construtor chamado mybuilder, você executaria:
docker buildx du --builder mybuilder
Substitua mybuilder pelo nome real da instância de construtor que você deseja inspecionar. Este comando exibirá o uso de disco especificamente para o cache associado a essa instância de construtor. Isso é útil se você estiver trabalhando com diferentes configurações de construtor ou se quiser isolar o uso do cache de um ambiente de construção específico.
Resumo
Neste laboratório, você aprendeu como usar o comando docker buildx du para verificar o uso de disco do seu cache de construção Docker. Você começou executando o comando básico para ver o tamanho total e uma lista das entradas de cache.
Em seguida, você obteve uma compreensão mais profunda das colunas de saída, incluindo CACHE ID, SIZE e LAST ACCESSED, que fornecem detalhes sobre as entradas de cache individuais. Você também explorou como usar a saída verbose (-v) para ver registros mais detalhados para cada entrada de cache e aprendeu como verificar o uso de disco para uma instância de construtor específica, especificando seu nome.
