Tutoriel : Déployer une spec de modèle en tant que modèle lié

Découvrez comment déployer une spec de modèle existante à l’aide d’un déploiement lié. Les specs de modèle permettent de partager des modèles ARM avec d’autres utilisateurs de votre organisation. Une fois que vous avez créé une spec de modèle, vous pouvez la déployer à l’aide d’Azure PowerShell ou Azure CLI. Vous pouvez également déployer la spec de modèle dans le cadre de votre solution à l’aide d’un modèle lié.

Prérequis

Compte Azure avec un abonnement actif. Créez un compte gratuitement.

Notes

Pour utiliser la spec de modèle avec Azure PowerShell, vous devez installer la version 5.0.0 ou ultérieure. Pour l’utiliser avec l’interface de ligne de commande Azure CLI, utilisez la version 2.14.2 ou ultérieure.

Créer une spec de modèle

Consultez Démarrage rapide : Créer et déployer une spec de modèle pour créer une spec de modèle pour le déploiement d’un compte de stockage. Vous avez besoin du nom du groupe de ressources de la spec de modèle, du nom de la spec de modèle et de la version de la spec de modèle dans la section suivante.

Créer le modèle principal

Pour déployer une spec de modèle dans un modèle Resource Manager, ajoutez une ressource de déploiement à votre modèle principal. Dans la propriété templateLink, spécifiez l’ID de ressource d’une spec de modèle. Créez un modèle avec le code JSON suivant appelé azuredeploy.json. Ce tutoriel part du principe que vous avez enregistré sous le chemin d’accès c:\Templates\deployTS\azuredeploy.json, mais vous pouvez utiliser n’importe quel chemin.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    },
    "tsResourceGroup":{
      "type": "string",
      "metadata": {
        "Description": "Specifies the resource group name of the template spec."
      }
    },
    "tsName": {
      "type": "string",
      "metadata": {
        "Description": "Specifies the name of the template spec."
      }
    },
    "tsVersion": {
      "type": "string",
      "defaultValue": "1.0.0.0",
      "metadata": {
        "Description": "Specifies the version the template spec."
      }
    },
    "storageAccountType": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "metadata": {
        "Description": "Specifies the storage account type required by the template spec."
      }
    }
  },
  "variables": {
    "appServicePlanName": "[concat('plan', uniquestring(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Web/serverfarms",
      "apiVersion": "2016-09-01",
      "name": "[variables('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
      }
    },
    {
      "type": "Microsoft.Resources/deployments",
      "apiVersion": "2020-10-01",
      "name": "createStorage",
      "properties": {
        "mode": "Incremental",
        "templateLink": {
          "id": "[resourceId(parameters('tsResourceGroup'), 'Microsoft.Resources/templateSpecs/versions', parameters('tsName'), parameters('tsVersion'))]"
        },
        "parameters": {
          "storageAccountType": {
            "value": "[parameters('storageAccountType')]"
          }
        }
      }
    }
  ],
  "outputs": {
    "templateSpecId": {
      "type": "string",
      "value": "[resourceId(parameters('tsResourceGroup'), 'Microsoft.Resources/templateSpecs/versions', parameters('tsName'), parameters('tsVersion'))]"
    }
  }
}

L’ID de spec de modèle est généré à l’aide de la fonction resourceID(). L’argument de groupe de ressources dans la fonction resourceID() est facultatif si le templateSpec se trouve dans le même groupe de ressources que le déploiement actuel. Vous pouvez également transmettre directement l’ID de ressource en tant que paramètre. Pour récupérer l’ID, utilisez :

PowerShell

$id = (Get-AzTemplateSpec -ResourceGroupName $resourceGroupName -Name $templateSpecName -Version $templateSpecVersion).Versions.Id

INTERFACE DE LIGNE DE COMMANDE

id = $(az ts show --name $templateSpecName --resource-group $resourceGroupName --version $templateSpecVersion --query "id")

Notes

Il existe un problème connu lié à l’obtention de l’ID de la spec de modèle et à son affectation à une variable dans Windows PowerShell.

La syntaxe permettant de transmettre des paramètres à la spec de modèle est la suivante :

"parameters": {
  "storageAccountType": {
    "value": "[parameters('storageAccountType')]"
  }
}

Notes

La valeur apiVersion de Microsoft.Resources/deployments doit être 2020-06-01 ou une version ultérieure.

Déployer le modèle

Lorsque vous déployez le modèle lié, il déploie l’application web et le compte de stockage. Le déploiement est identique au déploiement d’autres modèles ARM.

PowerShell

New-AzResourceGroup `
  -Name webRG `
  -Location westus2

New-AzResourceGroupDeployment `
  -ResourceGroupName webRG `
  -TemplateFile "c:\Templates\deployTS\azuredeploy.json" `
  -tsResourceGroup templateSpecRg `
  -tsName storageSpec `
  -tsVersion 1.0

INTERFACE DE LIGNE DE COMMANDE

az group create \
  --name webRG \
  --location westus2

az deployment group create \
  --resource-group webRG \
  --template-file "c:\Templates\deployTS\azuredeploy.json" \
  --parameters tsResourceGroup=templateSpecRG tsName=storageSpec tsVersion=1.0

Étapes suivantes

Pour découvrir la création d’une spec de modèle incluant des modèles liés, consultez Créer une spec de modèle d’un modèle lié.