Introdução
Neste laboratório, você aprenderá como usar o comando docker config inspect para visualizar informações detalhadas sobre as configurações do Docker. Começaremos criando uma configuração do Docker a partir de um arquivo, que é um passo fundamental para gerenciar dados de configuração não sensíveis dentro de um Docker swarm.
Após a criação, você explorará como inspecionar a configuração criada usando tanto seu nome quanto seu ID único, demonstrando diferentes métodos para acessar os detalhes da configuração. Finalmente, você aprenderá como formatar a saída do comando docker config inspect usando a flag --format para personalizar as informações exibidas.
Criar uma configuração Docker
Nesta etapa, você aprenderá como criar uma configuração do Docker. As configurações do Docker são usadas para armazenar informações não sensíveis, como arquivos de configuração, que podem ser acessadas por serviços em um swarm.
Primeiro, vamos criar um arquivo de configuração simples. Criaremos um arquivo chamado my_config.txt no diretório ~/project com algum conteúdo de exemplo.
echo "This is my sample configuration." > ~/project/my_config.txt
Agora, podemos criar uma configuração do Docker a partir deste arquivo usando o comando docker config create. A sintaxe básica é docker config create <config_name> <file_path>.
docker config create my_config ~/project/my_config.txt
Você deve ver o ID da configuração recém-criada impresso no console. Isso indica que a configuração foi criada com sucesso.
Para verificar se a configuração foi criada, você pode listar todas as configurações do Docker usando o comando docker config ls.
docker config ls
Você deve ver my_config listado na saída, juntamente com seu ID e hora de criação.
Inspecionar uma configuração por nome
Nesta etapa, você aprenderá como inspecionar uma configuração do Docker usando seu nome. O comando docker config inspect permite que você visualize informações detalhadas sobre uma configuração específica.
Para inspecionar a configuração que criamos na etapa anterior, my_config, use o comando docker config inspect seguido pelo nome da configuração.
docker config inspect my_config
Este comando exibirá um objeto JSON contendo vários detalhes sobre a configuração my_config, como seu ID, hora de criação e o conteúdo dos dados de configuração.
A saída fornece uma visão abrangente das propriedades da configuração. Você pode ver os campos ID, CreatedAt, UpdatedAt, Spec e Version. O campo Spec contém os dados de configuração reais, que são codificados em base64.
Inspecionar uma configuração por ID
Nesta etapa, você aprenderá como inspecionar uma configuração do Docker usando seu ID. Embora a inspeção por nome seja conveniente, usar o ID também é possível e pode ser útil em certos cenários.
Primeiro, vamos recuperar o ID da my_config que criamos anteriormente. Você pode obter o ID a partir da saída do comando docker config ls.
docker config ls
Procure a coluna ID na saída da entrada my_config. Copie este ID.
Agora, use o comando docker config inspect seguido pelo ID da configuração que você acabou de copiar. Substitua <config_id> pelo ID real.
docker config inspect <config_id>
Por exemplo, se o ID fosse abc123def456, o comando seria:
docker config inspect abc123def456
Este comando produzirá a mesma saída JSON detalhada que ao inspecionar por nome, fornecendo informações sobre as propriedades da configuração.
A inspeção por ID é particularmente útil quando você tem várias configurações com nomes semelhantes ou quando está trabalhando com scripts que dependem de IDs de configuração.
Formatar a saída usando --format
Nesta etapa, você aprenderá como formatar a saída do comando docker config inspect usando a flag --format. Isso é útil quando você deseja extrair informações específicas da saída JSON em um formato mais legível.
A flag --format usa o pacote text/template do Go. Você pode especificar os campos que deseja exibir e como eles devem ser formatados.
Vamos tentar exibir apenas o ID e o tempo de criação da my_config. Podemos usar a seguinte string de formato: {{.ID}} {{.CreatedAt}}.
docker config inspect --format '{{.ID}} {{.CreatedAt}}' my_config
Este comando exibirá o ID e o tempo de criação da my_config, separados por um espaço.
Você também pode acessar campos aninhados dentro da saída JSON. Por exemplo, para acessar o nome da configuração, que está em Spec.Name, você usaria {{.Spec.Name}}.
Vamos exibir o nome e os dados codificados em base64 da configuração.
docker config inspect --format 'Name: {{.Spec.Name}}, Data: {{.Spec.Data}}' my_config
Este comando exibirá o nome e os dados codificados em base64 da configuração em um formato mais estruturado.
A flag --format é uma ferramenta poderosa para personalizar a saída dos comandos Docker e extrair as informações que você precisa.
Resumo
Neste laboratório, você aprendeu como criar uma configuração do Docker a partir de um arquivo usando o comando docker config create e verificar sua criação com docker config ls. Em seguida, você explorou como inspecionar uma configuração do Docker para visualizar suas informações detalhadas usando o comando docker config inspect, demonstrando como inspecionar uma configuração por seu nome.
