Use ingresso premium com Azure Container Apps

Pré-requisitos

• Conta do Azure com uma assinatura ativa.
  • Se não tiver uma, pode criar uma gratuitamente.
• Instale a CLI do Azure.

Criar grupo de recursos

1. Inicie sessão no Azure.

az login

2. Atualize o Azure CLI para a versão mais recente.

az upgrade

3. Registe os fornecedores de recursos necessários.

az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights

4. Crie um grupo de recursos usando o seguinte comando:

az group create --name my-container-apps --location centralus

Criar o ambiente

Para criar o ambiente de aplicações container, execute o seguinte comando:

az containerapp env create \
  --name my-container-apps-env \
  --resource-group my-resource-group \
  --location centralus

Configurar perfil de carga de trabalho

Adicione um perfil de carga de trabalho ao ambiente (necessário para entrada premium).

az containerapp env workload-profile add \
  --resource-group my-resource-group \
  --name my-container-apps-env \
  --workload-profile-name Ingress-D4 \
  --workload-profile-type D4 \

O seu perfil de carga de trabalho deve ter pelo menos dois nós para usar ingress premium.

Configurar ingresso premium

Adicione definições premium de entrada ao ambiente usando o seguinte comando:

az containerapp env premium-ingress add \
  --resource-group my-resource-group \
  --name my-container-apps-env \
  --workload-profile-name Ingress-D4 \
  --termination-grace-period 500 \
  --request-idle-timeout 4 \
  --header-count-limit 100

A tabela seguinte descreve os parâmetros que pode definir ao configurar definições de entrada premium para o seu ambiente de Aplicações de Contentores.

Depois de configurado, verá um resultado das definições que acabou de aplicar.

{
  "headerCountLimit": 100,
  "requestIdleTimeout": 4,
  "terminationGracePeriodSeconds": 500,
  "workloadProfileName": "Ingress-D4"
}

Atualizar e gerir o acesso premium

Para atualizar as definições premium de entrada do ambiente, execute o seguinte comando:

az containerapp env premium-ingress update \
  --resource-group my-resource-group \
  --name my-container-apps-env \
  --workload-profile-name Ingress-D4 \
  --termination-grace-period 500 \
  --request-idle-timeout 4 \
  --header-count-limit 100

Para mostrar as definições premium de entrada do ambiente, execute o seguinte comando:

az containerapp env premium-ingress show \
  --resource-group my-resource-group \
  --name my-container-apps-env

Para remover as definições premium de entrada do ambiente, execute o seguinte comando:

az containerapp env premium-ingress remove \
  --resource-group my-resource-group \
  --name my-container-apps-env

Para remover o perfil da carga de trabalho do ambiente, execute o seguinte comando:

az containerapp env workload-profile remove \
  --resource-group my-resource-group \
  --name my-container-apps-env \
  --workload-profile-name Ingress-D4

Pré-requisitos

• Conta do Azure com uma assinatura ativa.
  • Se não tiver uma, pode criar uma gratuitamente.
• Instale a CLI do Azure.
• Instalar o Bicep

Implementar com Bicep

Crie o seguinte ficheiro Bicep e guarde como ingress.bicep.

resource containerAppsEnvironment 'Microsoft.App/managedEnvironments@2025-07-01' = {
  name: 'my-container-app-env'
  location: 'centralus'
  tags: tags
  properties: {
    workloadProfiles: [
      {
        name: 'Ingress-D4'
        workloadProfileType: 'D4'
        minimumCount: 2
        maximumCount: 4
      }
    ]
    ingressConfiguration: {
      workloadProfileName: 'Ingress-D4'
      terminationGracePeriodSeconds: 600
      headerCountLimit: 101
      requestIdleTimeout: 5
    }
  }
}              

Esta etapa implementa um ambiente Container Apps com uma configuração premium de entrada, incluindo as seguintes definições:

Publicar no Azure

Navegue até à pasta onde guardou o ficheiro ingress.bicep e execute o seguinte comando para implantar o ficheiro Bicep:

# Login to Azure (if not already logged in)
azd auth login

# Provision and deploy the infrastructure
azd up

Gerir a implantação

Use o comando seguinte para visualizar o estado e os registos da sua aplicação container.

# Check deployment status
azd show

# Clean up all resources
azd down

# View deployment logs
azd logs