Práticas recomendadas para catálogos de Ambientes de Implantação do Azure

Este artigo descreve as práticas recomendadas para estruturar um catálogo de Ambientes de Implantação do Azure.

Estruturar o catálogo para cache eficiente

Os engenheiros de plataforma devem estruturar catálogos de uma maneira que torne mais fácil e rápido para os Ambientes de Implantação do Azure localizarem e armazenarem em cache definições de ambiente. Ao organizar o repositório em uma estrutura específica, você pode direcionar melhor os arquivos para cache e melhorar o desempenho geral do processo de implantação. Para garantir resultados ideais, os engenheiros de plataforma precisam entender essas diretrizes e estruturar seus repositórios adequadamente.

Quando você anexa um catálogo a um centro de desenvolvimento, os Ambientes de Implantação verificam o catálogo em busca de um arquivo environment.yaml ou manifest.yaml. Quando ele localiza o arquivo, os Ambientes de Implantação do Azure assumem que os arquivos nessa pasta e subpastas formam uma definição de ambiente. Os Ambientes de Implantação do Azure armazenam em cache apenas os arquivos necessários, não todo o repositório.

O diagrama a seguir mostra a estrutura recomendada para um repositório. Cada modelo reside em uma única pasta.

Diagrama que mostra a estrutura de pastas recomendada para um catálogo de Ambientes de Implantação do Azure.

Definições de ambiente vinculado

Em um cenário de definições de ambiente vinculado, vários arquivos de .json podem apontar para um único modelo. Os Ambientes de Implantação do Azure verificam as definições de ambiente vinculadas sequencialmente e recuperam os arquivos vinculados e as definições de ambiente do repositório. Para obter o melhor desempenho, essas interações devem ser minimizadas.

Atualizar definições de ambiente e alterações de sincronização

Com o tempo, as definições de ambiente precisam de atualizações. Você faz essas atualizações em seu repositório Git. Em seguida, você deve sincronizar manualmente o catálogo para atualizar as alterações nos Ambientes de Implantação do Azure.

No exemplo a seguir, o arquivo azuredeploy.json está acima do arquivo environment.yaml (ou manifest.yaml) na estrutura da pasta. Essa estrutura não é válida. As definições de ambiente não podem fazer referência ao conteúdo fora da pasta de itens do catálogo.

Diagrama que mostra uma estrutura sem suporte para um catálogo de Ambientes de Implantação do Azure.