Schnellstart: Erstellen Sie eine Dienstverbindung in Azure Spring Apps mit der Azure-Befehlszeilenschnittstelle

Artikel
05/21/2024

Dieser Schnellstart zeigt Ihnen, wie Sie Azure Spring Apps mithilfe der Azure-Befehlszeilenschnittstelle und des Dienstconnectors mit anderen Cloud-Ressourcen verbinden.

Mit Service Connector können Sie Rechendienste schnell mit Clouddiensten verbinden und gleichzeitig die Authentifizierungs- und Netzwerkeinstellungen Ihrer Verbindung verwalten.

Voraussetzungen

Eine Azure-Subscription. Wenn Sie kein Azure-Abonnement haben, erstellen Sie ein kostenloses Azure-Konto, bevor Sie beginnen.
Mindestens eine Anwendung, die von Azure Spring Apps in einer von Service Connector unterstützten Region gehostet wird. Wenn Sie noch keine haben, stellen Sie Ihre erste Anwendung in Azure Spring Apps bereit.

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.

Mindestens Version 2.37.0 der Azure CLI. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen. Bei Verwendung von Azure Cloud Shell ist die aktuelle Version bereits installiert.
Die Azure Spring Apps-Erweiterung muss in der Azure CLI oder Cloud Shell installiert werden. Führen Sie zur Installation az extension add --name spring aus.

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.
Führen Sie optional den Befehl az spring connection list-support-types aus, um eine Liste der unterstützten Zieldienste für Azure Spring Apps abzurufen.
```
az spring connection list-support-types --output table
```
Tipp

Wenn der az spring Befehl vom System nicht erkannt wird, überprüfen Sie, ob Sie die erforderliche Erweiterung installiert haben, indem Sie ausführen az extension add --name spring.

Erstellen einer Dienstverbindung

Erstellen Sie eine Verbindung aus Azure Spring Apps mithilfe einer verwalteten Identität oder eines Zugriffsschlüssels.

Verwaltete Identität
Zugangsschlüssel

Wichtig

Um eine verwaltete Identität zu verwenden, müssen Sie über die Berechtigung zum Ändern von Rollenzuweisungen in Microsoft Entra ID verfügen. Ohne diese Berechtigung können Sie keine Verbindung erstellen. Bitten Sie Ihren Abonnementbesitzer, Ihnen eine Rollenzuweisungsberechtigung zu erteilen, oder verwenden Sie einen Zugriffsschlüssel, um die Verbindung herzustellen.

Führen Sie den az spring connection create Befehl aus, um eine Dienstverbindung zu einem Blobspeicher mit einer vom System zugewiesenen verwalteten Identität zu erstellen

Stellen Sie auf Anforderung der CLI oder von Cloud Shell die folgenden Informationen bereit:

az spring connection create storage-blob --system-identity

Einstellung	Beschreibung
`The resource group which contains the spring-cloud`	Der Name der Ressourcengruppe, die eine von Azure Spring Apps gehostete App enthält.
`Name of the spring-cloud service`	Der Name der Azure Spring Apps-Ressource.
`Name of the spring-cloud app`	Der Name der von Azure Spring Apps gehosteten Anwendung, die eine Verbindung mit dem Zieldienst herstellt
`The resource group which contains the storage account`	Der Name der Ressourcengruppe mit dem Speicherkonto.
`Name of the storage account`	Der Name des Speicherkontos, mit dem Sie eine Verbindung herstellen möchten. In diesem Leitfaden ist dies ein Blob-Storage-Konto.

Tipp

Wenn Sie keinen Blobspeicher haben, können Sie einen neuen az spring connection create storage-blob --new --system-identity Blobspeicher bereitstellen und ihn mithilfe einer verwalteten Identität direkt mit Ihrer von Azure Spring Apps gehosteten Anwendung 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.

Führen Sie den Befehl az spring connection create aus, um eine Dienstverbindung zwischen Azure Spring Apps und einer Azure Blob Storage-Instanz mit einem Zugriffsschlüssel zu erstellen.
```
az spring connection create storage-blob --secret
```

Stellen Sie auf Anforderung der CLI oder von Cloud Shell die folgenden Informationen bereit:

Einstellung	Beschreibung
`The resource group which contains the spring-cloud`	Der Name der Ressourcengruppe, die die von Azure Spring Apps gehostete App enthält.
`Name of the spring-cloud service`	Der Name der Azure Spring Apps-Ressource.
`Name of the spring-cloud app`	Der Name der von Azure Spring Apps gehosteten Anwendung, die eine Verbindung mit dem Zieldienst herstellt
`The resource group which contains the storage account`	Der Name der Ressourcengruppe mit dem Speicherkonto.
`Name of the storage account`	Der Name des Speicherkontos, mit dem Sie eine Verbindung herstellen möchten. In diesem Leitfaden ist dies ein Blob-Storage-Konto.

Tipp

Wenn Sie keinen Blobspeicher haben, können Sie ausführen, um az spring connection create storage-blob --new --secret einen neuen Blobspeicher bereitzustellen und ihn mithilfe einer Verbindungszeichenfolge direkt mit Ihrer von Azure Spring Apps gehosteten Anwendung zu verbinden.

Anzeigen von Verbindungen

Führen az spring connection list Sie den Befehl aus, um alle bereitgestellten Verbindungen Ihrer Azure Spring Apps aufzulisten.

Ersetzen Sie die Platzhalter <azure-spring-apps-resource-group>, <azure-spring-apps-name>, und <app-name> aus dem folgenden Befehl durch den Namen Ihrer Azure Spring Apps-Ressourcengruppe, den Namen Ihrer Azure Spring Apps-Ressource und den Namen Ihrer Anwendung. Sie können auch die --output table Option zum Anzeigen weiterer Informationen zu Ihren Verbindungen entfernen.

az spring connection list --resource-group <azure-spring-apps-resource-group> --service <azure-spring-apps-name> --app <app-name>--output table

Die Ausgabe zeigt auch den Bereitstellungsstatus Ihrer Verbindungen an: fehlerhaft oder erfolgreich.

Nächste Schritte

Weitere Informationen zum Dienstconnector und zu Azure Spring Apps finden Sie in den folgenden Leitfäden.

Lernprogramm: Azure Spring Apps + MySQL

Tutorial: Azure Spring Apps + Apache Kafka in Confluent Cloud

Teilen über