Schnellstart: Erstellen einer Dienstverbindung in App Service mit der Azure-Befehlszeilenschnittstelle

Artikel
10/16/2024

In dieser Schnellstartanleitung werden die Schritte zum Erstellen einer Dienstverbindung in Azure App Service mit der Azure CLI beschrieben.

Wenn Sie kein Azure-Abonnement haben, erstellen Sie ein kostenloses Azure-Konto, bevor Sie beginnen.

Voraussetzungen

Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter Schnellstart für Bash in Azure Cloud Shell.
Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.
- Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Informationen zu anderen Anmeldeoptionen finden Sie unter Anmelden mit der Azure CLI.
- Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden von Erweiterungen mit der Azure CLI.
- Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.

Für diese Schnellstartanleitung ist mindestens Version 2.30.0 der Azure CLI erforderlich. Bei Verwendung von Azure Cloud Shell ist die aktuelle Version bereits installiert.
In diesem Schnellstart wird davon ausgegangen, dass Sie bereits über mindestens einen in Azure ausgeführten App Service verfügen. Erstellen Sie einen App Service, wenn Sie über keinen App Service verfügen.

Anfängliche Einrichtung

Wenn Sie Service Connector zum ersten Mal verwenden, führen Sie zunächst den Befehl az provider register aus, um den Service Connector-Ressourcenanbieter zu registrieren.
```
az provider register -n Microsoft.ServiceLinker
```
Tipp

Sie können überprüfen, ob der Ressourcenanbieter bereits registriert wurde, indem Sie den Befehl az provider show -n "Microsoft.ServiceLinker" --query registrationState ausführen. Wenn die Ausgabe Registered ist, wurde der Dienstconnector bereits registriert.
Verwenden Sie den Azure CLI-Befehl az webapp connection list-support-types, um eine Liste der unterstützten Zieldienste für App Service abzurufen.
```
az webapp connection list-support-types --output table
```

Wichtig

Für die Verwendung einer verwalteten Identität müssen Sie über die Berechtigung für die Microsoft Entra-Rollenzuweisung verfügen. Ohne diese Berechtigung können Sie keine Verbindung erstellen. Sie können den*die Abonnementbesitzer*in bitten, Ihnen diese Berechtigung zu erteilen, oder Sie verwenden einen Zugriffsschlüssel, um die Verbindung zu erstellen.

Verwenden Sie den Azure CLI-Befehl az webapp connection, um eine Dienstverbindung mit einer Blob Storage-Instanz mit einer systemseitig zugewiesenen verwalteten Identität zu erstellen, und geben Sie dabei die folgenden Informationen an:

Der Name der Ressourcengruppe, die die App Service-Instanz enthält
Der Name der App Service-Instanz
Der Name der Ressourcengruppe, die das Speicherkonto enthält
Der Name des Speicherkontos

az webapp connection create storage-blob

Hinweis

Wenn Sie keine Blob Storage-Instanz besitzen, können Sie az webapp connection create storage-blob --new --system-identity ausführen, um eine neue Blob Storage-Ressource bereitzustellen und direkt mit der App Service-Instanz zu verbinden.

Warnung

Microsoft empfiehlt, immer den sichersten Authentifizierungsflow zu verwenden. Der in diesem Verfahren beschriebene Authentifizierungsflow erfordert ein sehr hohes Maß an Vertrauen in die Anwendung und birgt Risiken, die bei anderen Flows nicht vorhanden sind. Sie sollten diesen Flow nur verwenden, wenn andere sicherere Flows (z. B. verwaltete Identitäten) nicht anwendbar sind.

Verwenden Sie den Azure CLI-Befehl az webapp connection create, um eine Dienstverbindung mit einer Azure Blob Storage-Instanz mit einem Zugriffsschlüssel zu erstellen, und geben Sie dabei die folgenden Informationen an:

Ressourcengruppenname des Quellcomputediensts: Der Ressourcengruppenname der App Service-Instanz
App Service-Name: Der Name Ihrer App Service-Instanz, die eine Verbindung mit dem Zieldienst herstellt
Zieldienst-Ressourcengruppenname: Ressourcengruppenname der Blob Storage-Instanz
Speicherkontoname: Kontoname Ihrer Blob Storage-Instanz

az webapp connection create storage-blob --secret

Tipp

Wenn Sie keine Blob Storage-Instanz besitzen, führen Sie az webapp connection create storage-blob --new --secret aus, um eine neue bereitzustellen und direkt mit der App Service-Ressource zu verbinden.

Anzeigen von Verbindungen

Verwenden Sie den Azure CLI-Befehl az webapp connection, um Verbindungen mit Ihrer App Service-Instanz aufzulisten, und geben Sie dabei die folgenden Informationen an:

Der Name der Ressourcengruppe, die die App Service-Instanz enthält
Der Name der App Service-Instanz

az webapp connection list -g "<your-app-service-resource-group>" -n "<your-app-service-name>" --output table

Nächste Schritte

Arbeiten Sie die unten stehenden Tutorials durch, um mit dem Erstellen Ihrer eigenen Anwendung mit dem Dienstconnector zu beginnen:

Tutorial: WebApp + Storage mit Azure CLI

Tutorial: WebApp + PostgreSQL mit Azure CLI

Freigeben über