Ressourcengruppenbezogene Bereitstellungen

Azure Developer CLI (azd) unterstützt Bereitstellungen sowohl im Abonnement- als auch im Ressourcengruppenbereich. azd erstellt standardmäßig eine Ressourcengruppe mit den Ressourcen, die in dem Abonnement enthalten sind, das Sie während des azd up-Workflows auswählen. azd ermöglicht Ihnen jedoch auch die Bereitstellung in einer vorhandenen Ressourcengruppe. Wenn Sie eine vorhandene Ressourcengruppe auswählen, wird der Berechtigungsbereich, der zum Ausführen von azd provision erforderlich ist, von der Abonnementebene auf die Ressourcengruppenebene heruntergestuft.

In diesem Artikel erfahren Sie, wie Sie Vorlagen ändern, um Bereitstellungen im Ressourcengruppenbereich zu aktivieren.

Hinweis

Die Bereitstellung im Rahmen einer Ressourcengruppe ist momentan eine Betafunktion. Erfahren Sie mehr über unsere Versionsverwaltungsstrategie.

Ändern des Zielbereichs einer Vorlage

1. Ändern Sie in der main.bicep-Datei Ihrer azd-Vorlage targetScope:

   targetScope = 'resourceGroup'
   

2. Entfernen Sie scope: rg aus allen Referenzen für Module in main.bicep.

3. Verwenden Sie die Ressourcengruppe anstelle des Abonnements, wenn Sie ein eindeutiges Ressourcentoken in main.bicep erstellen.

   var resourceToken = toLower(uniqueString(resourceGroup().id, environmentName, location))
   

4. Entfernen Sie den folgenden Codeabschnitt in main.bicep, der Ressourcen in eine Ressourcengruppe organisiert.

   // Organize resources in a resource group
   resource rg 'Microsoft.Resources/resourceGroups@2021-04-01' = {
       name: !empty(resourceGroupName) ? resourceGroupName : '${abbrs.resourcesResourceGroups}${environmentName}'
       location: location
       tags: tags
   }
   

5. Falls zutreffend, fügen Sie in den Dateien .azdo\pipelines\azure-dev.yml und .github\workflows\azure-dev.yml die Umgebungsvariable Azure Ressourcengruppen zu Ihren Vorgängen hinzu.

   AZURE_RESOURCE_GROUP: $(AZURE_RESOURCE_GROUP)
   

Hinweis

Ein Beispiel für diese Änderungen, die auf die React Web App mit Node.js API und MongoDB auf Azure Vorlage angewendet wurden finden Sie unter dieser GitHub vergleich.

Um die Ressourcengruppe so festzulegen, dass sie manuell bereitgestellt werden soll, können Sie in Ihren AZURE_RESOURCE_GROUP festlegen.

Wenn Sie in Ihrer Umgebung keine Ressourcengruppe angegeben haben, fordert Sie azd auf, eine vorhandene Ressourcengruppe aus Ihrem Abonnement auszuwählen oder eine neue zu erstellen, wenn Sie azd provision ausführen.

Nächste Schritte

häufig gestellte Fragen Azure Developer CLI