Démarrage rapide : Créer un registre connecté à l’aide d’Azure CLI ou du portail Azure

• Azure Container Registry : si vous n’avez pas encore de registre de conteneurs, créez-en un (niveau Premium requis) dans une région qui prend en charge les registres connectés.

Pour importer des images dans le registre de conteneurs, utilisez Azure CLI

• Utilisez l’environnement Bash dans Azure Cloud Shell. Pour obtenir plus d’informations, consultez Démarrage d’Azure Cloud Shell.

  

• Si vous préférez exécuter des commandes de référence CLI localement, installez Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Comment exécuter Azure CLI dans un conteneur Docker.

  • Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour terminer le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour obtenir d’autres options de connexion, consultez S’authentifier auprès d’Azure à l’aide d’Azure CLI.

  • Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser et gérer des extensions avec Azure CLI.

  • Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.

• Azure Container Registry : si vous n’avez pas encore de registre de conteneurs, créez-en un (niveau Premium requis) dans une région qui prend en charge les registres connectés.

• Utilisez l’environnement Bash dans Azure Cloud Shell. Pour obtenir plus d’informations, consultez Démarrage d’Azure Cloud Shell.

  

• Si vous préférez exécuter des commandes de référence CLI localement, installez Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Comment exécuter Azure CLI dans un conteneur Docker.

  • Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour terminer le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour obtenir d’autres options de connexion, consultez S’authentifier auprès d’Azure à l’aide d’Azure CLI.

  • Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser et gérer des extensions avec Azure CLI.

  • Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.

Activez le point de terminaison de données dédié pour le registre de conteneurs Azure dans le cloud. Cette étape est nécessaire pour qu’un registre connecté communique avec le registre cloud.

1. Dans le portail Azure, accédez à votre registre de conteneurs.
2. Sélectionnez Accès public réseau>. Cochez la case Activer le point de terminaison de données dédié .
3. Cliquez sur Enregistrer.

Activez le point de terminaison de données dédié pour le registre de conteneurs Azure dans le cloud à l’aide de la commande az acr update . Cette étape est nécessaire pour qu’un registre connecté communique avec le registre cloud.

# Set the REGISTRY_NAME environment variable to identify the existing cloud registry
REGISTRY_NAME=<container-registry-name>

az acr update --name $REGISTRY_NAME \
  --data-endpoint-enabled

Les étapes suivantes créent un registre connecté en mode ReadWrite lié au registre cloud.

1. Dans le portail Azure, accédez à votre registre de conteneurs.
2. Sélectionnez Registres connectés (préversion) > + Créer.
3. Entrez ou sélectionnez les valeurs dans le tableau suivant, puis sélectionnez Enregistrer.

Vous pouvez également utiliser la commande az acr connected-registry create pour créer un registre connecté avec des fonctionnalités en lecture seule.

# Set the CONNECTED_REGISTRY_READ environment variable to provide a name for the connected registry with read-only functionality
CONNECTED_REGISTRY_RO=<connnected-registry-name>
az acr connected-registry create --registry $REGISTRY_NAME \
  --parent $CONNECTED_REGISTRY_RW \
  --name $CONNECTED_REGISTRY_RO \
  --repository "hello-world" "acr/connected-registry" \
  --mode ReadOnly

Cette commande crée une ressource de Registre connectée dont le nom est la valeur de $CONNECTED_REGISTRY_RO et le lie au registre cloud nommé avec la valeur de $REGISTRY_NAME.

• Les référentiels spécifiés sont synchronisés entre le registre parent nommé avec la valeur de $CONNECTED_REGISTRY_RW et le registre connecté une fois déployé.
• La ressource est créée en mode ReadOnly, qui active la fonctionnalité d’extraction en lecture seule (pull d’artefact) une fois déployée.
• Les référentiels sont synchronisés entre le Registre parent et le Registre connecté sans interruption, car il n’existe aucune planification de synchronisation définie pour ce Registre connecté.

Les étapes suivantes créent un registre connecté en mode ReadOnly dont le parent est le registre connecté que vous avez créé dans la section précédente. Ce Registre connecté active les fonctionnalités en lecture seule (extraction d’artefact) une fois déployées.

1. Dans le portail Azure, accédez à votre registre de conteneurs.
2. Sélectionnez Registres connectés (préversion) > + Créer.
3. Entrez ou sélectionnez les valeurs dans le tableau suivant, puis sélectionnez Enregistrer.

Vous pouvez également utiliser la commande az acr connected-registry create pour créer un registre connecté avec des fonctionnalités en lecture seule.

# Set the CONNECTED_REGISTRY_READ environment variable to provide a name for the connected registry with read-only functionality
CONNECTED_REGISTRY_RO=<connnected-registry-name>
az acr connected-registry create --registry $REGISTRY_NAME \
  --parent $CONNECTED_REGISTRY_RW \
  --name $CONNECTED_REGISTRY_RO \
  --repository "hello-world" "acr/connected-registry" \
  --mode ReadOnly

Cette commande crée une ressource de Registre connectée dont le nom est la valeur de $CONNECTED_REGISTRY_RO et le lie au registre cloud nommé avec la valeur de $REGISTRY_NAME.

• Les référentiels spécifiés sont synchronisés entre le registre parent nommé avec la valeur de $CONNECTED_REGISTRY_RW et le registre connecté une fois déployé.
• La ressource est créée en mode ReadOnly, qui active la fonctionnalité d’extraction en lecture seule (pull d’artefact) une fois déployée.
• Les référentiels sont synchronisés entre le Registre parent et le Registre connecté sans interruption, car il n’existe aucune planification de synchronisation définie pour ce Registre connecté.

Sélectionnez un registre connecté dans le portail pour afficher ses propriétés, telles que son état de connexion (hors connexion, en ligne ou non sain) et s’il est activé (déployé localement). Dans l’exemple suivant, le Registre connecté n’est pas déployé. L’état de connexion « Hors connexion » indique qu’il est déconnecté du cloud.

À partir de cette vue, vous pouvez également générer une chaîne de connexion et éventuellement générer des mots de passe pour le jeton de synchronisation. Une chaîne de connexion contient des paramètres de configuration utilisés pour déployer un registre connecté et synchroniser du contenu avec un registre parent.

Vous pouvez utiliser la commande az acr connected-registry list pour vérifier que les ressources sont créées.

az acr connected-registry list \
  --registry $REGISTRY_NAME \
  --output table

Vous devez voir une réponse comme suit. Étant donné que les registres connectés ne sont pas encore déployés, l’état de connexion « Hors connexion » indique qu’ils sont actuellement déconnectés du cloud.

NAME                 MODE        CONNECTION STATE    PARENT               LOGIN SERVER    LAST SYNC (UTC)
-------------------  --------    ------------------  -------------------  --------------  -----------------
myconnectedregrw    ReadWrite    Offline
myconnectedregro    ReadOnly     Offline             myconnectedregrw