University of Bern
Dokumentationen
  1. Dokumentationen
  2. Cloud
  3. Azure
  4. Erste Schritte
  5. CLI

Dokumentationen

CLI

Mit der Azure CLI können Ressourcen in Azure über die Kommandozeileneingabe erstellt werden. Nachfolgend ein Auszug von Microsoft:

Die Azure-Befehlszeilenschnittstelle (Azure CLI) ist ein plattformübergreifendes Befehlszeilentool, über das Sie eine Verbindung mit Azure herstellen und Verwaltungsbefehle für Azure-Ressourcen ausführen können. Das Tool ermöglicht die Ausführung von Befehlen über ein Terminal, indem interaktive Befehlszeilenaufforderungen oder ein Skript verwendet werden.

Note

Dieses Thema ist nicht notwendig, um Azure zu nutzen. Alles was hier beschrieben wird kann ebenso über das Portal ausgeführt werden.

Installation

Das Tool kann direkt über die Website von Azure installiert werden. Die Anleitung ist in der CLI Dokumentation zu finden.

Login

Wie im Portal muss auch mittels der CLI zuerst ein Login durchgeführt werden. Dazu kann die Kommandozeileneingabe geöffnet und folgender Befehl eingegeben werden:

az login

Das Login wird interaktiv durchgeführt. Normalerweise öffnet sich nach der Eingabe ein Browser, wobei die gleiche Login-Maske wie beim Portal angezeigt wird.

Erstellen einer Resource Group

Ein einfaches Beispiel für eine administrative Aufgabe ist das Erstellen einer Resource Group. Dazu kann nach dem Login folgender Befehl eingegeben werden:

az group create --location switzerlandnorth -n rg-testtutorial-switzerlandnorth-001

Scripting

Während Einzelabfragen praktisch sind, um einen Überblick zu bekommen, ist die CLI vor allem dafür prädestiniert, komplette Infrastrukturen zu verwalten. Dazu sind Skripte geeignet. Folgendes Beispiel in Bash zeigt das Erstellen einer WebApp:

#!/usr/bin/env bash

resourceGroupName="rg-testwebapp-switzerlandnorth-001"
appServiceName="app-testwebapp-switzerlandnorth-001"
planName="plan-testwebapp-switzerlandnorth-001"
location="switzerlandnorth"
servicePlanSku="F1"

if az group show --name $resourceGroupName --query "name" --output tsv 2>/dev/null; then
    echo "Resource group '$resourceGroupName' already exists."
else
    # Create the resource group
    az group create --name $resourceGroupName --location "$location"
    echo "Resource group '$resourceGroupName' created."
fi

# Check if the service plan already exists
if az appservice plan show --name $planName --resource-group $resourceGroupName --query "name" --output tsv 2>/dev/null; then
    echo "App Service Plan '$planName' already exists."
else
    # Create the App Service Plan
    az appservice plan create --name $planName --resource-group $resourceGroupName --sku $servicePlanSku
    echo "App Service Plan '$planName' created."
fi

# Create the App Service
az webapp create --name $appServiceName --resource-group $resourceGroupName --plan $planName

echo "App Service '$appServiceName' created in resource group '$resourceGroupName' in location '$location'."

Dieses Skript kann dann auf der Kommandozeile ausgeführt werden:

chmod +x script.sh
./script.sh

Note

Bei diesem Beispiel muss vor der Ausführung des Skripts eine Anmeldung per az login durchgeführt werden.

PIM

Falls über die CLI Tätigkeiten ausgeführt werden müssen, bei welchen erst eine Rolle aktiviert werden muss (siehe Berechtigungen bzw. Tutorial Rolle aktivieren), kann dies gleich gehandhabt werden wie beim Portal. Die PIM-Gruppe muss also aktiviert werden und danach kann mit den erhöhten Rechten auch über die CLI gearbeitet werden.

Important

Falls zuerst eine Anmeldung mit az login durchgeführt wurde und dann die PIM-Gruppe aktiviert wird, kann es sein, dass die Berechtigungen noch nicht aktiv sind. Daher muss danach zuerst mittels az logout eine Abmeldung von Azure durchgeführt und anschliessend per az login eine erneute Anmeldung vorgenommen werden.

Nächste Schritte

Mittels der CLI können kleinere Umgebungen automatisiert aufgebaut und per Skripte dieser Prozess automatisiert werden. Falls grössere Umgebungen verwaltet werden, ist die CLI jedoch nicht ideal. Dazu eignen sich spezialisierte Infrastructure as Code (IaC) Tools. Ein bekanntes IaC-Tool ist Terraform. Im nächsten Artikel Terraform ist eine kurze Einführung zu finden.

Weiterführende Informationen