Gérer les révisions dans Azure Container Apps

Azure Container Apps permet à votre application conteneur de prendre en charge plusieurs révisions. Avec cette fonctionnalité, vous pouvez activer et désactiver des révisions et contrôler la quantité de trafic envoyé à chaque révision. Pour en savoir plus sur les révisions, consultez Révisions dans Azure Container Apps.

Une révision est créée lorsque vous déployez votre application pour la première fois. Les nouvelles révisions sont créées lorsque vous mettez à jour votre application avec des modifications d’étendue de révision. Vous pouvez également mettre à jour votre application conteneur en fonction d’une révision spécifique.

Cet article décrit les commandes pour gérer les révisions de votre application conteneur. Pour plus d’informations sur les commandes Container Apps, consultez az containerapp. Pour plus d’informations sur les commandes pour gérer les révisions, consultez az containerapp revision.

Mise à jour de votre application conteneur

Pour mettre à jour une application conteneur, utilisez la commande az containerapp update. Avec cette commande, vous pouvez modifier des variables d’environnement, des ressources de calcul, des paramètres d’échelle et déployer une autre image. Si la mise à jour de votre application conteneur inclut des modifications d’étendue de révision, une nouvelle révision est générée.

az containerapp update \
  --name <APPLICATION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --image <IMAGE_NAME>

$ImageParams = @{
    Name = '<ContainerName>'
    Image = 'mcr.microsoft.com/k8se/quickstart'
}
$TemplateObj = New-AzContainerAppTemplateObject @ImageParams

$UpdateArgs = @{
  Name = '<ApplicationName>'
  ResourceGroupName = '<ResourceGroupName>'
  Location = '<Location>'
}
Update-AzContainerApp @UpdateArgs

Vous pouvez également mettre à jour votre application conteneur avec la commande Revision copy.

Liste des révisions

Listez toutes les révisions associées à votre application conteneur avec az containerapp revision list. Pour plus d’informations sur cette commande, consultez az containerapp revision list

az containerapp revision list \
  --name <APPLICATION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  -o table

$CmdArgs = @{
  ContainerAppName = '<CONTAINER_APP_NAME>'
  ResourceGroupName = '<RESOURCE_GROUP_NAME>'
}

Get-AzContainerAppRevision @CmdArgs

Affichage de révision

Affichez les détails d’une révision spécifique en utilisant la commande az containerapp revision show.

az containerapp revision show \
  --name <APPLICATION_NAME> \
  --revision <REVISION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME>

$CmdArgs = @{
  ContainerAppName = '<CONTAINER_APP_NAME>'
  ResourceGroupName = '<RESOURCE_GROUP_NAME>'
  RevisionName = '<REVISION_NAME>'
}

$RevisionObject = (Get-AzContainerAppRevision @CmdArgs) | Select-Object -Property *
echo $RevisionObject

Copie de révision

Pour créer une révision basée sur une révision existante, utilisez az containerapp revision copy. Container Apps utilise la configuration de la révision existante, que vous pouvez ensuite modifier.

Avec cette commande, vous pouvez modifier des variables d’environnement, des ressources de calcul, des paramètres d’échelle et déployer une autre image. Vous pouvez également utiliser un fichier YAML pour définir ces options et d’autres options de configuration et paramètres. Pour plus d’informations concernant cette commande, consultez az containerapp revision copy.

Cet exemple copie la dernière révision et définit les paramètres de ressource de calcul. (Remplacez les <ESPACES RÉSERVÉS> par vos valeurs.)

az containerapp revision copy \
  --name <APPLICATION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --cpu 0.75 \
  --memory 1.5Gi

az containerapp revision copy `
  --name <APPLICATION_NAME> `
  --resource-group <RESOURCE_GROUP_NAME> `
  --cpu 0.75 `
  --memory 1.5Gi

Revision activate

Activez une révision à l’aide de la commande az containerapp revision activate.

az containerapp revision activate \
  --revision <REVISION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME>

$CmdArgs = @{
  ContainerAppName = '<CONTAINER_APP_NAME>'
  ResourceGroupName = '<RESOURCE_GROUP_NAME>'
  RevisionName = '<REVISION_NAME>'
}

Enable-AzContainerAppRevision @CmdArgs

Revision deactivate

Désactivez les révisions qui ne sont plus utilisées avec la commande az containerapp revision deactivate. La désactivation arrête tous les réplicas en cours d’exécution d’une révision.

az containerapp revision deactivate \
  --revision <REVISION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME>

$CmdArgs = @{
  ContainerAppName = '<CONTAINER_APP_NAME>'
  ResourceGroupName = '<RESOURCE_GROUP_NAME>'
  RevisionName = '<REVISION_NAME>'
}

Disable-AzContainerAppRevision @CmdArgs

Revision restart

La commande az containerapp revision restart redémarre une révision.

Lorsque vous modifiez des secrets dans votre application conteneur, vous devez redémarrer les révisions actives afin qu’elles puissent accéder aux secrets.

az containerapp revision restart \
  --revision <REVISION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME>

$CmdArgs = @{
  ContainerAppName = '<CONTAINER_APP_NAME>'
  ResourceGroupName = '<RESOURCE_GROUP_NAME>'
  RevisionName = '<REVISION_NAME>'
}

Restart-AzContainerAppRevision @CmdArgs

Revision set mode

Le mode de révision contrôle si une ou plusieurs révisions de votre application conteneur peuvent être actives simultanément. Pour définir votre application conteneur pour prendre en charge le mode de révision unique ou le mode de révision multiple, utilisez la commande az containerapp revision set-mode.

Le paramètre par défaut mode de révision unique. Pour plus d'informations sur cette commande, voir az containerapp revision set-mode.

Les valeurs du mode sont single ou multiple. La modification du mode de révision ne crée pas de nouvelle révision.

Exemple : (Remplacez les <ESPACES RÉSERVÉS> par vos valeurs.)

az containerapp revision set-mode \
  --name <APPLICATION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --mode <REVISION_MODE>

$CmdArgs = @{
  Name = '<CONTAINER_APP_NAME>'
  ResourceGroupName = '<RESOURCE_GROUP_NAME>'
  Location = '<LOCATION>'
  ConfigurationActiveRevisionMode = '<REVISION_MODE>'
}

Update-AzContainerApp @CmdArgs

Étiquettes de révision

Les étiquettes fournissent une URL unique que vous pouvez utiliser pour diriger le trafic vers une révision. Vous pouvez déplacer une étiquette entre les révisions pour rediriger le trafic dirigé vers l’URL de l’étiquette vers une autre révision. Pour plus d’informations sur les étiquettes de révision, consultez Étiquettes de révision.

Vous pouvez ajouter et supprimer une étiquette d’une révision. Pour plus d’informations sur les commandes d’étiquette, consultez az containerapp revision label

Ajout d’étiquette de révision

Pour ajouter une étiquette à une révision, utilisez la commande az containerapp revision label add.

Vous ne pouvez attribuer qu’une étiquette à une révision à la fois, et une révision ne peut être affectée qu’à une seule étiquette. Si la révision que vous spécifiez a une étiquette, la commande add remplace l’étiquette existante.

Cet exemple ajoute une étiquette à une révision : (Remplacez les <ESPACES RÉSERVÉS> par vos valeurs.)

az containerapp revision label add \
  --revision <REVISION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --label <LABEL_NAME>

az containerapp revision label add `
  --revision <REVISION_NAME> `
  --resource-group <RESOURCE_GROUP_NAME> `
  --label <LABEL_NAME>

Revision label remove

Pour supprimer une étiquette d’une révision, utilisez la commande az containerapp revision label remove.

Cet exemple supprime une étiquette d’une révision : (Remplacez les <ESPACES RÉSERVÉS> par vos valeurs.)

az containerapp revision label remove \
  --revision <REVISION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --label <LABEL_NAME>

az containerapp revision label remove `
  --revision <REVISION_NAME> `
  --resource-group <RESOURCE_GROUP_NAME> `
  --label <LABEL_NAME>

Fractionnement du trafic

En attribuant des valeurs de pourcentage, vous pouvez choisir comment équilibrer le trafic entre les différentes révisions. Les règles de fractionnement du trafic sont attribuées en définissant des pondérations sur les différentes révisions en utilisant leur nom ou étiquette. Pour plus d’informations, consultez Fractionnement du trafic.

Étapes suivantes

• Révisions dans Azure Container Apps
• Gestion du cycle de vie des applications dans Azure Container Apps