Compartilhar via


Usar entrada premium com os Aplicativos de Contêiner do Azure

Neste artigo, você aprenderá a usar a entrada premium com os Aplicativos de Contêiner do Azure. Com a entrada premium, você pode definir como a entrada é dimensionada e configurada para lidar melhor com cargas de trabalho de maior demanda.

Pré-requisitos

Criar grupo de recursos

  1. Inicie sessão no Azure.
az login
  1. Atualize a CLI do Azure para a versão mais recente.
az upgrade
  1. Registre os provedores de recursos necessários.
az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights
  1. 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 aplicativos de contêiner, execute o seguinte comando:

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

Configurar o 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 \

Seu perfil de carga de trabalho deve ter pelo menos dois nós para usar a entrada premium.

Configurar ingresso premium

Adicione configurações de entrada premium 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 a seguir descreve os parâmetros que você pode definir ao definir as configurações de entrada premium para seu ambiente de Aplicativos de Contêiner.

Parâmetro Description Padrão Mínimo Máximo
termination-grace-period O tempo (em segundos) para permitir que as conexões ativas fechem antes de encerrar a entrada. n/a 0 60
request-idle-limit O tempo (em minutos) em que uma solicitação pode permanecer ociosa antes de ser desconectada. 4 4 30
header-count-limit O número máximo de cabeçalhos HTTP permitidos por solicitação. 100 1 n/a

Depois de configurado, você verá uma saída das configurações que acabou de aplicar.

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

Atualizar e gerenciar a entrada premium

Para atualizar as configurações de entrada premium para o 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 configurações de entrada premium para o ambiente, execute o seguinte comando:

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

Para remover as configurações de entrada premium para o 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 de 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

Implantar com o Bicep

Crie o arquivo Bicep a seguir e salve 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 implanta um ambiente de Aplicativos de Contêiner com uma configuração de entrada premium, incluindo as seguintes configurações:

Nome Description
name O nome do perfil de carga de trabalho usado para entrada premium.
workloadProfileType O tipo/tamanho do perfil de carga de trabalho (por exemplo, D4) para dimensionamento e alocação de recursos.
minimumCount O número mínimo de instâncias do perfil de carga de trabalho. Mínimo: 2.
maximumCount O número máximo de instâncias para o perfil de carga de trabalho. Máximo: 50.
workloadProfileName O nome do perfil de carga de trabalho associado à configuração de entrada.
terminationGracePeriodSeconds O tempo (em segundos) para permitir que as conexões ativas fechem antes de encerrar a entrada. Mínimo: 0, Máximo: 60.
headerCountLimit O número máximo de cabeçalhos HTTP permitidos por solicitação. Padrão: 100, Mínimo: 1.
requestIdleTimeout O tempo (em minutos) em que uma solicitação pode permanecer ociosa antes de ser desconectada. Padrão: 4, Mínimo: 4, Máximo: 30.

Publicar no Azure

Navegue até o diretório em que você salvou o arquivo ingress.bicep e execute o seguinte comando para implantar o arquivo Bicep:

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

# Provision and deploy the infrastructure
azd up

Gerenciar a implantação

Use o comando a seguir para exibir o status e os logs do seu aplicativo de contêiner.

# Check deployment status
azd show

# Clean up all resources
azd down

# View deployment logs
azd logs

Você pode configurar a entrada para seu ambiente depois de criá-la.

  1. Acesse seu ambiente de Aplicativos de Contêiner no portal do Azure.

  2. Em Configurações, selecione Rede.

  3. Selecione a guia Configurações de Entrada .

  4. Defina as configurações de entrada de acordo com as configurações a seguir.

    Configurações Value
    Modo de entrada Selecione Premium.
    Tamanho do perfil da carga de trabalho Selecione um tamanho de D4 a D32.
    Instâncias mínimas de nós Insira as instâncias mínimas do nó do perfil de carga de trabalho.
    Instâncias máximas de nós Insira as instâncias máximas do nó do perfil de carga de trabalho.
    Período de carência de rescisão Insira o período de carência de término em minutos.
    Tempo limite de solicitação ociosa Insira o tempo limite de solicitação ocioso em minutos.
    Contagem de cabeçalhos de solicitação Insira o número de cabeçalhos de solicitação.
  5. Selecione Aplicar.

Monitoramento e métricas

As métricas de entrada estão disponíveis por meio do portal do Azure na instância de ambiente dos Aplicativos de Contêiner. Em Monitoramento, selecione Métricas. Essas métricas estão disponíveis com Ingresso Padrão ou Premium habilitado. Métricas adicionais estão em andamento.

  • Uso da CPU de entrada
  • Bytes de uso de memória de entrada

Os parâmetros de comparação mostram que a entrada pode lidar com cerca de 3.000 solicitações por segundo por núcleo de CPU, mas essa capacidade varia de acordo com o uso do aplicativo. A memória só tende a se tornar um gargalo se o aplicativo estiver recebendo solicitações mais rapidamente do que o ambiente pode manipular e as solicitações forem enfileiradas na camada de entrada.

Os recursos alocados para a entrada em cada modo são:

Mode Instâncias CPU Memória Limite de escala da CPU Limiar de Escala de Memória
Default 2-10 Um núcleo 2 GB 75% 50%
Prêmio Um por node (no mínimo 2) 90% dos núcleos de nós 90% de memória do nó 50% de núcleos de nó 50% de memória do nó

Limpar os recursos

Caso não pretenda continuar usando este aplicativo, execute o comando a seguir para excluir o grupo de recursos junto com todos os recursos criados neste guia de início rápido.

Cuidado

O comando a seguir exclui o grupo de recursos especificado e todos os recursos contidos nele. Se houver recursos fora do escopo desse início rápido no grupo de recursos especificado, eles também serão excluídos.

az group delete --name my-container-apps