Tutoriel : Utiliser les informations de référence sur le modèle ARM

Découvrez comment trouver les informations concernant le schéma de modèle et vous en servir pour créer des modèles Azure Resource Manager (modèles ARM).

Dans ce tutoriel, vous utiliserez un modèle de base issu des modèles de démarrage rapide Azure. Vous allez valider le modèle en vous appuyant sur la documentation de référence du modèle.

Ce tutoriel décrit les tâches suivantes :

• Ouvrir un modèle de démarrage rapide
• Comprendre le modèle
• Trouver la référence du modèle
• Modifier le modèle
• Déployer le modèle

Si vous ne disposez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

Prérequis

Pour effectuer ce qui est décrit dans cet article, vous avez besoin des éléments suivants :

• Visual Studio Code avec l’extension Outils Resource Manager. Consultez Démarrage rapide : Créer des modèles ARM avec Visual Studio Code.

Ouvrir un modèle de démarrage rapide

Modèles de démarrage rapide Azure est un référentiel de modèles ARM. Au lieu de créer un modèle à partir de zéro, vous pouvez chercher un exemple de modèle et le personnaliser. Le modèle utilisé dans ce démarrage rapide se nomme Créer un compte de stockage standard. Le modèle définit une ressource de compte de stockage Azure.

1. À partir de Visual Studio Code, sélectionnez Fichier>Ouvrir un fichier.

2. Collez l’URL suivante dans Nom de fichier :

   https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json
   

3. Sélectionnez Ouvrir pour ouvrir le fichier.

4. Sélectionnez Fichier>Enregistrer sous pour enregistrer le fichier sous le nom azuredeploy.json sur votre ordinateur local.

Comprendre le schéma

1. Dans Visual Studio Code, réduisez le modèle jusqu’au niveau de la racine. Vous avez la structure la plus simple avec les éléments suivants :

   

   • $schema : spécifiez l’emplacement du fichier de schéma JSON qui décrit la version du langage du modèle.
   • contentVersion : spécifiez n’importe quelle valeur pour que cet élément documente les modifications importantes dans votre modèle.
   • metadata : spécifiez les métadonnées du modèle.
   • parameters : spécifiez les valeurs fournies lors de l'exécution du déploiement pour personnaliser le déploiement des ressources.
   • variables : spécifiez les valeurs utilisées en tant que fragments JSON dans le modèle pour simplifier les expressions du langage du modèle. Ce modèle ne contient pas cet élément.
   • resources : spécifiez les types de ressource déployés ou mis à jour dans un groupe de ressources.
   • outputs : spécifiez les valeurs retournées après le déploiement.

2. Développez resources. Une ressource Microsoft.Storage/storageAccounts est définie. La version de l’API affichée sur la capture d’écran est 2022-09-01. Le nom de la référence SKU utilise une valeur de paramètre. Le paramètre est appelé storageAccountType.

   

3. Développez la section parameters pour voir la définition de storageAccountType. Le paramètre a huit valeurs autorisées.

Avec la référence du modèle, vous pouvez déterminer si vous utilisez la dernière version de l’API et si la définition du paramètre comprend toutes les valeurs autorisées.

Trouver la référence du modèle

1. Accédez à la documentation de référence du modèle Azure.

2. Dans la zone Filtrer par titre, entrez comptes de stockage, puis sélectionnez la première occurrence de Comptes de stockage sous Informations de référence > Stockage.

   

3. Sélectionner le modèle ARM.

4. Un type de ressource présente généralement plusieurs versions d’API. Cette page affiche la dernière version du schéma de modèle par défaut. Sélectionnez la zone de liste déroulante la plus récente pour afficher les versions. La dernière version affichée sur la capture d’écran est 2022-09-01. Sélectionnez la version la plus récente ou la version immédiatement sous la version la plus récente pour afficher la dernière version. Assurez-vous que cette version correspond à la version utilisée pour la ressource de compte de stockage dans votre modèle. Si vous mettez à jour la version de l’API, vérifiez que la définition de ressource correspond à la référence de modèle.

   

5. Cette page liste les détails du type de ressource storageAccount. Par exemple, elle présente les valeurs autorisées pour l’objet Sku. Il existe huit références SKU et elles correspondent à celles listées dans le modèle de démarrage rapide que vous avez ouvert précédemment.

   

Déployer le modèle

1. Se connecter à Azure Cloud Shell

2. Choisissez votre environnement préféré en sélectionnant PowerShell ou Bash (pour CLI) en haut à gauche. Il est nécessaire de redémarrer l’interpréteur de commandes lors d’un tel changement.

   

3. Sélectionnez Charger/Télécharger des fichiers, puis Charger. Consultez la capture d’écran précédente. Sélectionnez le fichier que vous avez enregistré dans la section précédente. Après avoir chargé le fichier, vous pouvez utiliser la commande ls et la commande cat pour vérifier que le chargement a été correctement effectué.

4. Dans le Cloud Shell, exécutez les commandes suivantes. Sélectionnez l’onglet pour afficher le code PowerShell ou CLI.

   Au moment de déployer le modèle, spécifiez le paramètre storageAccountType avec une valeur nouvellement ajoutée, par exemple Standard_RAGRS. Si vous utilisez le modèle de démarrage rapide d’origine, le déploiement échoue car Standard_RAGRS n’était pas une valeur autorisée.

   INTERFACE DE LIGNE DE COMMANDE

   echo "Enter a project name that is used to generate resource group name:" &&
   read projectName &&
   echo "Enter the location (i.e. centralus):" &&
   read location &&
   resourceGroupName="${projectName}rg" &&
   az group create --name $resourceGroupName --location "$location" &&
   az deployment group create --resource-group $resourceGroupName --template-file "$HOME/azuredeploy.json" --parameters storageAccountType='Standard_RAGRS'
   

   PowerShell

   $projectName = Read-Host -Prompt "Enter a project name that is used to generate resource group name"
   $location = Read-Host -Prompt "Enter the location (i.e. centralus)"
   $resourceGroupName = "${projectName}rg"
   
   New-AzResourceGroup -Name $resourceGroupName -Location "$location"
   New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateFile "$HOME/azuredeploy.json" -storageAccountType "Standard_RAGRS"
   

Nettoyer les ressources

Lorsque vous n’en avez plus besoin, nettoyez les ressources Azure que vous avez déployées en supprimant le groupe de ressources.

1. Dans le portail Azure, sélectionnez Groupe de ressources dans le menu de gauche.
2. Entrez le nom du groupe de ressources dans le champ Filtrer par nom.
3. Sélectionnez le nom du groupe de ressources. Vous devriez voir six ressources au total dans le groupe de ressources.
4. Sélectionnez Supprimer le groupe de ressources dans le menu supérieur.

Étapes suivantes

Dans ce didacticiel, vous avez appris à utiliser la référence de modèle pour personnaliser un modèle existant. Pour apprendre à créer plusieurs instances de compte de stockage, voir :

Créer plusieurs instances