Azure Developer CLI (azd) Implantação de Container Apps

Implante aplicações de frontend + backend conteinerizadas no Azure Container Apps com builds remotos, identidade gerenciada e infraestrutura idempotente.

Autorização e Preparação

Inspecione os arquivos do projeto existentes e o tenant, assinatura e ambiente ativos primeiro. Provisionamento, implantação, atribuições de função e execução de hooks alteram recursos na nuvem e podem gerar custos. Prepare o diff exato, o alvo, o impacto estimado e o plano de rollback; execute apenas quando o usuário autorizar explicitamente essa implantação. Não imprima valores de ambiente ou credenciais em logs compartilhados.

Início Rápido

# Initialize and deploy
azd auth login
azd init                    # Creates azure.yaml and .azure/ folder
azd env new <env-name>      # Create environment (dev, staging, prod)
azd up                      # Provision infra + build + deploy

Estrutura de Arquivos Principais

project/
├── azure.yaml              # azd service definitions + hooks
├── infra/
│   ├── main.bicep          # Root infrastructure module
│   ├── main.parameters.json # Parameter injection from env vars
│   └── modules/
│       ├── container-apps-environment.bicep
│       └── container-app.bicep
├── .azure/
│   ├── config.json         # Default environment pointer
│   └── <env-name>/
│       ├── .env            # Environment-specific values (azd-managed)
│       └── config.json     # Environment metadata
└── src/
    ├── frontend/Dockerfile
    └── backend/Dockerfile

Configuração do azure.yaml

Configuração Mínima

name: azd-deployment
services:
  backend:
    project: ./src/backend
    language: python
    host: containerapp
    docker:
      path: ./Dockerfile
      remoteBuild: true

Configuração Completa com Hooks

name: azd-deployment
metadata:
  template: my-project@1.0.0

infra:
  provider: bicep
  path: ./infra

azure:
  location: eastus2

services:
  frontend:
    project: ./src/frontend
    language: ts
    host: containerapp
    docker:
      path: ./Dockerfile
      context: .
      remoteBuild: true

  backend:
    project: ./src/backend
    language: python
    host: containerapp
    docker:
      path: ./Dockerfile
      context: .
      remoteBuild: true

hooks:
  preprovision:
    shell: sh
    run: |
      echo "Before provisioning..."
      
  postprovision:
    shell: sh
    run: |
      echo "After provisioning - set up RBAC, etc."
      
  postdeploy:
    shell: sh
    run: |
      echo "Frontend: ${SERVICE_FRONTEND_URI}"
      echo "Backend: ${SERVICE_BACKEND_URI}"

Opções Chave do azure.yaml

Fluxo de Variáveis de Ambiente

Configuração de Três Níveis

1. Local .env - Apenas para desenvolvimento local
2. .azure/<env>/.env - Gerenciado pelo azd, preenchido automaticamente a partir das saídas do Bicep
3. main.parameters.json - Mapeia variáveis de ambiente para parâmetros do Bicep

Padrão de Injeção de Parâmetros

// infra/main.parameters.json
{
  "parameters": {
    "environmentName": { "value": "${AZURE_ENV_NAME}" },
    "location": { "value": "${AZURE_LOCATION=eastus2}" },
    "azureOpenAiEndpoint": { "value": "${AZURE_OPENAI_ENDPOINT}" }
  }
}

Sintaxe: ${VAR_NAME} ou ${VAR_NAME=default_value}

Definindo Variáveis de Ambiente

# Set for current environment
azd env set AZURE_OPENAI_ENDPOINT "https://my-openai.openai.azure.com"
azd env set AZURE_SEARCH_ENDPOINT "https://my-search.search.windows.net"

# Set during init
azd env new prod
azd env set AZURE_OPENAI_ENDPOINT "..." 

Saída do Bicep → Variável de Ambiente

// In main.bicep - outputs auto-populate .azure/<env>/.env
output SERVICE_FRONTEND_URI string = frontend.outputs.uri
output SERVICE_BACKEND_URI string = backend.outputs.uri
output BACKEND_PRINCIPAL_ID string = backend.outputs.principalId

Repetibilidade da Implantação

Reconciliação e alterações de revisão

1. Bicep é declarativo - Recursos se reconciliam com o estado desejado
2. Builds remotos marcam de forma única - Tags de imagem incluem o timestamp da implantação
3. ACR reutiliza camadas - Apenas camadas alteradas são carregadas

Preserve alterações não gerenciadas deliberadamente

…