Écriture de modèles ARM

Les modèles ARM vous permettent de définir l'infrastructure Azure sous forme de code au format JSON. Vous pouvez ainsi effectuer des déploiements reproductibles et cohérents, dont le contrôle de version peut être géré avec le code de votre application. Les modèles sont idempotents : l'exécution répétée du même modèle produit le même résultat, ce qui permet de les appliquer à nouveau en toute sécurité après des modifications.

Chaque modèle ARM commence par une propriété $schema qui pointe vers l'URL du schéma du modèle, suivie d'une chaîne contentVersion. Le schéma indique au portail Azure et aux extensions de l'éditeur comment valider votre modèle et fournir IntelliSense. Les cinq sections principales qui suivent sont parameters, variables, functions, resources et outputs.

Les paramètres rendent les modèles réutilisables en acceptant des valeurs d'entrée au moment du déploiement. Chaque paramètre possède un type (string, int, bool, object, array, secureString), un defaultValue facultatif et des allowedValues facultatives pour la validation. L'utilisation de secureString pour les mots de passe garantit que la valeur n'est jamais consignée dans l'historique du déploiement.

Les variables stockent des valeurs calculées à partir de paramètres ou de fonctions du modèle, ce qui réduit les répétitions et facilite la maintenance des modèles. Les variables sont évaluées une seule fois, puis référencées dans toute la section des ressources à l'aide de l'expression [variables('name')]. Une pratique courante consiste à construire un nom de ressource en concaténant un paramètre avec un suffixe unique.

Le tableau resources constitue le cœur d'un modèle ARM. Chaque élément décrit une ressource Azure à l'aide des champs obligatoires suivants : type, apiVersion, name et location. La propriété apiVersion fixe la version du schéma du fournisseur de ressources ; utilisez toujours une version stable récente pour accéder aux dernières fonctionnalités et éviter les propriétés obsolètes.

Les expressions des modèles ARM sont placées entre crochets [...] et prennent en charge des fonctions intégrées pour les chaînes, les tableaux, les objets et les ID de ressources. Parmi les fonctions courantes figurent concat(), resourceGroup(), resourceId(), uniqueString() et parameters(). ARM évalue ces fonctions côté serveur au moment du déploiement, et non localement.

La section outputs définit les valeurs qu'ARM renvoie après un déploiement réussi. Les sorties sont essentielles pour enchaîner les modèles : vous déployez un modèle de réseau et renvoyez l'ID de ressource du sous-réseau, puis vous le transmettez comme paramètre à un modèle de VM. Les sorties peuvent référencer n'importe quelle expression, y compris les propriétés de ressources issues du déploiement.

Pour les architectures complexes, ARM prend en charge les modèles liés (qui référencent des URL de modèles externes) et les modèles imbriqués (qui intègrent un modèle dans le tableau des ressources à l'aide du type Microsoft.Resources/deployments). Vous pouvez ainsi diviser un déploiement d'infrastructure volumineux en éléments modulaires et réutilisables, tout en conservant un seul modèle d'orchestration comme point d'entrée.

Au lieu de transmettre les paramètres sur la ligne de commande, stockez-les dans un fichier de paramètres distinct : un fichier JSON contenant un objet parameters composé de paires nom-valeur. Les fichiers de paramètres peuvent être propres à chaque environnement (par exemple, dev.parameters.json et prod.parameters.json) et être intégrés au contrôle de version, tandis que les valeurs sensibles sont conservées dans des références à Azure Key Vault plutôt qu'en texte brut.

Utilisez la commande Azure CLI az deployment group create pour déployer un modèle dans un groupe de ressources. Avant de déployer en production, exécutez az deployment group validate pour détecter les erreurs de schéma et de logique, puis az deployment group what-if pour prévisualiser les modifications apportées aux ressources. Ces trois commandes constituent un pipeline de déploiement sûr : valider, prévisualiser, déployer.

Suivez ces bonnes pratiques pour les modèles ARM : utilisez des paramètres pour les valeurs propres à l'environnement, utilisez des variables pour éviter les répétitions, figez les versions d'API sur des versions stables, utilisez secureString pour les mots de passe, ajoutez des descriptions de métadonnées aux paramètres et séparez les modèles volumineux en modules liés. Stockez les modèles dans un dépôt Git et déployez-les au moyen d'un pipeline CI/CD pour garantir leur traçabilité.

Vérifiez votre compréhension des concepts Microsoft Azure Fundamentals (AZ-900) abordés dans cette leçon.

Dans cette leçon, vous avez appris que les modèles ARM sont des documents JSON qui définissent de manière déclarative l'infrastructure Azure, que les paramètres et variables rendent les modèles réutilisables et faciles à maintenir, et que le processus validate, what-if, deploy permet des déploiements sûrs et reproductibles. Nous allons maintenant découvrir Bicep, une abstraction moderne du code JSON ARM.