Előző

Következő

Sablon specifikáció üzembe helyezése

Befejeződött

Miután létrehozta és közzétette a sablon specifikációját, üzembe helyezheti azt. Ebben a leckében megismerheti a sablonspektratívok üzembe helyezésének módjait.

Üzembe helyezés létrehozása sablon-specifikáció használatával

Ha sablonspektráltat szeretne üzembe helyezni egy erőforráscsoportban, ugyanazt New-AzResourceGroupDeployment a parancsmagot használja, amelyet ismer. Sablonfájl megadása helyett a sablon specifikációjának erőforrás-azonosítóját kell megadnia, ahogyan az ebben a példában látható:

New-AzResourceGroupDeployment `
  -TemplateSpecId '/subscriptions/f0750bbe-ea75-4ae5-b24d-a92ca601da2c/resourceGroups/SharedTemplates/providers/Microsoft.Resources/templateSpecs/StorageWithoutSAS'

Bár a sablon specifikációit egy erőforráscsoporton belül kell létrehozni, az alábbi parancsmagok használatával üzembe helyezheti őket előfizetésekben, felügyeleti csoportokban vagy akár bérlőkben is:

Üzembe helyezés ezen a hatókörön:	Használja ezt a PowerShell-parancsmagot:
Erőforráscsoport	New-AzResourceGroupDeployment
Előfizetés	New-AzSubscriptionDeployment
Felügyeleti csoport	New-AzManagementGroupDeployment
Bérlő	New-AzTenantDeployment

Ezek a parancsmagok elfogadják a -TemplateSpecId paramétert, hogy sablonspektratív üzembe helyezést kezdeményezhessenek ezen hatókörök egyikén.

Ha sablon-specifikációt szeretne üzembe helyezni egy erőforráscsoportban, ugyanazt az deployment group create a parancsot használja, amelyet már ismer. Sablonfájl megadása helyett a sablon specifikációjának erőforrás-azonosítóját kell megadnia, ahogyan az ebben a példában látható:

az deployment group create \
  --template-spec "/subscriptions/f0750bbe-ea75-4ae5-b24d-a92ca601da2c/resourceGroups/SharedTemplates/providers/Microsoft.Resources/templateSpecs/StorageWithoutSAS"

Bár a sablon specifikációit egy erőforráscsoporton belül kell létrehozni, az alábbi parancsokkal telepítheti őket előfizetésekben, felügyeleti csoportokban vagy akár bérlőkben is:

Üzembe helyezés ezen a hatókörön:	Futtassa ezt az Azure CLI-parancsot:
Erőforráscsoport	az deployment group create
Előfizetés	az deployment sub create
Felügyeleti csoport	az deployment mg create
Bérlő	az deployment tenant create

Ezek a parancsok mindegyike elfogadja az argumentumot, --template-spec amely egy sablonspektrum üzembe helyezését kezdeményezi ezen hatókörök valamelyikén.

Sablon-specifikáció használata csatolt üzemelő példányként

Ha egy másik Azure Resource Manager-sablonból (ARM-sablonból) származó sablon-specifikációt szeretne használni, hozzon létre egy üzembe helyezést, amely ezt a sablon-specifikációt használja. Az ilyen típusú üzembe helyezést csatolt üzemelő példánynak nevezzük, mivel külsőleg megadott üzembehelyezési sablonhoz kapcsolódik.

Az Azure-ban az üzembe helyezés olyan erőforrás, amelynek erőforrástípusa Microsoft.Resources/deploymentsvan. ARM-sablon üzembe helyezésekor üzembehelyezési erőforrást hoz létre. Ugyanez a fogalom vonatkozik egy sablon specifikációjának üzembe helyezésekor, például a következőhöz:

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

Ha rendelkezik paraméterekkel a sablonspektratív üzembe helyezéshez, a következő tulajdonságot parameters használja:

{
  "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')]"
      }
    }
  }
}

Sablon specifikáció használata Bicep-modulként

A sablon specifikációja modulként használható egy Bicep-fájlban:

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

Figyelje meg, hogy a modul elérési útja speciális formátumot használ:

A modul elérési útja három összetevőből áll, amelyeket kettőspont (:) karakter választ el egymástól:

• Séma: A Bicep számos modultípust támogat, amelyeket sémáknak neveznek. Amikor sablon-specifikációt használ modulként, sémaként használja ts .
• Előfizetés azonosítója, erőforráscsoport neve és sablon specifikációjának neve: Ezeknek az értékeknek meg kell adniuk a korábban közzétett sablonspektrális erőforrás helyét. A perjelek (/) használatával elkülönítheti az előfizetés azonosítóját, az erőforráscsoport nevét és a sablon specifikációjának nevét. A modul elérési útjának ez a szakasza nem a sablon specifikációjának teljes erőforrás-azonosítója – csak néhány az erőforrás-azonosító összetevői közül.
• Verzió: A sablon specifikációs verzióját is tartalmaznia kell.

Feljegyzés

A modul elérési útjának megadásakor nem használhat változókat, paramétereket vagy sztringinterpolációt. A teljes sablon-specifikáció elérési útját a Bicep-fájlba kell menteni.

Ha paraméterekkel rendelkezik a sablon specifikációjának megadásához, a tulajdonságot params használja:

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

A program letölti a sablon specifikációfájlját, és a Bicep-fájl létrehozásakor átmásolja (átmásolja) a JSON ARM-sablonba. Ez a művelet általában a Bicep-fájl üzembe helyezésekor történik, de a Bicep-eszköz használatával a parancs futtatásával explicit módon is lefordíthatja a bicep build fájlt.

Folytatás