Introdução
Neste laboratório, você aprenderá como usar o comando docker buildx history ls para gerenciar e visualizar seus registros de construção do Docker. Começaremos construindo uma imagem Docker simples usando docker buildx build, que cria automaticamente um registro de construção.
Após a construção da imagem, você explorará como listar todos os registros de construção usando docker buildx history ls. Em seguida, aprenderá como filtrar esses registros com base em seu status usando a opção --filter e como personalizar o formato de saída usando a opção --format. Finalmente, você descobrirá como listar apenas os registros de construção locais usando a opção --local. Este laboratório fornecerá habilidades práticas para rastrear e analisar seu histórico de construção do Docker.
Construir uma imagem simples para criar um registro de construção
Nesta etapa, construiremos uma imagem Docker simples. A construção de uma imagem com Docker Buildx cria automaticamente um registro de construção. Um registro de construção contém informações sobre a construção, como os argumentos de construção, o contexto de construção e a imagem resultante.
Primeiro, vamos criar um Dockerfile simples no diretório ~/project. Este Dockerfile criará uma imagem baseada na imagem ubuntu e instalará o curl.
cd ~/project
nano Dockerfile
Adicione o seguinte conteúdo ao Dockerfile:
FROM ubuntu:latest
RUN apt-get update && apt-get install -y curl
Salve e feche o arquivo.
Agora, vamos construir a imagem usando docker buildx build. Vamos marcar a imagem como my-ubuntu-curl.
docker buildx build -t my-ubuntu-curl .
Este comando construirá a imagem com base no Dockerfile no diretório atual (.) e a marcará como my-ubuntu-curl. Docker Buildx criará automaticamente um registro de construção para esta construção.
Após a conclusão da construção, você deverá ver a saída indicando o processo de construção e a criação bem-sucedida da imagem.
Listar todos os registros de construção usando docker buildx history ls
Nesta etapa, aprenderemos como listar todos os registros de construção usando o comando docker buildx history ls. Como vimos na etapa anterior, a construção de uma imagem com docker buildx build cria automaticamente um registro de construção. Esses registros são armazenados e podem ser visualizados para rastrear seu histórico de construção.
Para listar todos os registros de construção, basta executar o seguinte comando:
docker buildx history ls
Este comando exibirá uma tabela com informações sobre cada registro de construção. A saída normalmente inclui o ID da construção, o construtor usado, o status da construção, a duração da construção e o horário em que a construção foi criada.
Você deve ver pelo menos uma entrada na saída, correspondente à imagem que construímos na etapa anterior (my-ubuntu-curl).
O comando docker buildx history ls é útil para obter uma visão geral da sua atividade de construção e identificar construções específicas.
Filtrar registros de construção por status usando a opção --filter
Nesta etapa, aprenderemos como filtrar registros de construção com base em seu status usando a opção --filter com o comando docker buildx history ls. Isso é útil quando você deseja ver apenas as construções que possuem um status específico, como construções concluídas ou com falha.
A opção --filter recebe um par chave-valor no formato chave=valor. Para filtrar por status, usamos a chave status. Os valores possíveis para status incluem complete (concluído), running (em execução), failed (com falha), etc.
Como a construção que realizamos na primeira etapa foi bem-sucedida, seu status deve ser complete. Vamos filtrar o histórico de construção para mostrar apenas as construções concluídas:
docker buildx history ls --filter status=complete
Este comando exibirá apenas os registros de construção onde o status é complete. Você deve ver o registro de construção para my-ubuntu-curl na saída.
Se você tivesse alguma construção com falha, poderia filtrá-las usando --filter status=failed.
Formatar a saída dos registros de construção usando a opção --format
Nesta etapa, aprenderemos como formatar a saída do comando docker buildx history ls usando a opção --format. Isso permite que você personalize as informações exibidas e o formato em que elas são apresentadas.
A opção --format aceita uma string de template Go. Você pode usar espaços reservados (placeholders) como .ID, .Builder, .Status, .Duration e .CreatedAt para incluir informações específicas do registro de construção.
Vamos tentar formatar a saída para mostrar apenas o ID da construção e o status, separados por dois pontos:
docker buildx history ls --format "{{.ID}}: {{.Status}}"
Este comando exibirá cada registro de construção em uma nova linha, mostrando o ID da construção seguido por dois pontos e seu status.
Você pode criar formatos mais complexos combinando diferentes espaços reservados e texto. Por exemplo, para mostrar o construtor e a duração:
docker buildx history ls --format "Builder: {{.Builder}}, Duration: {{.Duration}}"
Experimente com diferentes strings de formato para ver como você pode personalizar a saída de acordo com suas necessidades.
Listar registros de construção locais usando a opção --local
Nesta etapa, exploraremos a opção --local com docker buildx history ls. Por padrão, docker buildx history ls lista os registros de construção de todos os builders. A opção --local restringe a saída para mostrar apenas os registros de construção da instância do builder atual.
Para listar apenas os registros de construção locais, use o seguinte comando:
docker buildx history ls --local
Neste ambiente de laboratório, como usamos apenas o builder padrão, a saída de docker buildx history ls e docker buildx history ls --local provavelmente será a mesma. No entanto, em ambientes com múltiplos builders, esta opção é útil para focar no histórico de um builder específico.
Isso conclui nossa exploração da listagem e filtragem do histórico de construção do Docker Buildx. Agora você sabe como visualizar seus registros de construção, filtrá-los por status, formatar a saída e listar registros do builder local.
Resumo
Neste laboratório, aprendemos como usar o comando docker buildx history ls para gerenciar registros de construção. Começamos construindo uma imagem Docker simples usando docker buildx build, que criou automaticamente um registro de construção. Em seguida, usamos docker buildx history ls para listar todos os registros de construção disponíveis, observando as informações associadas a cada construção.
Exploramos ainda mais as capacidades do docker buildx history ls aprendendo como filtrar registros de construção com base em seu status usando a opção --filter e como personalizar o formato da saída usando a opção --format. Finalmente, descobrimos como listar apenas os registros de construção locais usando a opção --local, fornecendo uma visão geral abrangente do gerenciamento e inspeção do histórico de construção do Docker Buildx.
