
O Docker Compose permite gerenciar vários contêineres do Docker e seus recursos associados, como volumes e redes. Você escreve arquivos YAML declarativos que o Compose usa para criar sua pilha de contêineres.
Sua docker-compose.yml os arquivos podem se tornar repetitivos quando você está trabalhando com uma pilha complexa. Os serviços podem compartilhar opções de configuração, fazendo com que você duplique seções de seu arquivo. As atualizações posteriores podem levar a erros se você se esquecer de atualizar todas as instâncias de uma seção.
Como os arquivos Compose são arquivos YAML simples, você pode aproveitar as vantagens dos recursos YAML integrados para modularizar suas definições de pilha. Âncoras, aliases e extensões permitem abstrair seções YAML em blocos reutilizáveis. Você pode adicionar uma referência à seção em cada lugar em que for necessária.
O que é uma âncora?
As âncoras YAML são um recurso que permite identificar um item e, em seguida, referenciá-lo em outro lugar em seu arquivo. As âncoras são criadas usando o & assinar. O sinal é seguido por um nome alternativo. Você pode usar este alias posteriormente para fazer referência ao valor após a âncora.
Veja como você pode usar uma âncora para evitar a repetição das políticas de reinicialização do contêiner:
services: httpd: image: httpd:latest restart: &restartpolicy unless-stopped mysql: image: mysql:latest restart: *restartpolicy
A âncora é referenciada usando o * personagem e seu apelido. Você deve garantir que não haja espaço entre os &/* caracteres e o seguinte nome de alias.
Este exemplo mostra como um valor de linha única pode ser reutilizado com âncoras. A alteração da política de reinicialização da pilha agora pode ser feita em um lugar, sem editar os serviços individualmente.
Âncoras multilinhas
As âncoras podem ter valores multilinhas. Você os cria usando a mesma sintaxe de uma âncora de linha única. Isso é útil quando você precisa fornecer um conjunto de detalhes de configuração para vários serviços.
services: first: image: my-image:latest environment: &env - CONFIG_KEY - EXAMPLE_KEY - DEMO_VAR second: image: another-image:latest environment: *env
O second serviço agora puxará nas mesmas variáveis de ambiente que first. Não tivemos que repetir a lista de variáveis de ambiente, tornando-a muito mais fácil de manter no futuro.
Estendendo Valores Âncora
O exemplo de ambiente acima pega o valor da âncora e o usa como está. Freqüentemente, você desejará estender a âncora para adicionar valores adicionais. Você pode fazer isso com uma sintaxe alternativa.
Modifique o second serviço da seguinte forma:
services: second: image: another-image:latest environment: <<: *env - AN_EXTRA_KEY - SECOND_SPECIFIC_KEY
O serviço agora puxa a configuração do ambiente base do env âncora. Chaves adicionais são então adicionadas à lista de ambientes. Você também pode substituir as chaves existentes definidas pela âncora.
Usando campos de extensão
Outra abordagem à modularização são os campos de extensão. Esses são fragmentos YAML especiais de nível superior que serão ignorados pelo Docker.
O Docker geralmente tenta interpretar qualquer nó na raiz de um arquivo Compose. O analisador irá ignorar os campos de extensão prefixados com x-. Você pode usar esses campos para encapsular a configuração compartilhada para referência posterior. Combine campos de extensão com âncoras para abstrair seções de suas definições de serviço.
x-env: &env environment: - CONFIG_KEY - EXAMPLE_KEY services: first: <<: *env image: my-image:latest second: <<: *env image: another-image:latest
Este arquivo Compose é um refinamento adicional sobre o exemplo mostrado acima. As variáveis de ambiente não pertencem mais a nenhum dos serviços. Eles foram retirados completamente, para dentro do x-env campo de extensão.
Isso define um novo nó que contém o environment campo. Uma âncora YAML é usada (&env) para que ambos os serviços possam fazer referência ao valor do campo de extensão.
Composibilidade
O uso desses recursos permite que você divida seus arquivos do Compose em blocos autocontidos. Isso ajuda a evitar definições de serviço excessivamente repetitivas. Qualquer coisa comum a mais de um serviço deve ser elevada a um campo de extensão.
Além de auxiliar na manutenção, essa prática comunica suas intenções a outros colaboradores. É claro que todos os campos de extensão de nível superior contêm campos genéricos. Eles não estão vinculados a nenhum serviço específico e podem ser reutilizados livremente.
Âncoras e campos de extensão permitem que você compor suas definições de serviço de blocos reutilizáveis de YAML. Ao manter cada campo pequeno, seus serviços podem misturar e combinar seções de configuração das âncoras disponíveis. Manter seus arquivos do Compose deve se tornar menos trabalhoso.
Outras abordagens para modularidade
Além de âncoras e extensões, não se esqueça de que você sempre pode dividir suas definições do Compose em vários arquivos do Compose. Isso pode ser necessário quando você tem mais de um punhado de serviços individuais.
O uso de vários arquivos Compose permite que você atribua a cada serviço seu próprio arquivo. Você também pode criar arquivos de substituição, onde os valores de um nó são substituídos ou estendidos. O Compose mesclará todos os arquivos para criar a configuração final de tempo de execução.
service.yml
services: service: image: my-image:latest
service-dev.yml
services: service: environment: - DEV_MODE=true
Neste exemplo, a aplicação de ambos os arquivos Compose resultaria em um serviço, my-image:latest, com o DEV_MODE conjunto de variáveis de ambiente. Para usar vários arquivos com o Compose CLI, passe o -f bandeira:
docker-compose -f service.yml -f service-dev.yml up -d
Os arquivos são mesclados na ordem especificada.
Resumo
Os arquivos do Docker Compose podem se tornar pesados e repetitivos. Se você está gastando tempo copiando valores, considere abstrair seções de seus serviços em blocos YAML dedicados.
Recursos como âncoras e extensões ajudam na manutenção e facilitam a experiência de criação. Nem todo arquivo Compose se beneficiará - alguns serviços podem ter pouco em comum entre si - então avalie sua pilha específica antes de começar.



