Erstellen von Ressourcengruppen mithilfe von Bicep

  • Artikel

Sie können Bicep verwenden, um eine neue Ressourcengruppe zu erstellen. In diesem Artikel erfahren Sie, wie Sie Ressourcengruppen erstellen, wenn Sie entweder für das Abonnement oder eine andere Ressourcengruppe bereitstellen.

Ressourcengruppe definieren

Definieren Sie zum Erstellen einer Ressourcengruppe mit Bicep eine Microsoft.Resources/resourceGroups-Ressource mit einem Namen und einem Speicherort für die Ressourcengruppe.

Das folgende Beispiel zeigt eine Bicep-Datei, die eine leere Ressourcengruppe erstellt. Beachten Sie, dass der Zielbereich subscription ist.

targetScope='subscription'

param resourceGroupName string
param resourceGroupLocation string

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

Verwenden Sie die Bereitstellungsbefehle auf Abonnementbereich für die Bereitstellung der Bicep-Datei in einem Abonnement.

Verwenden Sie für die Azure-Befehlszeilenschnittstelle az deployment sub create.

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

Verwenden Sie als PowerShell-Bereitstellungsbefehl New-AzDeployment oder den zugehörigen Alias New-AzSubscriptionDeployment.

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

Erstellen einer Ressourcengruppen und von Ressourcen

Um die Ressourcengruppe zu erstellen und Ressourcen bereitzustellen, fügen Sie ein Modul hinzu, das die Ressourcen definiert, die in der Ressourcengruppe bereitgestellt werden sollen. Legen Sie den Bereich für das Modul auf den symbolischen Namen für die von Ihnen erstellte Ressourcengruppe fest. Sie können in bis zu 800 Ressourcengruppen bereitstellen.

Das folgende Beispiel zeigt eine Bicep-Datei, die eine Ressourcengruppe erstellt und ein Speicherkonto in der Ressourcengruppe bereitstellt. Beachten Sie, dass die Eigenschaft scope für ein Modul auf newRG festgelegt wird. Dabei handelt es sich um den symbolischen Namen für die Ressourcengruppe, die erstellt wird.

targetScope='subscription'

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

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

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

Das Modul verwendet eine Bicep-Datei namens storage.bicep mit folgendem Inhalt:

param storageLocation string
param storageName string

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

Erstellen einer Ressourcengruppe während der Ressourcengruppenbereitstellung

Sie können eine Ressourcengruppe auch während einer Bereitstellung auf Ressourcengruppenebene erstellen. Für dieses Szenario stellen Sie in einer vorhandenen Ressourcengruppe bereit und wechseln auf die Ebene eines Abonnements, um eine Ressourcengruppe zu erstellen. Die folgende Bicep-Datei erstellt eine neue Ressourcengruppe im angegebenen Abonnement. Das Modul, das die Ressourcengruppe erstellt, ist dasselbe wie im Beispiel, das die Ressourcengruppe erstellt.

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
  }
}

Verwenden Sie für die Bereitstellung in einer Ressourcengruppe die Ressourcengruppen-Bereitstellungsbefehle.

Verwenden Sie für die Azure CLI 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

Verwenden Sie als Bereitstellungsbefehl in PowerShell New-AzResourceGroupDeployment.

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

Nächste Schritte

Informationen zu anderen Bereichen finden Sie unter Folgendem: