Escrevendo Modelos ARM

Os modelos do ARM permitem definir a infraestrutura do Azure como código no formato JSON. Isso possibilita implantações repetíveis e consistentes, que podem ser controladas por versão junto com o código da sua aplicação. Os modelos são idempotentes — executar o mesmo modelo várias vezes produz o mesmo resultado, tornando seguro reaplicá-lo após alterações.

Todo modelo do ARM começa com uma propriedade $schema que aponta para a URL do esquema do modelo, seguida por uma cadeia de caracteres contentVersion. O esquema informa ao portal do Azure e às extensões do editor como validar o modelo e fornecer IntelliSense para ele. As cinco seções principais seguintes são parameters, variables, functions, resources e outputs.

Parameters tornam os modelos reutilizáveis ao aceitar entradas no momento da implantação. Cada parâmetro tem um type (string, int, bool, object, array, secureString), um defaultValue opcional e allowedValues opcionais para validação. Usar secureString para senhas garante que o valor nunca seja registrado no histórico da implantação.

Variables armazenam valores calculados a partir de parâmetros ou funções do modelo, reduzindo repetições e facilitando a manutenção dos modelos. As variáveis são avaliadas uma vez e referenciadas em toda a seção de recursos usando a expressão [variables('name')]. Um padrão comum é criar um nome de recurso concatenando um parâmetro com um sufixo exclusivo.

A matriz resources é o núcleo de um modelo do ARM. Cada elemento descreve um recurso do Azure com campos obrigatórios: type, apiVersion, name e location. A apiVersion fixa a versão do esquema do provedor de recursos — sempre use uma versão estável recente para acessar os recursos mais novos e evitar propriedades obsoletas.

As expressões dos modelos do ARM são envolvidas por colchetes [...] e são compatíveis com funções internas para cadeias de caracteres, matrizes, objetos e IDs de recursos. Entre as funções comuns estão concat(), resourceGroup(), resourceId(), uniqueString() e parameters(). Essas funções são avaliadas no lado do servidor pelo ARM no momento da implantação, e não localmente.

A seção outputs define os valores que o ARM retorna após uma implantação bem-sucedida. Os outputs são essenciais para encadear modelos — você implanta um modelo de rede e retorna o ID do recurso de sub-rede; depois, passa esse ID como parâmetro para um modelo de VM. Os outputs podem referenciar qualquer expressão, inclusive propriedades de recursos da implantação.

Para arquiteturas complexas, o ARM é compatível com modelos vinculados (que fazem referência a URLs de modelos externos) e modelos aninhados (que incorporam um modelo na matriz de recursos usando o tipo Microsoft.Resources/deployments). Isso permite dividir uma implantação de infraestrutura grande em partes modulares e reutilizáveis, mantendo um único modelo de orquestração como ponto de entrada.

Em vez de passar parâmetros na linha de comando, armazene-os em um arquivo de parâmetros separado — um arquivo JSON com um objeto parameters contendo pares de nome e valor. Os arquivos de parâmetros podem ser específicos de cada ambiente (por exemplo, dev.parameters.json e prod.parameters.json) e armazenados no controle de código-fonte, mantendo os valores confidenciais em referências ao Azure Key Vault, em vez de texto simples.

Use o comando da Azure CLI az deployment group create para implantar um modelo em um grupo de recursos. Antes de implantar em produção, execute az deployment group validate para detectar erros de esquema e lógica, e az deployment group what-if para visualizar as alterações nos recursos. Esses três comandos formam um pipeline de implantação seguro: validar, visualizar e implantar.

Siga estas práticas recomendadas para modelos do ARM: use parâmetros para valores específicos do ambiente, use variáveis para evitar repetições, fixe as versões da API em versões estáveis, use secureString para senhas, adicione descrições de metadados aos parâmetros e divida modelos grandes em módulos vinculados. Armazene os modelos em um repositório Git e implante-os por meio de um pipeline de CI/CD para garantir a rastreabilidade.

Teste sua compreensão dos conceitos do Microsoft Azure Fundamentals (AZ-900) abordados nesta lição.

Nesta lição, você aprendeu que os modelos do ARM são documentos JSON que definem declarativamente a infraestrutura do Azure; parâmetros e variáveis tornam os modelos reutilizáveis e fáceis de manter; e o fluxo de trabalho validate, what-if, deploy possibilita implantações seguras e repetíveis. A seguir, exploraremos o Bicep, uma abstração moderna sobre o JSON do ARM.