Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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
- Compte Azure avec un abonnement actif.
- Si vous n’en avez pas, vous pouvez en créer un gratuitement.
- Installez Azure CLI.
Créer un groupe de ressources
- Connectez-vous à Azure.
az login
- Mettez à niveau Azure CLI vers la dernière version.
az upgrade
- Inscrivez les fournisseurs de ressources requis.
az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights
- 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
- Compte Azure avec un abonnement actif.
- Si vous n’en avez pas, vous pouvez en créer un gratuitement.
- Installez Azure CLI.
- Installer Bicep
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éé.
Accédez à votre environnement Container Apps dans le portail Azure.
Sous Paramètres, sélectionnez Mise en réseau.
Sélectionnez l’onglet Paramètres d’entrée .
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. 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