Udrul en skabelonspecifikation

  • 3 minutter

Når du har oprettet og publiceret skabelonspecifikationen, kan du installere den. I dette undermodul får du mere at vide om, hvordan du udruller en skabelonspecifikation.

Opret en installation ved hjælp af en skabelonspecifikation

Hvis du vil udrulle en skabelonspecifikation til en ressourcegruppe, skal du bruge den samme New-AzResourceGroupDeployment cmdlet, som du kender. I stedet for at angive en skabelonfil skal du angive ressource-id'et for en skabelonspecifikation, som vist i dette eksempel:

New-AzResourceGroupDeployment `
  -TemplateSpecId '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/SharedTemplates/providers/Microsoft.Resources/templateSpecs/StorageWithoutSAS'

Selvom skabelonspecifikationer skal oprettes i en ressourcegruppe, kan du udrulle dem til abonnementer, administrationsgrupper eller endda lejere ved hjælp af disse cmdlet'er:

Sådan udrulles på dette område: Brug denne PowerShell-cmdlet:
Ressourcegruppe New-AzResourceGroupDeployment
Abonnement New-AzSubscriptionDeployment
Administrationsgruppe New-AzManagementGroupDeployment
Lejer New-AzTenantDeployment

Hver af disse cmdlet'er accepterer parameteren -TemplateSpecId til at starte en udrulning af skabelonspecifikationer på et af disse områder.

Hvis du vil udrulle en skabelonspecifikation til en ressourcegruppe, skal du bruge den samme kommando az deployment group create, som du kender. I stedet for at angive en skabelonfil skal du angive ressource-id'et for en skabelonspecifikation, som vist i dette eksempel:

az deployment group create \
  --template-spec "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/SharedTemplates/providers/Microsoft.Resources/templateSpecs/StorageWithoutSAS"

Selvom skabelonspecifikationer skal oprettes i en ressourcegruppe, kan du udrulle dem til abonnementer, administrationsgrupper eller endda lejere ved hjælp af disse kommandoer:

Sådan udrulles på dette område: Kør denne Azure CLI-kommando:
Ressourcegruppe az deployment group create
Abonnement az deployment sub create
Administrationsgruppe az deployment mg create
Lejer az deployment tenant create

Hver af disse kommandoer accepterer argumentet --template-spec for at starte en udrulning af skabelonspecifikationer i et af disse områder.

Brug en skabelonspecifikation som en sammenkædet installation

Hvis du vil bruge en skabelonspecifikation fra en anden Azure Resource Manager-skabelon (ARM-skabelon), skal du oprette en installation, der bruger denne skabelonspecifikation. Denne type installation kaldes en sammenkædet installation, fordi du linker til en udrulningsskabelon, der er angivet eksternt.

I Azure er en udrulning en ressource, der har ressourcetypen Microsoft.Resources/deployments. Når du udruller en ARM-skabelon, opretter du en installationsressource. Det samme koncept gælder, når du installerer en skabelonspecifikation på følgende måde:

{
  "type": "Microsoft.Resources/deployments",
  "apiVersion": "2020-10-01",
  "name": "createStorage",
  "properties": {
    "mode": "Incremental",
    "templateLink": {
      "id": "[resourceId('Microsoft.Resources/templateSpecs/versions', variables('templateSpecName'), variables('templateSpecVersion'))]"
    }
  }
}

Når du har parametre, der skal angives for udrulningen af skabelonspecifikationen, skal du bruge egenskaben parameters:

{
  "type": "Microsoft.Resources/deployments",
  "apiVersion": "2020-10-01",
  "name": "createStorage",
  "properties": {
    "mode": "Incremental",
    "templateLink": {
      "id": "[resourceId('Microsoft.Resources/templateSpecs/versions', variables('templateSpecName'), variables('templateSpecVersion'))]"
    },
    "parameters": {
      "storageAccountName": {
        "value": "[parameters('storageAccountName')]"
      }
    }
  }
}

Brug en skabelonspecifikation som et Bicep-modul

Du kan bruge en skabelonspecifikation som et modul i en Bicep-fil:

module storageAccountTemplateSpec 'ts:f0750bbe-ea75-4ae5-b24d-a92ca601da2c/sharedTemplates/StorageWithoutSAS:1.0' = {
  name: 'storageAccountTemplateSpec'
}

Bemærk, at modulstien bruger et særligt format:

diagram, der viser komponenterne i skabelonens specifikationssti.

Der er tre komponenter til modulstien adskilt af kolontegnet (:):

  • ordning: Bicep understøtter flere typer modul, som kaldes ordninger. Når du bruger en skabelonspecifikation som et modul, bruger du ts som skema.
  • Abonnements-id, ressourcegruppenavn og navn på skabelonspecifikation: Disse værdier skal angive placeringen af den skabelonspecifikationsressource, du tidligere har publiceret. Du kan bruge skråstreger (/) til at adskille abonnements-id'et, navnet på ressourcegruppen og navnet på skabelonspecifikationen. Dette afsnit af modulstien er ikke det fulde ressource-id for skabelonspecifikationen. Det er blot nogle få af komponenterne i ressource-id'et.
  • version: Skabelonens specifikationsversion skal inkluderes.

Seddel

Du kan ikke bruge variabler, parametre eller strenginterpolering, når du angiver stien til et modul. Den fulde skabelonspecifikationssti skal gemmes i din Bicep-fil.

Når du har parametre, der skal angives for skabelonspecifikationen, skal du bruge egenskaben params:

module storageAccountTemplateSpec 'ts:f0750bbe-ea75-4ae5-b24d-a92ca601da2c/sharedTemplates/StorageWithoutSAS:1.0' = {
  name: 'storageAccountTemplateSpec'
  params: {
    storageAccountName: storageAccountName
  }
}

Skabelonspecifikationsfilen downloades og kopieres (overføres) til JSON ARM-skabelonen, når Bicep-filen oprettes. Normalt sker denne handling, når du installerer din Bicep-fil, men du kan også bruge Bicep-værktøjet til at oversætte eksplicit ved at køre kommandoen bicep build.