Sdílet prostřednictvím

Vytvoření skupin prostředků pomocí Bicep

  • Článek

Pomocí bicep můžete vytvořit novou skupinu prostředků. V tomto článku se dozvíte, jak vytvořit skupiny prostředků při nasazování do předplatného nebo jiné skupiny prostředků.

Definování skupiny prostředků

Pokud chcete vytvořit skupinu prostředků pomocí bicep, definujte prostředek Microsoft.Resources/resourceGroups s názvem a umístěním skupiny prostředků.

Následující příklad ukazuje soubor Bicep, který vytvoří prázdnou skupinu prostředků. Všimněte si, že jeho cílový obor je subscription.

targetScope='subscription'

param resourceGroupName string
param resourceGroupLocation string

resource newRG 'Microsoft.Resources/resourceGroups@2024-03-01' = {
  name: resourceGroupName
  location: resourceGroupLocation
}

K nasazení souboru Bicep do předplatného použijte příkazy nasazení na úrovni předplatného.

Pro Azure CLI použijte příkaz az deployment sub create.

az deployment sub create \
  --name demoSubDeployment \
  --location centralus \
  --template-file resourceGroup.bicep \
  --parameters resourceGroupName=demoResourceGroup resourceGroupLocation=centralus

Pro příkaz nasazení PowerShellu použijte New-AzDeployment nebo jeho alias New-AzSubscriptionDeployment.

New-AzSubscriptionDeployment `
  -Name demoSubDeployment `
  -Location centralus `
  -TemplateFile resourceGroup.bicep `
  -resourceGroupName demoResourceGroup `
  -resourceGroupLocation centralus

Vytvoření skupiny prostředků a prostředků

Pokud chcete vytvořit skupinu prostředků a nasadit do ní prostředky, přidejte do ní modul, který definuje prostředky, které se mají nasadit do skupiny prostředků. Nastavte obor modulu na symbolický název skupiny prostředků, kterou vytvoříte. Nasazení můžete provést až do 800 skupin prostředků.

Následující příklad ukazuje soubor Bicep, který vytvoří skupinu prostředků a nasadí účet úložiště do skupiny prostředků. Všimněte si, že scope vlastnost modulu je nastavena na newRGsymbolický název skupiny prostředků, která se vytváří.

targetScope='subscription'

param resourceGroupName string
param resourceGroupLocation string
param storageName string
param storageLocation string

resource newRG 'Microsoft.Resources/resourceGroups@2024-03-01' = {
  name: resourceGroupName
  location: resourceGroupLocation
}

module storageAcct 'storage.bicep' = {
  name: 'storageModule'
  scope: newRG
  params: {
    storageLocation: storageLocation
    storageName: storageName
  }
}

Modul používá soubor Bicep s názvem storage.bicep s následujícím obsahem:

param storageLocation string
param storageName string

resource storageAcct 'Microsoft.Storage/storageAccounts@2023-04-01' = {
  name: storageName
  location: storageLocation
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'Storage'
  properties: {}
}

Vytvoření skupiny prostředků během nasazení skupiny prostředků

Můžete také vytvořit skupinu prostředků během nasazení na úrovni skupiny prostředků. V tomto scénáři nasadíte do existující skupiny prostředků a přejdete na úroveň předplatného a vytvoříte skupinu prostředků. Následující soubor Bicep vytvoří v zadaném předplatném novou skupinu prostředků. Modul, který vytvoří skupinu prostředků, je stejný jako v příkladu, který vytvoří skupinu prostředků.

param secondResourceGroup string
param secondSubscriptionID string = ''
param secondLocation string

// module deployed at subscription level
module newRG 'resourceGroup.bicep' = {
  name: 'newResourceGroup'
  scope: subscription(secondSubscriptionID)
  params: {
    resourceGroupName: secondResourceGroup
    resourceGroupLocation: secondLocation
  }
}

K nasazení do skupiny prostředků použijte příkazy pro nasazení skupiny prostředků.

Pro Azure CLI použijte příkaz az deployment group create.

az deployment group create \
  --name demoRGDeployment \
  --resource-group ExampleGroup \
  --template-file main.bicep \
  --parameters secondResourceGroup=newRG secondSubscriptionID={sub-id} secondLocation=westus

Pro příkaz nasazení PowerShellu použijte Rutinu New-AzResourceGroupDeployment.

New-AzResourceGroupDeployment `
  -Name demoRGDeployment `
  -ResourceGroupName ExampleGroup `
  -TemplateFile main.bicep `
  -secondResourceGroup newRG `
  -secondSubscriptionID {sub-id} `
  -secondLocation westus

Další kroky

Další informace o dalších oborech najdete tady: