Partager via

Diffusion en continu d’artefacts dans Azure Container Registry (préversion)

  • Article

La diffusion en continu d’artefacts est une fonctionnalité d’Azure Container Registry qui vous permet de stocker des images conteneur dans un registre unique, de gérer et de diffuser en continu les images conteneur vers des clusters Azure Kubernetes Service (AKS) dans plusieurs régions. Cette fonctionnalité est conçue pour accélérer les charges de travail conteneurisées pour les clients Azure utilisant AKS. Avec la diffusion en continu d’artefacts, vous pouvez facilement mettre à l’échelle des charges de travail sans avoir à attendre des temps d’extraction lents pour votre nœud.

Cas d’utilisation

Voici quelques scénarios pour utiliser la diffusion en continu d’artefacts :

Déploiement d’applications conteneurisées dans plusieurs régions: avec la diffusion en continu d’artefacts, vous pouvez stocker des images conteneur dans un registre unique et gérer et diffuser en continu des images conteneur vers des clusters AKS dans plusieurs régions. La diffusion en continu d’artefacts déploie des applications conteneur dans plusieurs régions sans prendre beaucoup de temps et de ressources.

Réduction de la latence d’extraction d’images: La diffusion en continu d’artefacts peut réduire le temps de préparation des pods de plus de 15 %, en fonction de la taille de l’image, et fonctionne de manière optimale pour les images < de 30 Go. Cette fonctionnalité réduit la latence d’extraction d’images et le démarrage rapide du conteneur, ce qui est bénéfique pour les développeurs de logiciels et les architectes système.

Mise à l’échelle efficace des applications conteneurisées : la diffusion en continu d’artefacts offre la possibilité de concevoir, de générer et de déployer des applications conteneurisées à grande échelle.

Aspects de la diffusion en continu d’artefacts

Voici quelques aspects brefs de la diffusion en continu d’artefacts :

  • Les clients disposant de registres nouveaux et existants peuvent démarrer la diffusion en continu d’artefacts pour des référentiels ou des balises spécifiques.

  • Les clients peuvent stocker à la fois l’artefact d’origine et l’artefact de diffusion en continu dans l’ACR en démarrant la diffusion en continu d’artefacts.

  • Les clients ont accès à l’artefact d’origine et de diffusion en continu, même après avoir désactivé la diffuser en continu d’artefacts pour les référentiels ou les artefacts.

  • Les clients ayant activé la diffusion en continu d’artefacts et la suppression réversible suppriment un référentiel ou un artefact, puis les versions de diffusion en continu d’artefact et d’origine sont supprimées. Toutefois, seule la version d’origine est disponible dans le portail de suppression réversible.

Informations de disponibilité et de tarification

La diffusion en continu d’artefacts est disponible seulement dans les niveaux de service (également appelés références SKU) Premium. La diffusion en continu d’artefacts peut potentiellement augmenter la consommation globale du stockage du registre. Les clients sont soumis à davantage de frais de stockage comme indiqué dans notre tarification si la consommation dépasse le seuil de référence SKU Premium de 500 Gio inclus.

Limitations de la version préliminaire

La diffusion en continu d’artefacts est actuellement en préversion. Les restrictions suivantes s’appliquent :

  • Seules les images avec l’architecture AMD64 Linux sont prises en charge dans la préversion.
  • La préversion ne prend pas en charge les images conteneur Windows ni les images ARM64.
  • La préversion prend partiellement en charge les images multi-architectures. Seule l’architecture AMD64 est prise en charge.
  • Pour créer des pools de nœuds Ubuntu dans AKS, choisissez Ubuntu version 20.04 ou ultérieure.
  • Pour Kubernetes, utilisez Kubernetes version 1.26 ou ultérieure ou Kubernetes version > 1.25.
  • Seuls les registres de référence SKU Premium prennent en charge la génération de diffusion en continu d’artefacts dans la préversion. Les registres de référence SKU non premium ne proposent pas cette fonctionnalité pendant la préversion.
  • Les registres CMK (Customer-Managed Keys) ne sont PAS pris en charge dans la préversion.
  • Le regcred de Kubernetes n’est actuellement PAS pris en charge.

Prérequis

  • Pour exécuter les exemples de commandes fournis dans cet article, vous pouvez utiliser Azure Cloud Shell ou une installation locale d’Azure CLI. Si vous souhaitez l’utiliser localement, la version 2.54.0 ou ultérieure est nécessaire. Exécutez az --version pour trouver la version. Si vous devez installer ou mettre à niveau, voir Installer Azure CLI.

  • Connectez-vous au portail Azure.

Démarrer la diffusion en continu d’artefacts

Démarrez la diffusion en continu d’artefacts en série avec les commandes Azure CLI pour l’envoi (push), l’importation et la génération d’artefacts de diffusion en continu pour les images conteneur dans Azure Container Registry (ACR). Ces instructions décrivent le processus de création d’un ACR de référence SKU Premium, l’importation d’une image, la génération d’un artefact de diffusion en continu et la gestion de l’opération de diffusion en continu d’artefacts. Veillez à remplacer les espaces réservés par vos valeurs réelles là où c’est nécessaire.

Envoyer/importer l’image et générer l’artefact de streaming – Azure CLI

La diffusion en continu d’artefacts est disponible seulement au niveau Premium du service de registre de conteneurs. Pour démarrer la diffusion en continu d’artefacts, mettez à jour un registre en utilisant Azure CLI (version 2.54.0 ou ultérieure). Pour installer ou mettre à niveau Azure CLI, consultez Installer Azure CLI.

Démarrez la diffusion en continu d’artefacts en effectuant ces grandes étapes :

Remarque

Si vous avez déjà un registre de conteneurs Premium, vous pouvez ignorer cette étape. Si l’utilisateur est sur des références SKU De base ou Standard, les commandes suivantes échouent. Le code est écrit dans Azure CLI et peut être exécuté en mode interactif. Notez que les espaces réservés doivent être remplacés par des valeurs réelles avant d’exécuter la commande.

  1. Créez un registre de conteneurs Azure (ACR) à l’aide de la référence SKU Premium via :

    Par exemple, exécutez la commande az group create pour créer un groupe de ressources Azure avec le nom my-streaming-test dans la région USA Ouest, puis exécutez la commande az acr create pour créer un Registre de conteneurs Azure Premium avec le nom mystreamingtest dans ce groupe de ressources.

    az group create -n my-streaming-test -l westus
az acr create -n mystreamingtest -g my-streaming-test -l westus --sku premium

  2. Envoyez ou importez une image dans le Registre via :

    Par exemple, exécutez la commande [az configure] pour configurer le ACR par défaut et la commande az acr import pour importer une image Jupyter Notebook à partir de Docker Hub dans l’ACR mystreamingtest.

    az configure --defaults acr="mystreamingtest"
az acr import --source docker.io/jupyter/all-spark-notebook:latest -t jupyter/all-spark-notebook:latest

  3. Créer une diffusion en continu d’artefacts à partir de l’image

    Lance la création d’un artefact de diffusion en continu à partir de l’image spécifiée.

    Par exemple, exécutez les commandes az acr artifact-streaming create pour créer un artefact de streaming à partir de l’image jupyter/all-spark-notebook:latest dans l’ACR mystreamingtest.

    az acr artifact-streaming create --image jupyter/all-spark-notebook:latest

Remarque

Un ID d’opération est généré pendant le processus de référence ultérieure pour vérifier l’état de l’opération.

  1. Vérifiez la diffusion en continu d’artefacts générée dans Azure CLI.

    Par exemple, exécutez la commande az acr manifest list-referrers pour répertorier les artefacts de diffusion en continu de l’image jupyter/all-spark-notebook:latest dans l’ACR mystreamingtest.

    az acr manifest list-referrers -n jupyter/all-spark-notebook:latest

  2. Annuler la création de diffusion en continu d’artefacts (si nécessaire)

    Annulez la création de l’artefact de diffusion en continu si la conversion n’est pas encore terminée. Cela arrête l'opération.

    Par exemple, exécutez la commande az acr artifact-streaming operation cancel pour annuler l’opération de conversion de l’image jupyter/all-spark-notebook:latest dans l’ACR mystreamingtest.

    az acr artifact-streaming operation cancel --repository jupyter/all-spark-notebook --id c015067a-7463-4a5a-9168-3b17dbe42ca3

  3. Démarrer la mise à jour automatique sur le référentiel

    Démarrez la conversion automatique dans le référentiel pour des images nouvellement envoyées ou importées. Quand elle a démarré, les nouvelles images envoyées dans ce référentiel déclenchent la génération d’artefacts de diffusion en continu.

    Remarque

    La conversion automatique ne s’applique pas aux images existantes. Les images existantes peuvent être converties manuellement.

    Par exemple, exécutez la commande az acr artifact-streaming update pour démarrer la conversion automatique pour le référentiel jupyter/all-spark-notebook dans l’ACR mystreamingtest.

    az acr artifact-streaming update --repository jupyter/all-spark-notebook --enable-streaming true

  4. Vérifiez la progression de la conversion de diffusion en continu, après avoir envoyé une nouvelle image jupyter/all-spark-notebook:newtag au référentiel ci-dessus.

    Par exemple, exécutez la commande az acr artifact-streaming operation show pour vérifier l’état de l’opération de conversion de l’image jupyter/all-spark-notebook:newtag dans l’ACR mystreamingtest.

    az acr artifact-streaming operation show --image jupyter/all-spark-notebook:newtag

  5. Une fois que vous avez vérifié l’état de conversion, vous pouvez maintenant vous connecter à AKS. Reportez-vous à la documentation AKS.

  6. Désactivez l’artefact de diffusion en continu à partir du référentiel.

    Par exemple, exécutez la commande az acr artifact-streaming update pour supprimer l’artefact de diffusion en continu de l’image jupyter/all-spark-notebook:latest dans l’ACR mystreamingtest.

    az acr artifact-streaming update --repository jupyter/all-spark-notebook --enable-streaming false

Remarque

La diffusion en continu d’artefacts peut fonctionner dans plusieurs régions, que la géoréplication ait ou non démarré. La diffusion en continu d’artefacts peut fonctionner via un point de terminaison privé et s’y attacher.

Envoyer (push)/importer l’image et générer l’artefact de diffusion en continu – Portail Azure

La diffusion en continu d’artefacts est disponible dans la référence SKU Premium d’Azure Container Registry. Pour démarrer la diffusion en continu d’artefacts, actualisez un registre à l’aide du portail Azure.

Suivez les étapes pour créer une diffusion en continu d’artefacts dans le portail Azure.

  1. Accédez à votre registre de conteneurs Azure.

  2. Dans le menu latéral, sous Services, sélectionnez Référentiels.

  3. Sélectionnez la dernière image importée.

  4. Convertissez l’image et créez la diffusion en continu d’artefacts dans le Portail Azure.

    Une capture d’écran du portail Azure avec le bouton créer un artefact de streaming mis en surbrillance.

  5. Vérifiez l’artefact de diffusion en continu généré à partir de l’image dans l’onglet Référents.

    Une capture d’écran du portail Azure avec l’artefact de streaming mis en surbrillance.

  6. Vous pouvez également supprimer la diffusion en continu d’artefacts du référentiel.

    Une capture d’écran du portail Azure avec le bouton supprimer le streaming d’artefact mis en surbrillance.

  7. Vous pouvez également activer la conversion automatique en accédant au référentiel sur le portail. Activée signifie que la conversion automatique est activée sur le référentiel. Inactive signifie que la conversion automatique est désactivée sur le référentiel.

    Une capture d’écran du portail Azure avec le bouton démarrer le streaming d’artefact mis en surbrillance.

Remarque

L’état de la diffusion en continu d’artefacts dans un référentiel (inactif ou actif) détermine si les images compatibles nouvellement envoyées seront automatiquement converties. Par défaut, tous les référentiels sont dans un état inactif pour la diffusion en continu d’artefacts. Cela signifie que lorsque de nouvelles images compatibles sont envoyées au référentiel, la diffusion en continu d’artefacts ne sera pas déclenchée et les images ne seront pas automatiquement converties. Si vous souhaitez démarrer la conversion automatique d’images récemment envoyées, vous devez définir la diffusion en continu d’artefacts du référentiel sur l’état actif. Une fois que le référentiel est dans l’état actif, toutes les nouvelles images conteneur compatibles envoyées au référentiel déclenchent la diffusion en continu d’artefacts. Cela démarre la conversion automatique de ces images.

Étapes suivantes

Résoudre les problèmes de diffusion en continu d’artefacts