O que o Modelo de Extensibilidade do ADE?
O ADE (Ambientes de Implantação Azure) permite que você forneça um conjunto coletado de modelos de IaC (infraestrutura como código) usados por suas equipes de desenvolvimento para executar implantações. O ADE oferece potência e flexibilidade para organizações por meio de um modelo de extensibilidade que permite que os engenheiros de plataforma definam modelos pré-aprovados usados sua estrutura IaC preferida. O diagrama a seguir mostra o fluxo de trabalho completo do ADE. O catálogo armazena modelos de IaC, que fazem referência a imagens de contêiner para uso em implantações. Os engenheiros de plataforma coletam imagens e modelos e definem as configurações de ambiente com base na fase de desenvolvimento, permitindo que os desenvolvedores criem ambientes de implantação altamente específicos. Os desenvolvedores podem criar ambientes improvisados para fins de desenvolvimento/teste ou ambientes compartilhados como parte de seu pipeline de CI/CD ou como parte de um pipeline automatizado.
O modelo de extensibilidade permite que os engenheiros de plataforma definam a infraestrutura do aplicativo usando sua estrutura IaC preferida, incluindo ARM (Azure Resource Manager), Bicep, Terraform e Pulumi. Os engenheiros de plataforma criam e personalizam imagens de contêiner para cenários diferentes. Eles enviam essas imagens por push para um registro de contêiner e fazem referência a elas no arquivo de metadados da definição de ambiente. Isso garante que sempre que uma implantação é feita, a execução da implantação ocorre com base em como a imagem de contêiner é configurada. O diagrama a seguir mostra a relação entre as imagens personalizadas armazenadas em um registro de contêiner e a definição do ambiente dentro do catálogo.
Introdução às imagens personalizadas
Você pode escolher entre várias opções para criar imagens personalizadas, dependendo da estrutura IaC necessária e da complexidade de suas necessidades.
ARM-Bicep
Usar uma imagem padrão
Para estruturas primárias – ARM e Bicep – o ADE fornece imagens padrão que os clientes podem aproveitar e podem usar apenas identificadores ARM ou Bicep para configurar o respectivo modelo IaC como uma definição de ambiente. Para implantações ARM ou Bicep, você pode usar a imagem padrão referenciando-a no arquivo environment.yaml e definindo recursos no arquivo de modelo (azuredeploy.json, main.bicep).
Para obter instruções, consulte Usar uma imagem de contêiner padrão.
Criar uma imagem personalizada usando um script
Para facilitar o processo de criação de uma imagem personalizada e o envio por push para um registro de contêiner, a Microsoft fornece um script que cria e envia a imagem por push para um registro especificado.
Para obter instruções, consulte Criar uma imagem de contêiner personalizada usando um script.
Criar uma imagem personalizada manualmente
Para cenários mais complexos, comece com a imagem padrão e personalize-a instalando pacotes de software e ajustando as configurações. Crie a imagem e carregue-a em um registro de contêiner em que o ADE possa acessá-la. Especifique a localização da imagem no arquivo environment.yaml.
Para obter instruções, consulte Criar uma imagem de contêiner personalizada manualmente.
Terraform
Criar uma imagem personalizada usando um script
Para facilitar o processo de criação de uma imagem específica do Terraform e envio por push para um registro de contêiner, a Microsoft fornece um script que compila e envia por push a imagem para um registro que você especificar.
Para obter instruções, consulte Criar uma imagem de contêiner personalizada usando um script.
Criar uma imagem personalizada usando um fluxo de trabalho do GitHub
Para facilitar o processo de criação de uma imagem específica do Terraform e envio por push para um registro de contêiner, você pode usar um fluxo de trabalho publicado que compila e envia a imagem por push para um registro especificado.
Para obter instruções, consulte: Criar uma imagem de contêiner personalizada usando um fluxo de trabalho do GitHub.
Criar uma imagem de contêiner específica do Terraform manualmente
Você pode usar um fluxo de trabalho do GitHub para criar uma imagem específica do Terraform que inclua o software, as configurações e outras personalizações necessárias para sua imagem específica do Terraform. Em seguida, você pode carregar a nova imagem para um registro de contêiner e usá-la referenciando-a no arquivo environment.yaml.
Para obter instruções, consulte Criar uma imagem de contêiner personalizada manualmente.
Pulumi
Usar uma imagem padrão
A equipe do Pulumi fornece uma imagem predefinida para você começar, que você pode usar diretamente de suas definições de ambiente do ADE. Para imagens do Pulumi, você pode usar a imagem padrão referenciando-a no arquivo environment.yaml e definindo os recursos a serem implantados no arquivo de projeto (pulumi.yaml).
Para obter instruções, consulte Usar uma imagem de contêiner padrão fornecida por Pulumi.
Criar uma imagem personalizada manualmente
Para cenários mais complexos, comece com a imagem padrão e personalize-a instalando pacotes de software e ajustando as configurações. Crie a imagem e carregue-a em um registro de contêiner em que o ADE possa acessá-la. Especifique a localização da imagem no arquivo environment.yaml.
Para obter instruções, consulte Criar uma imagem personalizada.