Como usar o comando docker config create para gerenciar configurações

Introdução

Neste laboratório, você aprenderá como gerenciar configurações de forma eficaz dentro do Docker usando o comando docker config create. Exploraremos diferentes métodos para criar configurações, começando com a criação de uma configuração simples diretamente da entrada padrão (standard input).

Em seguida, você aprenderá como criar uma configuração a partir de um arquivo existente, uma abordagem prática para gerenciar dados de configuração mais extensos. Também abordaremos como adicionar rótulos (labels) às suas configurações para melhor organização e identificação. Por fim, você aprenderá como inspecionar os detalhes das configurações que criou para verificar seu conteúdo e propriedades.

Criar uma configuração simples a partir de STDIN

Nesta etapa, você aprenderá como criar uma configuração do Docker a partir da entrada padrão (STDIN). As configurações do Docker são usadas para armazenar dados não sensíveis, como arquivos de configuração, que podem ser acessados ​​por serviços do Docker.

Primeiro, vamos criar um conteúdo de configuração simples. Usaremos o comando echo para gerar uma string e canalizá-la para o comando docker config create.

echo "This is my simple config content." | docker config create my_simple_config -

No comando acima:

• echo "This is my simple config content." gera a string que será o conteúdo da nossa configuração.
• | é o operador pipe, que envia a saída do comando echo como entrada para o próximo comando.
• docker config create é o comando para criar uma nova configuração do Docker.
• my_simple_config é o nome que estamos dando à nossa configuração.
• - informa ao docker config create para ler o conteúdo da configuração de STDIN.

Após executar este comando, o Docker criará uma configuração chamada my_simple_config com o conteúdo especificado.

Para verificar se a configuração foi criada com sucesso, você pode listar as configurações do Docker existentes usando o comando docker config ls.

docker config ls

Você deve ver my_simple_config listado na saída.

Criar uma configuração a partir de um arquivo

Na etapa anterior, você aprendeu como criar uma configuração do Docker a partir da entrada padrão. Nesta etapa, você aprenderá como criar uma configuração do Docker a partir de um arquivo. Esta é uma maneira comum de gerenciar dados de configuração maiores ou mais complexos.

Primeiro, vamos criar um arquivo de configuração simples. Usaremos o editor nano para criar um arquivo chamado my_config_file.txt no seu diretório ~/project.

nano ~/project/my_config_file.txt

Dentro do editor nano, insira o seguinte conteúdo:

This is the content from my config file.
Another line of configuration.

Pressione Ctrl + X, depois Y e Enter para salvar o arquivo e sair do editor.

Agora que temos nosso arquivo de configuração, podemos criar uma configuração do Docker a partir dele usando o comando docker config create.

docker config create my_file_config ~/project/my_config_file.txt

Neste comando:

• docker config create é o comando para criar uma nova configuração do Docker.
• my_file_config é o nome que estamos dando a esta configuração.
• ~/project/my_config_file.txt é o caminho para o arquivo contendo o conteúdo da configuração.

O Docker lerá o conteúdo de ~/project/my_config_file.txt e criará uma configuração chamada my_file_config.

Para confirmar que a configuração foi criada com sucesso, você pode novamente listar as configurações do Docker.

docker config ls

Você agora deve ver tanto my_simple_config (da etapa anterior) quanto my_file_config listados.

Criar uma configuração com rótulos

Nesta etapa, você aprenderá como adicionar rótulos às suas configurações do Docker. Rótulos (labels) são pares chave-valor que você pode anexar a objetos do Docker, incluindo configurações, para ajudar a organizá-los e identificá-los. Isso é particularmente útil em implantações maiores.

Criaremos outra configuração, desta vez adicionando rótulos durante o processo de criação. Usaremos o mesmo conteúdo do arquivo que criamos na etapa anterior, mas o canalizaremos de cat para docker config create e adicionaremos rótulos usando a flag --label.

cat ~/project/my_config_file.txt | docker config create --label environment=development --label version=1.0 my_labeled_config -

Vamos detalhar este comando:

• cat ~/project/my_config_file.txt lê o conteúdo do arquivo que criamos anteriormente.
• | canaliza o conteúdo do arquivo para o próximo comando.
• docker config create é o comando para criar uma nova configuração do Docker.
• --label environment=development adiciona um rótulo com a chave environment e o valor development.
• --label version=1.0 adiciona outro rótulo com a chave version e o valor 1.0. Você pode adicionar vários rótulos usando a flag --label várias vezes.
• my_labeled_config é o nome que estamos dando a esta configuração.
• - indica que o conteúdo da configuração deve ser lido de STDIN.

Após executar este comando, uma nova configuração chamada my_labeled_config será criada com o conteúdo e os rótulos especificados.

Para ver os rótulos associados às suas configurações, você pode usar o comando docker config ls com a flag --format para exibir os rótulos.

docker config ls --format "{{.Name}}\t{{.Labels}}"

Este comando listará os nomes das configurações e seus rótulos associados. Você deve ver os rótulos environment e version para my_labeled_config.

Inspecionar a configuração criada

Nesta etapa final, você aprenderá como inspecionar uma configuração do Docker para visualizar seus detalhes, incluindo seu ID, nome, tempo de criação e rótulos. Isso é útil para verificar as propriedades da configuração e entender sua configuração.

Usaremos o comando docker config inspect para visualizar os detalhes de my_labeled_config que criamos na etapa anterior.

docker config inspect my_labeled_config

Este comando exibirá uma string formatada em JSON contendo informações detalhadas sobre a configuração especificada. Você verá campos como ID, Name, CreatedAt, UpdatedAt e Labels. O campo Labels mostrará os rótulos environment e version que adicionamos.

Você também pode usar a flag --pretty para obter uma saída mais legível por humanos.

docker config inspect --pretty my_labeled_config

Isso exibirá as informações em um formato mais organizado, tornando-o mais fácil de ler.

Inspecionar configurações é uma etapa crucial no gerenciamento de suas configurações do Docker, permitindo que você confirme suas configurações antes de usá-las em seus serviços.

Resumo

Neste laboratório, você aprendeu como criar configurações do Docker usando o comando docker config create. Você praticou a criação de uma configuração simples diretamente da entrada padrão (standard input), o que é útil para configurações rápidas e pequenas. Você também aprendeu como criar uma configuração a partir de um arquivo, uma abordagem mais prática para gerenciar dados de configuração maiores ou mais complexos. Por fim, você explorou como adicionar rótulos às suas configurações para melhor organização e gerenciamento de metadados, e como inspecionar os detalhes de suas configurações criadas usando o comando docker config inspect.