Verwalten von Azure-Ressourcengruppen mit der Azure CLI
Eine Azure-Ressourcengruppe ist ein Container, der verwandte Ressourcen für eine Azure-Lösung enthält. Eine Ressourcengruppe kann Speicher, virtuelle Computer, Apps, Dashboards, Dienste oder nahezu alle von Ihnen in Azure verwendeten Komponenten enthalten.
Mit der Azure CLI (Azure Command-Line Interface, Azure-Befehlszeilenschnittstelle) können Sie Azure-Standardressourcengruppen erstellen, dauerhaft speichern und festlegen. Mit der CLI können Sie Ressourcen auch nach ihrer Erstellung bereinigen.
Azure-Regionsidentifikation
Azure-Kunden können sich für die Bereitstellung von Ressourcen in vielen verschiedenen Regionen entscheiden. In einigen Fällen können Kunden die Kosten senken, indem sie Regionen in der Nähe auswählen, die die gleichen Dienste anbieten. Wenn eine Region in der Nähe bestimmt wird, wird eine Meldung angezeigt, die Region für zukünftige Bereitstellungen auszuwählen.
Im folgenden Beispiel wird der Befehl az config verwendet, um die Meldung zur Regionsempfehlung zu deaktivieren:
az config set core.display_region_identified=no
Weitere Informationen zu Azure-Regionen finden Sie unter Auswählen der richtigen Azure-Region für Sie.
Erstellen einer Ressourcengruppe
Verwenden Sie zum Erstellen einer Ressourcengruppe den Befehl az group create:
az group create --name MyResourceGroup --location eastus
Eine Ressourcengruppe gehört jeweils nur zu einem Standort. Führen Sie zum Anzeigen aller im aktuellen Abonnement unterstützten Standorte den Befehl az account list-locations aus:
az account list-locations
Verwenden Sie zum Anzeigen aller Ressourcengruppen für Ihr aktuelles Abonnement den Befehl az group list:
az group list --output table
Tipp
Der Parameter --output ist ein globaler Parameter und für alle Befehle verfügbar. Mit dem Wert table wird die Ausgabe in einem benutzerfreundlichen Format angezeigt. Weitere Informationen finden Sie unter Ausgabeformate für Azure CLI-Befehle.
Wenn Sie eine Ressource erstellen, müssen Sie sie in einer Ressourcengruppe erstellen. Das folgende Beispiel zeigt ein mithilfe des Befehls az storage account create erstelltes Speicherkonto:
az storage account create --resource-group MyResourceGroup --name storage134 --location eastus --sku Standard_LRS
Führen Sie zum Entfernen einer Ressourcengruppe den Befehl az group delete aus.
az group delete --name MyResourceGroup
Beim Entfernen einer Ressourcengruppe löschen Sie alle dazugehörigen Ressourcen. Dieser Vorgang kann nicht rückgängig gemacht werden. Wenn Sie einen der Befehle in diesem Artikel ausprobieren, wird beim Löschen der von Ihnen erstellten Ressourcengruppen Ihr Konto bereinigt.
Dauerhaftes Speichern einer Ressourcengruppe
Die Parameterpersistenz ermöglicht die Wiederverwendung von Werten für bestimmte Parameter, einschließlich Ressourcengruppen.
Aktivieren Sie zunächst das Persistenzfeature mithilfe des Befehls az config param-persist on:
az config param-persist on
Erstellen Sie nach dem Aktivieren der Persistenz eine weitere Ressourcengruppe:
az group create --name OtherResourceGroup --location eastus
Solange Persistenz aktiviert ist, können Sie den Parameter --resource-group in künftigen Befehlen auslassen. Der folgende Befehl erstellt ein Speicherkonto in der Gruppe OtherResourceGroup.
az storage account create --name storage135 --location eastus --sku Standard_LRS
Die in dem Befehl angegebene Ressourcengruppe hat Vorrang. Mit dem folgenden Befehl wird eine Speichergruppe in einer Ressourcengruppe namens StorageGroups erstellt:
az storage account create --resource-group StorageGroups --name storage136 --location eastus --sku Standard_LRS
Wenn Sie jedoch eine andere Ressourcengruppe als Wert angeben, setzt die Azure CLI den dauerhaft gespeicherten Wert zurück. Neue Befehle verwenden StorageGroups als Ressourcengruppe. Die dauerhaft gespeicherten Werte können mit dem Befehl az config param-persist show angezeigt werden:
az config param-persist show
Mit diesem Befehl werden die aktuellen dauerhaft gespeicherten Werte angezeigt. Diese Werte werden in einer Datei namens local_context_<Benutzername> in dem ausgeblendeten Verzeichnis .azure gespeichert. Die Azure CLI erstellt das Verzeichnis am aktuellen Standort, wenn Sie zum ersten Mal einen persistenten Wert erstellen.
Wenn Sie keine dauerhaft gespeicherten Parameter mehr verwenden möchten, führen Sie den Befehl az config param-persist off aus:
az config param-persist off
Von der Azure CLI werden die dauerhaft gespeicherten Werte gespeichert. Diese können in der lokalen Kontextdatei angezeigt werden. Wenn Sie die Parameterpersistenz erneut aktivieren, sind diese Werte bereits festgelegt.
Weitere Informationen zur Verwendung der Befehle vom Typ az config param-persist finden Sie unter Verwenden von permanenten Parametern zum Vereinfachen von sequenziellen Azure CLI-Befehlen.
Festlegen einer Standardressourcengruppe
Sie können eine Standardressourcengruppe für alle Befehle festlegen, die Sie über die lokale Azure CLI oder über Azure Cloud Shell ausführen. Die Azure CLI speichert diese Konfiguration lokal in einer Datei vom Typ config. Führen Sie zum Anzeigen der aktuellen Konfiguration den Befehl az config get aus:
az config get
Im Ergebnis werden Standardressourcengruppen und andere Standardwerte angezeigt. Wenn Sie die Azure CLI zum ersten Mal verwenden, sind die Ergebnisse möglicherweise leer.
Führen Sie zum Festlegen einer Standardressourcengruppe für Ihre Azure CLI-Installation den Befehl az config set aus:
az config set defaults.group=MyResourceGroup
Mit dem Befehl wird ein Wert für einen angegebenen Schlüssel festgelegt, in diesem Fall defaults.group. Informationen zu verfügbaren Konfigurationsoptionen finden Sie unter Azure CLI-Konfiguration.
Hinweis
Mit dem Befehl az config set wird nicht überprüft, ob die von Ihnen eingegebene Ressourcengruppe vorhanden ist. Mit dem Befehl wird lediglich das Schlüssel-Wert-Paar gespeichert.
Nach dem Ausführen des Befehls erhalten Sie mit den folgenden beiden Befehlen dasselbe Ergebnis:
az storage account create --resource-group MyResourceGroup --name storage01 --location eastus --sku Standard_LRS
az storage account create --name storage01 --location eastus --sku Standard_LRS
Eine Ressourcengruppe gehört zu einem Abonnement. Wenn Ihre Organisation über mehrere Abonnements verfügt, müssen Sie das entsprechende Abonnement festlegen, bevor Sie eine Ressourcengruppe im Abonnement verwenden. Wenn der Standardwert einer Ressourcengruppe nicht zu Ihrem aktuellen Abonnement gehört, tritt ein Fehler auf. Weitere Informationen zu mehreren Abonnements finden Sie unter Verwenden mehrerer Azure-Abonnements.
Sie müssen den Standardwert nicht zurücksetzen, um andere Ressourcengruppen zu verwenden. Geben Sie stattdessen die Ressourcengruppe an:
az group create --name OtherResourceGroup --location eastus
az storage account create --resource-group StorageGroups --name storage03 --location westus --sku Standard_LRS
Der Standardwert gilt nur für Sie. Andere Benutzer oder Änderungen, die Sie über das Azure-Portal vornehmen, sind davon nicht betroffen.
Wenn Sie, wie in diesem Artikel beschrieben, festgelegte Parameterwerte verwenden, haben diese Werte Vorrang vor den in der config-Datei festgelegten Standardwerten.
Bereinigen von Ressourcen
Wenn Sie einen der Befehle in diesem Artikel ausprobiert haben, können Sie alle erstellten Ressourcen mithilfe des Befehls az group delete entfernen:
az group delete --name MyResourceGroup
az group delete --name OtherResourceGroup
az group delete --name StorageGroups
Mit diesem Befehl werden die Gruppe und gleichzeitig alle darin enthaltenen Ressourcen gelöscht.
Sie können die persistenten Parameter mithilfe des Befehls az config param-persist delete entfernen:
az config param-persist delete --all