Étiquettes de déploiement dans Azure Container Apps

Les étiquettes de déploiement vous aident à attribuer des noms explicites, tels que dev, intermédiaire ou prod, à des révisions de conteneur spécifiques. Lorsque vous appliquez ces noms, vous simplifiez la gestion des scénarios de déploiement complexes et de la gestion de l’environnement.

À l’aide d’étiquettes de déploiement, vous pouvez :

• Affectez des étiquettes claires et descriptives aux révisions.
• Affectez automatiquement de nouvelles révisions aux étiquettes pour le routage et la gestion du trafic.
• Achemine le trafic en s’appuyant sur des étiquettes plutôt que sur la modification des noms de révision.
• Permet de promouvoir ou de rétrograder des révisions par la réaffectation d’étiquettes.
• Revenez aux révisions précédentes à l’aide de l’historique des étiquettes.

Important

Avant de pouvoir utiliser des étiquettes de déploiement, vous devez suivre les étapes permettant d’activer d’abord les étiquettes de déploiement dans le portail pour votre application conteneur.

Fonctionnalités clés

Les étiquettes de déploiement vous permettent de créer des stratégies de déploiement sophistiquées tout en conservant le contrôle du cycle de vie de votre application à l’aide des fonctionnalités suivantes :

• Attribuer des étiquettes : créez et attribuez des étiquettes significatives aux révisions de conteneur afin de faciliter la gestion des environnements tels que le développement, la préproduction et la production.

• Répartition du trafic et tests A/B : La prise en charge de la répartition du trafic, du retour en arrière à l’aveugle et des tests A/B permet le déploiement progressif et le test de nouvelles fonctionnalités.

• Versions intermédiaires et échange automatique : l’activation automatique des révisions vous permet de créer en toute transparence de nouvelles révisions et de les affecter à des libellés nouveaux ou existants pour recevoir le trafic. Toutes les révisions qui ne sont plus référencées par une étiquette sont arrêtées automatiquement.

Utiliser des étiquettes de déploiement

Par défaut, les étiquettes de déploiement ne sont pas disponibles pour votre application conteneur. Pour activer, étiquettes de déploiement, procédez comme suit dans le portail Azure :

1. Ouvrez votre application de conteneur dans le Portail Azure.

2. Dans le menu, sous la section Application, sélectionnez Révisions et répliques.

3. Sélectionnez Le mode déploiement.

4. Sélectionnez la colonne Étiquettes de déploiement .

5. Sélectionnez Appliquer.

Créer une étiquette

Créez de nouvelles étiquettes dans le portail en fonction des étiquettes existantes. Par défaut, Container Apps crée votre première étiquette nommée label-1. Lorsque vous créez des étiquettes via l’interface CLI ou Bicep, vous pouvez les associer à n’importe quelle révision existante ou à une nouvelle révision.

1. Ouvrez votre application de conteneur dans le Portail Azure.

2. Dans le menu, sous la section Application, sélectionnez Étiquettes.

3. Sélectionnez Nouvelle étiquette.

4. Sélectionnez l’étiquette existante sur laquelle vous souhaitez baser votre nouvelle étiquette.

5. Entrez le nouveau nom d’étiquette dans la zone de texte.

6. Sélectionnez Dupliquer.

Historique des étiquettes et restaurations

Vous pouvez afficher l’historique complet d’une étiquette en procédant comme suit :

1. Ouvrez votre application de conteneur dans le Portail Azure.

2. Dans le menu, sous Application, sélectionnez Étiquettes.

3. Sélectionnez Afficher l’historique de l’étiquette qui vous intéresse.

Utilisez l’option Afficher l’historique pour toute étiquette pour :

• Passez en revue l’historique de révision de l’étiquette.
• Revenez à une révision précédente en pointant l’étiquette vers une autre révision de conteneur.

Utiliser des étiquettes de déploiement

Pour activer les étiquettes de déploiement, procédez comme suit dans Azure CLI :

1. Ouvrez votre terminal.

2. Créez les variables d’environnement suivantes.

    CONTAINER_APP_NAME="my-container-app"
    CONTAINER_APP_IMAGE="mcr.microsoft.com/k8se/quickstart:latest"
    LOCATION="centralus"
    RESOURCE_GROUP="my-container-apps-rg"
    ENVIRONMENT_NAME="my-container-apps-env"
    TARGET_LABEL="stage"
   

3. Utilisez la commande suivante pour créer une nouvelle application et une révision avec label :

   az containerapp create \
   --name $CONTAINER_APP_NAME \
   --resource-group $RESOURCE_GROUP \
   --image $CONTAINER_APP_IMAGE \
   --environment $ENVIRONMENT_NAME \
   --location $LOCATION \
   --ingress external \
   --target-port 0 \
   --revisions-mode labels \
   --target-label $TARGET_LABEL
   

4. Pour créer une révision avec une étiquette nouvelle ou existante, utilisez la commande suivante :

   az containerapp update \
   --name $CONTAINER_APP_NAME \
   --resource-group $RESOURCE_GROUP \
   --image $CONTAINER_APP_IMAGE \
   --target-label $TARGET_LABEL
   

5. Pour afficher l’historique des étiquettes, utilisez la commande suivante :

   az containerapp label-history show \
   --name $CONTAINER_APP_NAME \
   --resource-group $RESOURCE_GROUP \
   --label $TARGET_LABEL
   

6. Pour afficher le trafic de l’application d’étiquette, utilisez la commande suivante :

   az containerapp ingress traffic show \
   --name $CONTAINER_APP_NAME \
   --resource-group $RESOURCE_GROUP \
   

7. Pour ajouter une étiquette à une révision, utilisez les commandes suivantes :

   az containerapp revision label add \
   --name $CONTAINER_APP_NAME \
   --resource-group $RESOURCE_GROUP \
   --revision $REVISION_NAME \
   --label $TARGET_LABEL
   

8. Pour supprimer une étiquette d’une révision, utilisez les commandes suivantes :

   az containerapp revision label remove \
   --name $CONTAINER_APP_NAME \
   --resource-group $RESOURCE_GROUP \
   --label $TARGET_LABEL
   

Scénarios pris en charge

• Déploiements bleu-vert : gérez facilement les déploiements bleu-vert en étiquetant et en basculant entre les révisions. Cette approche offre un moyen simple de gérer les permutations d’environnement complètes.

• Test A/B : diriger un pourcentage de trafic vers différentes révisions pour les tests de fonctionnalités. Cette pratique vous permet de valider de nouvelles fonctionnalités avec un sous-ensemble d’utilisateurs avant le déploiement complet.

• Déploiements progressifs : Augmentez progressivement le trafic vers une nouvelle révision en ajustant les pourcentages de trafic.

• Isolation de l’environnement : utilisez des étiquettes pour gérer des environnements dev, intermédiaires et prod distincts. Chaque environnement peut être mis à jour indépendamment tout en conservant un chemin de promotion clair.

Exemple de flux de travail

Voici un flux de travail classique utilisant des étiquettes de déploiement :

1. Créer des étiquettes initiales : créez des étiquettes telles que « stage » et « production » pointant vers la même révision initialement.

2. Mettez à jour une étiquette : sélectionnez une étiquette (par exemple, « étape ») pour la mettre à jour avec de nouveaux conteneurs, une mise à l’échelle ou des paramètres de volume.

3. Testez les modifications : avec la nouvelle révision déployée, routez une partie du trafic vers l’étiquette mise à jour.

4. Promouvoir les modifications : lorsque vous êtes confiant dans la révision de production, mettez à jour l’étiquette de production pour qu’elle pointe vers la même révision.

5. Surveiller et restaurer si nécessaire : si des problèmes se produisent, utilisez l’historique des étiquettes pour revenir à une version précédente.

Contenu connexe

Étiquettes de révision