Tutoriel : Exporter et utiliser des modèles de portail Azure

Dans cette série de tutoriels, vous créez un modèle pour déployer un compte de stockage Azure. Dans les deux didacticiels suivants, vous ajoutez un plan App Service et un site web. Au lieu de créer des modèles à partir de zéro, vous allez apprendre à exporter des modèles à partir du portail Azure et comment utiliser des exemples de modèles à partir des modèles de démarrage rapide Azure. Vous personnalisez ces modèles pour votre utilisation. Ce tutoriel se concentre sur l’exportation de modèles et la personnalisation du résultat pour votre modèle. Cette instruction prend 14 minutes .

Prerequisites

Nous vous recommandons de suivre le didacticiel sur les sorties, mais il n’est pas nécessaire.

Vous devez disposer de Visual Studio Code et d’Azure PowerShell ou d’Azure CLI. Pour plus d’informations, consultez les outils de modèle.

Vérifier le modèle

À la fin du didacticiel précédent, votre modèle comportait le fichier JSON suivant :

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "type": "string",
      "minLength": 3,
      "maxLength": 11
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "variables": {
    "uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[variables('uniqueStorageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ],
  "outputs": {
    "storageEndpoint": {
      "type": "object",
      "value": "[reference(variables('uniqueStorageName')).primaryEndpoints]"
    }
  }
}

Ce modèle fonctionne bien pour le déploiement de comptes de stockage, mais vous souhaiterez peut-être y ajouter d’autres ressources. Vous pouvez exporter un modèle à partir d’une ressource existante pour obtenir rapidement le JSON de cette ressource.

Créer un plan App Service

Connectez-vous au portail Azure.
Sélectionnez Créer une ressource.
Dans les services de recherche et la Place de marché, entrez Plan App Service, puis sélectionnez Plan App Service.
Cliquez sur Créer.
Dans la page Créer un plan App Service , entrez les éléments suivants :
- Abonnement : sélectionnez votre abonnement Azure dans le menu déroulant.
- Groupe de ressources : sélectionnez Créer , puis spécifiez un nom. Fournissez un nom de groupe de ressources différent de celui que vous avez utilisé dans cette série de tutoriels.
- Nom : entrez un nom pour le plan App Service.
- Système d’exploitation : sélectionnez Linux.
- Région : sélectionnez un emplacement Azure dans le menu déroulant, par exemple USA Centre.
- Niveau tarifaire : pour économiser des coûts, sélectionnez Modifier la taille pour modifier la référence SKU et la taille en premier de base (B1), sous Dev/Test pour les charges de travail moins exigeantes.
Sélectionnez Examiner et créer.
Cliquez sur Créer. La création de la ressource prend quelques instants.

Exportation du modèle

Sélectionnez Accéder à la ressource.
Dans le menu de gauche, sous Automation, sélectionnez Exporter le modèle.

La fonctionnalité de modèle d’exportation prend l’état actuel d’une ressource et génère un modèle pour le déployer. L’exportation d’un modèle peut être un moyen utile d’obtenir rapidement le JSON dont vous avez besoin pour déployer une ressource.
Examinez la Microsoft.Web/serverfarms définition et la définition de paramètre dans le modèle exporté. Vous n’avez pas besoin de copier ces sections. Vous pouvez simplement utiliser ce modèle exporté comme exemple de la façon dont vous souhaitez ajouter cette ressource à votre modèle.

Important

En règle générale, le modèle exporté est plus détaillé que vous le souhaiterez peut-être lors de la création d’un modèle. L’objet SKU, par exemple, dans le modèle exporté a cinq propriétés. Ce modèle fonctionne, mais vous pouvez simplement utiliser la name propriété. Vous pouvez commencer par le modèle exporté, puis le modifier comme vous le souhaitez pour répondre à vos besoins.

Réviser le modèle existant

Le modèle exporté vous donne la plupart des json dont vous avez besoin, mais vous devez le personnaliser pour votre modèle. Faites attention aux différences entre les paramètres et les variables entre votre modèle et le modèle exporté. Évidemment, le processus d’exportation ne connaît pas les paramètres et variables que vous avez déjà définis dans votre modèle.

L’exemple suivant montre les ajouts à votre modèle. Il contient le code exporté ainsi que quelques modifications. Tout d’abord, il modifie le nom du paramètre pour qu’il corresponde à votre convention d’affectation de noms. Ensuite, il utilise votre paramètre location pour l’emplacement du plan App Service. Troisièmement, il supprime certaines des propriétés où la valeur par défaut est correcte.

Copiez l’intégralité du fichier et remplacez votre modèle par son contenu :

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "type": "string",
      "minLength": 3,
      "maxLength": 11
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    },
    "appServicePlanName": {
      "type": "string",
      "defaultValue": "exampleplan"
    }
  },
  "variables": {
    "uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[variables('uniqueStorageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    },
    {
      "type": "Microsoft.Web/serverfarms",
      "apiVersion": "2025-03-01",
      "name": "[parameters('appServicePlanName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "B1",
        "tier": "Basic",
        "size": "B1",
        "family": "B",
        "capacity": 1
      },
      "kind": "linux",
      "properties": {
        "perSiteScaling": false,
        "reserved": true,
        "targetWorkerCount": 0,
        "targetWorkerSizeId": 0
      }
    }
  ],
  "outputs": {
    "storageEndpoint": {
      "type": "object",
      "value": "[reference(variables('uniqueStorageName')).primaryEndpoints]"
    }
  }
}

Déployer un modèle

Utilisez Azure CLI ou Azure PowerShell pour déployer un modèle.

Si vous n’avez pas créé le groupe de ressources, consultez Créer un groupe de ressources. L’exemple suppose que vous avez défini la templateFile variable sur le chemin d’accès au fichier de modèle, comme indiqué dans le premier tutoriel.

Azure PowerShell
Azure CLI

New-AzResourceGroupDeployment `
  -Name addappserviceplan `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile `
  -storagePrefix "store" `
  -storageSKU Standard_LRS

Pour exécuter cette commande de déploiement, vous devez disposer de la dernière version d’Azure CLI.

az deployment group create \
  --name addappserviceplan \
  --resource-group myResourceGroup \
  --template-file $templateFile \
  --parameters storagePrefix=store storageSKU=Standard_LRS

Note

Si le déploiement échoue, utilisez le verbose commutateur pour obtenir des informations sur les ressources que vous créez. Utilisez ce commutateur debug pour obtenir plus d'informations pour le débogage.

Vérifier le déploiement

Vous pouvez vérifier le déploiement en explorant le groupe de ressources à partir du portail Azure.

Connectez-vous au portail Azure.
Dans le menu de gauche, sélectionnez Groupes de ressources.
Sélectionnez le groupe de ressources sur lequel vous avez déployé.
Le groupe de ressources contient un compte de stockage et un plan App Service.

Nettoyer les ressources

Si vous passez au didacticiel suivant, vous n’avez pas besoin de supprimer le groupe de ressources.

Si vous arrêtez maintenant, vous souhaiterez peut-être supprimer le groupe de ressources.

Dans le portail Azure, sélectionnez Groupes de ressources dans le menu de gauche.
Tapez le nom du groupe de ressources dans le champ de texte filtre pour n’importe quel champ....
Cochez la case en regard de myResourceGroup et sélectionnez myResourceGroup ou votre nom de groupe de ressources.
Sélectionnez Supprimer le groupe de ressources dans le menu supérieur.

Étapes suivantes

Vous avez appris à exporter un modèle à partir du portail Azure et comment utiliser le modèle exporté pour votre développement de modèle. Vous pouvez également utiliser les modèles de démarrage rapide Azure pour simplifier le développement de modèles.

Utiliser des modèles de démarrage rapide Azure

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-10-29