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

Dokumentationen

CLI

Mit der Azure CLI ist es möglich, Ressourcen in Azure über die Kommandozeileneingabe zu erstellen. 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. Sehen Sie dazu die Anleitung hier.

Login

Wie im Portal muss man sich auch mittels der CLI zuerst ein Login durchführen. Dazu kann man die Kommandozeileneingabe öffnen und folgenden Befehl eingeben:

az login

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

Erstellen einer Resource Group

Ein einfaches Beispiel für eine administrative Aufgabe wäre das erstellen einer Resource Group. Dazu kann man nach dem Login folgenden Befehl eingeben:

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

Scripting

Während einzelne Abfragen einfach sind um einen Überblick zu bekommen, ist die CLI vorallem dafür prädestiniert komplette Infrastrukturen zu verwalten. Dazu sind Scripts geeignet. Sehen Sie folgendes Beispiel in Bash um eine WebApp zu erstellen:

#!/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 Script kann man dann auf der Kommandozeile ausführen:

chmod +x script.sh
./script.sh

Note

Man muss bei diesem Beispiel bevor man das Script ausführt sich noch per az login anmelden

PIM

Falls man über die CLI Tätigkeiten ausführen muss, bei welcher man erst eine Rolle aktivieren muss (siehe Berechtigungen bzw. Tutorial Rolle aktivieren), kann man dies gleich Handhaben wie beim Portal. Man muss also die PIM Gruppe aktivieren und kann danach mit den erhöhten Rechten auch über die CLI arbeiten.

Important

Falls man sich zuerst mit az login angemeldet hat und dann die PIM Gruppe aktiviert kann es sein, dass die Berechtigungen noch nicht aktiv sind. Daher muss man danach zuerst mittels az logout sich nochmals von Azure abmelden und danach per az login erneut anmelden.

Nächste Schritte

Mittels der CLI kann man kleinere Umgebungen automatisiert aufbauen lassen und per Scripts diesen Prozess automatisieren. Falls man grössere Umgebungen verwaltet, 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 gibt es eine kurze Einführung.

Weiterführende Informationen