Freigeben über


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

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

  • 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

  1. 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.

  2. 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.

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.

  1. 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

  2. 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.

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.