Démarrage rapide : Créer un registre de conteneurs géorépliqué à l’aide d’un modèle Resource Manager
Ce guide de démarrage rapide montre comment créer une instance Azure Container Registry à l’aide d’un modèle Resource Manager (Azure Resource Manager). Le modèle configure un registre géorépliqué, qui synchronise automatiquement le contenu du registre entre plusieurs régions Azure. La géoréplication permet un accès aux images à proximité du réseau à partir de déploiements régionaux, tout en offrant une expérience de gestion unique. Il s’agit d’une caractéristique du niveau de service de registre Premium.
Un modèle Azure Resource Manager est un fichier JSON (JavaScript Object Notation) qui définit l’infrastructure et la configuration de votre projet. Le modèle utilise la syntaxe déclarative. Vous décrivez votre déploiement prévu sans écrire la séquence de commandes de programmation pour créer le déploiement.
Le Registre avec réplications ne prend pas en charge les déploiements en mode Complet de modèle ARM/Bicep.
Si votre environnement remplit les prérequis et que vous êtes déjà familiarisé avec l’utilisation des modèles ARM, sélectionnez le bouton Déployer sur Azure. Le modèle s’ouvre dans le portail Azure.
Prérequis
Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.
Vérifier le modèle
Le modèle utilisé dans ce démarrage rapide est tiré des modèles de démarrage rapide Azure. Le modèle configure un registre et un réplica régional supplémentaire.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"metadata": {
"_generator": {
"name": "bicep",
"version": "0.5.6.12127",
"templateHash": "12610175857982700190"
}
},
"parameters": {
"acrName": {
"type": "string",
"defaultValue": "[format('acr{0}', uniqueString(resourceGroup().id))]",
"maxLength": 50,
"minLength": 5,
"metadata": {
"description": "Globally unique name of your Azure Container Registry"
}
},
"acrAdminUserEnabled": {
"type": "bool",
"defaultValue": false,
"metadata": {
"description": "Enable admin user that has push / pull permission to the registry."
}
},
"location": {
"type": "string",
"defaultValue": "[resourceGroup().location]",
"metadata": {
"description": "Location for registry home replica."
}
},
"acrSku": {
"type": "string",
"defaultValue": "Premium",
"allowedValues": [
"Premium"
],
"metadata": {
"description": "Tier of your Azure Container Registry. Geo-replication requires Premium SKU."
}
},
"acrReplicaLocation": {
"type": "string",
"metadata": {
"description": "Short name for registry replica location."
}
}
},
"resources": [
{
"type": "Microsoft.ContainerRegistry/registries",
"apiVersion": "2019-12-01-preview",
"name": "[parameters('acrName')]",
"location": "[parameters('location')]",
"sku": {
"name": "[parameters('acrSku')]"
},
"tags": {
"displayName": "Container Registry",
"container.registry": "[parameters('acrName')]"
},
"properties": {
"adminUserEnabled": "[parameters('acrAdminUserEnabled')]"
}
},
{
"type": "Microsoft.ContainerRegistry/registries/replications",
"apiVersion": "2019-12-01-preview",
"name": "[format('{0}/{1}', parameters('acrName'), parameters('acrReplicaLocation'))]",
"location": "[parameters('acrReplicaLocation')]",
"properties": {},
"dependsOn": [
"[resourceId('Microsoft.ContainerRegistry/registries', parameters('acrName'))]"
]
}
],
"outputs": {
"acrLoginServer": {
"type": "string",
"value": "[reference(resourceId('Microsoft.ContainerRegistry/registries', parameters('acrName'))).loginServer]"
}
}
}
Les ressources suivantes sont définies dans le modèle :
- Microsoft.ContainerRegistry/registries : création d’un registre de conteneurs Azure
- Microsoft.ContainerRegistry/registries/replications : création d’un réplica de registre de conteneurs
Vous trouverez d’autres exemples de modèles Azure Container Registry dans la galerie de modèles de démarrage rapide.
Déployer le modèle
Cliquez sur l’image ci-après pour vous connecter à Azure et ouvrir un modèle.
Sélectionnez ou entrez les valeurs suivantes.
Abonnement : sélectionnez un abonnement Azure.
Groupe de ressources : sélectionnez Créer, entrez un nom unique pour le groupe de ressources, puis sélectionnez OK.
Région : sélectionnez un emplacement pour le groupe de ressources. Exemple : USA Centre.
Nom d’ACR : acceptez le nom généré pour le registre ou entrez un nom. Il doit être globalement unique.
Utilisateur administrateur ACR activé : acceptez la valeur par défaut.
Emplacement : acceptez l’emplacement généré pour le réplica de base du registre ou entrez un emplacement comme USA Centre.
Référence SKU ACR : acceptez la valeur par défaut.
Emplacement du réplica d’ACR : entrez un emplacement pour le réplica du registre en utilisant le nom abrégé de la région. Il doit être différent de l’emplacement du registre de base. Exemple : Europe Ouest.
Sélectionnez Vérifier + créer, puis passez en revue les conditions générales. Si vous acceptez, sélectionnez Créer.
Une fois le registre créé avec succès, vous recevez une notification :
Le portail Azure est utilisé pour déployer le modèle. Outre le portail Azure, vous pouvez utiliser Azure PowerShell, l’interface Azure CLI et l’API REST. Pour découvrir d’autres méthodes de déploiement, consultez Déployer des modèles.
Vérifier les ressources déployées
Utilisez le portail Azure ou un outil tel que l’interface de ligne de commande Azure pour passer en revue les propriétés du registre de conteneurs.
Dans le portail, recherchez Registres de conteneurs, puis sélectionnez le registre de conteneurs que vous avez créé.
Sur la page Vue d’ensemble, notez le serveur de connexion du registre. Utilisez cet URI quand vous utilisez Docker pour étiqueter et envoyer (push) des images à votre registre. Pour plus d’informations,consultez Transmettre votre première image à l’aide de l’interface de ligne de commande (CLI) Docker.
Sur la page Réplications, vérifiez les emplacements du réplica de base et du réplica ajouté par le biais du modèle. Si vous le souhaitez, ajoutez des réplicas sur cette page.
Nettoyer les ressources
Supprimez le groupe de ressources, le registre et le réplica de registre quand vous n’en avez plus besoin. Pour ce faire, sélectionnez le groupe de ressources qui contient le registre dans le portail Azure, puis sélectionnez Supprimer le groupe de ressources.
Étapes suivantes
Dans le cadre de ce guide de démarrage rapide, vous avez créé un registre Azure Container Registry avec un modèle Resource Manager et vous avez configuré un réplica de registre dans un autre emplacement. Passez à présent au tutoriel sur Azure Container Registry (ACR) pour approfondir vos connaissances.
Pour obtenir un tutoriel pas à pas vous guidant tout au long du processus de création d’un modèle, consultez :
Créer et déployer votre premier modèle Resource Manager[