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 poder e flexibilidade para as organizações por meio de um modelo de extensibilidade que permite aos engenheiros de plataforma definir modelos pré-aprovados usando 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.

Diagrama mostrando componentes de ambientes de implantação Azure.

O modelo de extensibilidade permite que os engenheiros de plataforma definam a infraestrutura do aplicativo usando sua estrutura IaC preferida, incluindo 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. Esse modelo garante que sempre que uma implantação é feita, a execução da implantação ocorre com base em como a imagem do 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.

Diagrama mostrando componentes do modelo de extensibilidade de ambientes de implantação Azure.

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.

Gerenciador de Recursos do Azure - Bicep

Usar uma imagem padrão

O ADE fornece imagens padrão para estruturas de Azure Resource Manager e Bicep. Os clientes podem aproveitar essas estruturas de primeira parte e podem usar identificadores Resource Manager ou Bicep para configurar o respectivo modelo de IaC como uma definição de ambiente. Para implantações Azure Resource Manager 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

Microsoft facilita o processo de criação de uma imagem personalizada, fornecendo um script que compila e envia por push uma imagem personalizada 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

Microsoft facilita o processo de criação de uma imagem específica do Terraform, fornecendo um script que compila e envia a imagem por push 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

Você pode usar um fluxo de trabalho publicado para criar e enviar por push uma imagem específica do Terraform 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 pré-criada básica, que você pode usar diretamente nas definições do seu ambiente 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.