Verbinden einer Container-App mit einem Clouddienst mit Service Connector

Azure Container Apps ermöglicht Ihnen, einen Dienstconnector zum Herstellen einer Verbindung mit Clouddiensten in nur wenigen Schritten zu verwenden. Der Dienstconnector verwaltet die Konfiguration der Netzwerkeinstellungen und Verbindungsinformationen zwischen verschiedenen Diensten. Informationen zum Anzeigen aller unterstützten Dienste finden Sie unter Mehr erfahren über den Dienstconnector.

In diesem Artikel erfahren Sie, wie Sie eine Container-App mit Azure Blob Storage verbinden.

Wichtig

Dieses Feature in Container Apps befindet sich derzeit in der Vorschauphase. Die zusätzlichen Nutzungsbestimmungen für Microsoft Azure-Vorschauen enthalten rechtliche Bedingungen. Sie gelten für diejenigen Azure-Features, die sich in der Beta- oder Vorschauversion befinden oder aber anderweitig noch nicht zur allgemeinen Verfügbarkeit freigegeben sind.

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.
• Eine Anwendung, die für Container Apps in einer vom Dienstconnector unterstützten Region bereitgestellt wird. Wenn Sie noch keinen Container haben, erstellen Sie einen, und erstellen Sie ihn in Container Apps.
• Ein Azure Blob Storage-Konto.

Anmelden bei Azure

Melden Sie sich zuerst bei Azure an.

Portal

Melden Sie sich unter https://portal.azure.com/ mit Ihrem Azure-Konto beim Azure-Portal an.

Azure-Befehlszeilenschnittstelle

az login

Mit diesem Befehl wird Ihr Webbrowser aufgefordert, eine Azure-Anmeldeseite zu starten und zu laden. Wenn der Browser nicht öffnen kann, verwenden Sie den Gerätecodefluss mit az login --use-device-code. Um weitere Anmeldeoptionen anzuzeigen, wechseln Sie zur Anmeldung mit der Azure CLI.

Erstellen einer neuen Dienstverbindung

Verwenden Sie den Dienstconnector, um eine neue Dienstverbindung in Container Apps über das Azure-Portal oder mithilfe der CLI zu erstellen.

Portal

1. Navigieren Sie zum Azure-Portal.

2. Wählen Sie im linken Bereich des Azure-Portals Alle Ressourcen aus.

3. Geben Sie Container Apps in den Filter ein, und wählen Sie in der Liste den Namen der gewünschten Container-App aus.

4. Wählen Sie im linken Inhaltsverzeichnis Dienstconnector aus.

5. Klicken Sie auf Erstellen.

   

6. Wählen Sie die folgenden Einstellungen aus, oder geben Sie sie ein.

   Einstellung	Vorgeschlagener Wert	Beschreibung
   Container	Der Name Ihres Containers.	Wählen Sie Ihre Container Apps-Instanz aus.
   Diensttyp	Blob Storage	Dies ist der Zieldiensttyp. Wenn Sie über keinen Storage-Blobcontainer verfügen, können Sie einen Container erstellen oder einen anderen Diensttyp verwenden.
   Abonnement	Eines Ihrer Abonnements	Das Abonnement, das Ihren Zieldienst enthält. Der Standardwert ist das Abonnement für Ihre Container-App.
   Verbindungsname	Generierter eindeutiger Name	Der Verbindungsname, der die Verbindung zwischen Ihrer Container-App und dem Zieldienst identifiziert.
   Speicherkonto	Name Ihres Speicherkontos	Das Zielspeicherkonto, mit dem Sie eine Verbindung herstellen möchten. Wenn Sie einen anderen Diensttyp auswählen, müssen Sie die entsprechende Zieldienstinstanz auswählen.
   Clienttyp	Der App-Stapel in Ihrem ausgewählten Container	Ihr Anwendungsstapel, der mit dem ausgewählten Zieldienst zusammenarbeitet. Der Standardwert ist Keiner, wodurch eine Liste mit Konfigurationen generiert wird. Wenn Sie den App-Stapel oder das Client-SDK im ausgewählten Container kennen, wählen Sie denselben App-Stapel für den Clienttyp aus.

7. Wählen Sie Weiter: Authentifizierung aus, um den Authentifizierungstyp auszuwählen. Wählen Sie dann Verbindungszeichenfolge aus, um den Zugriffsschlüssel zum Herstellen einer Verbindung mit Ihrem Blob Storage-Konto zu verwenden.

8. Wählen Sie Weiter: Netzwerk aus, um die Netzwerkkonfiguration auszuwählen. Wählen Sie anschließend Firewalleinstellungen aktivieren aus, um die Firewall-Positivliste in Blob Storage zu aktualisieren, damit die Blob Storage-Instanz für Ihre Container-Apps erreichbar ist.

9. Wählen Sie dann Weiter: Überprüfen und erstellen aus, um die bereitgestellten Informationen zu überprüfen. Die Ausführung der endgültigen Überprüfung dauert einige Sekunden. Wählen Sie dann Erstellen aus, um die Dienstverbindung zu erstellen. Es kann ungefähr eine Minute dauern, bis der Vorgang abgeschlossen ist.

Azure-Befehlszeilenschnittstelle

Mit den folgenden Schritten wird eine Dienstverbindung mithilfe eines Zugriffsschlüssels oder einer systemseitig zugewiesenen verwalteten Identität erstellt.

1. Verwenden Sie den Azure CLI-Befehl az containerapp connection list-support-types, um alle unterstützten Zieldienste anzuzeigen.

   az provider register -n Microsoft.ServiceLinker
   az containerapp connection list-support-types --output table
   

2. Verwenden Sie den Azure CLI-Befehl az containerapp connection connection create, um eine Dienstverbindung aus einer Container-App heraus zu erstellen.

   Wenn Sie die Verbindung mit einem Zugriffsschlüssel herstellen, führen Sie den folgenden Code aus:

   az containerapp connection create storage-blob --secret
   

   Wenn Sie eine Verbindung mit einer systemseitig zugewiesenen verwalteten Identität herstellen, führen Sie den folgenden Code aus:

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

3. Geben Sie auf Anforderung der Azure CLI die folgenden Informationen an:

   • Die Ressourcengruppe, die die Container-App enthält: der Name der Ressourcengruppe mit der Container-App.
   • Name der Container-App: der Name Ihrer Container-App.
   • Der Container, in dem die Verbindungsinformationen gespeichert werden: der Name des Containers in Ihrer Container-App, der eine Verbindung mit dem Zieldienst herstellt
   • Die Ressourcengruppe, die das Speicherkonto enthält: der Name der Ressourcengruppe mit dem Speicherkonto. In diesem Leitfaden ist dies ein Blob-Storage-Konto.
   • Name des Speicherkontos: der Name des Speicherkontos, das Ihr Blob enthält.

   Wichtig

   Um eine verwaltete Identität zu verwenden, müssen Sie über die Berechtigung zum Verwalten der Microsoft Entra-Rollenzuweisungen verfügen. Wenn Sie diese Berechtigung nicht besitzen, können Sie keine Verbindung erstellen. Sie können Ihren Abonnementbesitzer bitten, Ihnen die Berechtigung zu erteilen, oder Sie verwenden stattdessen einen Zugriffsschlüssel, um die Verbindung zu erstellen.

   Hinweis

   Wenn Sie keine Blob Storage-Instanz besitzen, können Sie az containerapp connection create storage-blob --new --secret ausführen, um eine neue bereitzustellen.

Anzeigen von Dienstverbindungen in Container Apps

Zeigen Sie Ihre vorhandenen Dienstverbindungen über das Azure-Portal oder mithilfe der CLI an.

Portal

1. Wählen Sie unter Dienstconnector die Option Aktualisieren aus. Daraufhin wird eine Container Apps-Verbindung angezeigt.

2. Wählen Sie > aus, um die Liste zu erweitern. Sie können die Umgebungsvariablen sehen, die für Ihren Anwendungscode erforderlich sind.

3. Wählen Sie ... und dann Überprüfen aus. Die Details zur Verbindungsvalidierung werden im Popupbereich auf der rechten Seite angezeigt.

   

Azure-Befehlszeilenschnittstelle

Verwenden Sie den Azure CLI-Befehl az containerapp connection list, um alle Ihre Container-App-Verbindungen aufzulisten. Geben Sie die folgenden Informationen ein:

• Ressourcengruppenname des Quellcomputediensts: der Ressourcengruppenname der Container-App.
• Container-App-Name: der Name Ihrer Container-App.

az containerapp connection list -g "<your-container-app-resource-group>" --name "<your-container-app-name>" --output table

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

Nächste Schritte

Umgebungen in Azure Container Apps