Partager via


Utiliser l’ingress Premium avec Azure Container Apps

Dans cet article, vous apprendrez à utiliser l’ingress premium avec Azure Container Apps. Avec un ingress Premium, vous pouvez définir comment l'ingress est dimensionné et configuré pour mieux gérer les charges de travail de plus forte demande.

Prerequisites

Créer un groupe de ressources

  1. Connectez-vous à Azure.
az login
  1. Mettez à niveau Azure CLI vers la dernière version.
az upgrade
  1. Inscrivez les fournisseurs de ressources requis.
az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights
  1. Créez un groupe de ressources à l’aide de la commande suivante :
az group create --name my-container-apps --location centralus

Créer l’environnement

Pour créer l’environnement des applications conteneur, exécutez la commande suivante :

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

Configurer le profil de charge de travail

Ajoutez un profil de charge de travail à l’environnement (requis pour l’entrée 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 \

Votre profil de charge de travail doit avoir au moins deux nœuds pour utiliser l’entrée Premium.

Configurer l’entrée Premium

Ajoutez des paramètres d’entrée Premium à l’environnement à l’aide de la commande suivante :

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

Le tableau suivant décrit les paramètres que vous pouvez définir lors de la configuration des paramètres d’entrée Premium pour votre environnement Container Apps.

Paramètre Descriptif Par défaut Minimum Maximale
termination-grace-period Le temps (en secondes) pour permettre aux connexions actives de se fermer avant de terminer l'entrée. n/a 0 60
request-idle-limit La durée (en minutes) pendant laquelle une requête peut rester inactive avant déconnexion. 4 4 30
header-count-limit Nombre maximal d’en-têtes HTTP autorisés par requête. 100 1 n/a

Une fois configuré, vous verrez une sortie des paramètres que vous venez d’appliquer.

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

Mettre à jour et gérer l'accès Premium

Pour mettre à jour les paramètres d’entrée Premium pour l’environnement, exécutez la commande suivante :

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

Pour afficher les paramètres d’entrée Premium de l’environnement, exécutez la commande suivante :

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

Pour supprimer les paramètres d’entrée Premium de l’environnement, exécutez la commande suivante :

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

Pour supprimer le profil de charge de travail de l’environnement, exécutez la commande suivante :

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

Prerequisites

Déployer avec Bicep

Créez le fichier Bicep suivant et enregistrez sous 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
    }
  }
}              

Cette étape déploie un environnement Container Apps avec une configuration d’entrée Premium, y compris les paramètres suivants :

Nom Descriptif
name Nom du profil de charge de travail utilisé pour l’entrée Premium.
workloadProfileType Type/taille du profil de charge de travail (par exemple, D4) pour la mise à l’échelle et l’allocation de ressources.
minimumCount Nombre minimal d’instances pour le profil de charge de travail. Minimum : 2.
maximumCount Nombre maximal d’instances pour le profil de charge de travail. Maximum : 50.
workloadProfileName Nom du profil de charge de travail associé à la configuration d’entrée.
terminationGracePeriodSeconds Le temps (en secondes) pour permettre aux connexions actives de se fermer avant de terminer l'entrée. Minimum : 0, Maximum : 60.
headerCountLimit Nombre maximal d’en-têtes HTTP autorisés par requête. Valeur par défaut : 100, Minimum : 1.
requestIdleTimeout La durée (en minutes) pendant laquelle une requête peut rester inactive avant déconnexion. Valeur par défaut : 4, Minimum : 4, Maximum : 30.

Déployer sur Azure

Accédez au répertoire dans lequel vous avez enregistré le fichier ingress.bicep , puis exécutez la commande suivante pour déployer le fichier Bicep :

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

# Provision and deploy the infrastructure
azd up

Gérer le déploiement

Utilisez la commande suivante pour afficher l’état et les journaux de votre application conteneur.

# Check deployment status
azd show

# Clean up all resources
azd down

# View deployment logs
azd logs

Vous pouvez configurer l’entrée pour votre environnement une fois que vous l’avez créé.

  1. Accédez à votre environnement Container Apps dans le portail Azure.

  2. Sous Paramètres, sélectionnez Mise en réseau.

  3. Sélectionnez l’onglet Paramètres d’entrée .

  4. Configurez vos paramètres d’entrée en fonction des paramètres suivants.

    Réglage Valeur
    Mode d’entrée Sélectionnez Premium.
    Taille du profil de charge de travail Sélectionnez une taille entre D4 et D32.
    Instances de nœud minimales Saisissez le nombre minimal d'instances de nœuds du profil de charge de travail.
    Nombre maximal d’instances de nœud Saisissez le nombre maximal d'instances de nœuds du profil de charge de travail.
    Période de grâce pour résiliation Veuillez indiquer la durée du délai de grâce de résiliation en minutes.
    Délai d’inactivité de la demande Entrez le délai d’expiration de la demande d’inactivité en minutes.
    Nom de l’en-tête de la requête Entrez le nombre d’en-têtes de requête.
  5. Sélectionnez Appliquer.

Analyse et métriques

Les métriques d’entrée sont disponibles via le portail Azure dans l’instance d’environnement Container Apps. Sous Surveillance, sélectionnez Métriques. Ces métriques sont disponibles avec l'ingress par défaut ou Premium activé. Des métriques supplémentaires sont en cours de développement.

  • Utilisation du processeur d’entrée
  • Utilisation de la mémoire entrante (octets)

Les tests de performance montrent que le flux d'entrée peut gérer environ 3000 requêtes par seconde et par cœur de processeur (CPU), mais cette capacité varie en fonction de l'utilisation des applications. La mémoire tend uniquement à devenir un goulot d’étranglement si l’application reçoit des requêtes plus rapidement que l’environnement ne peut les traiter et que les requêtes s’accumulent au niveau de la couche d'ingress.

Les ressources allouées à l’entrée dans chaque mode sont les suivantes :

Mode Instances CPU (Unité centrale de traitement) Mémoire Seuil de scaling du CPU Seuil d'échelle de mémoire
Par défaut 2-10 1 cœur 2 Go 75 % 50 %
Prime Un par nœud (min 2) 90% de cœurs de nœud 90% de mémoire de nœud 50 % des cœurs du nœud 50% de mémoire de nœud

Nettoyer les ressources

Si vous ne souhaitez pas continuer à utiliser cette application, exécutez la commande suivante pour supprimer le groupe de ressources ainsi que toutes les ressources créées pendant ce démarrage rapide.

Caution

La commande suivante supprime le groupe de ressources spécifié et toutes les ressources qu’il contient. Si des ressources en dehors de l’étendue de ce guide de démarrage rapide existent dans le groupe de ressources spécifié, elles seront également supprimées.

az group delete --name my-container-apps