Schnellstart: Verbinden von Azure-Container Apps mit Datenbanken und Diensten mit Dienstconnector (Vorschau)

Erste Schritte mit Dienstconnector, um Ihre Azure-Container-Apps mit Datenbanken, Speicherkonten und anderen Azure-Diensten zu verbinden. Dienstconnector vereinfacht die Authentifizierung und Konfiguration, sodass Sie mithilfe von verwalteten Identitäten oder anderen Authentifizierungsmethoden eine Verbindung mit Ressourcen herstellen können.

Dieser Artikel enthält schrittweise Anleitungen für das Azure-Portal und die Azure CLI. Wählen Sie Ihre bevorzugte Methode mit den oben genannten Registerkarten aus.

Von Bedeutung

Der Support für Service Connector (Vorschau) für Azure-Container-Apps endet am 30. März 2026. Nach diesem Datum sind neue Dienstverbindungen mit Service Connector (Vorschau) über keine Schnittstelle verfügbar. Weitere Informationen finden Sie unter EINSTELLUNG: Service Connector (Vorschau) in Azure-Container Apps.

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.
Eine Zielressource zum Verbinden Ihrer Container Apps mit einem Blob Storage-Konto.
Die erforderlichen Berechtigungen zum Erstellen und Verwalten von Dienstverbindungen.

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.
Eine Zielressource zum Verbinden Ihrer Container Apps mit einem Blob Storage-Konto.
Die erforderlichen Berechtigungen zum Erstellen und Verwalten von Dienstverbindungen.

Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter "Erste Schritte mit Azure Cloud Shell".
Wenn Sie CLI-Referenzbefehle lieber lokal ausführen möchten, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS verwenden, sollten Sie in Betracht ziehen, Azure CLI in einem Docker-Container auszufü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. Um den Authentifizierungsprozess abzuschließen, führen Sie die schritte aus, die in Ihrem Terminal angezeigt werden. Weitere Anmeldeoptionen finden Sie unter Authentifizieren bei Azure mithilfe der Azure CLI.
- Wenn Sie dazu aufgefordert werden, installieren Sie die Azure CLI-Erweiterung bei der ersten Verwendung. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden und Verwalten 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. Führen Sie zum Aktualisieren auf die aktuelle Version az upgrade aus. Wenn Sie Azure Cloud Shell verwenden, ist die neueste Version bereits installiert.

Richten Sie Ihre Umgebung ein

Wenn Sie „Dienstconnector“ zum ersten Mal verwenden, führen Sie zunächst den Befehl az provider register aus, um den Ressourcenanbieter für „Dienstconnector“ 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 containerapp connection list-support-types aus, um eine Liste der unterstützten Zieldienste für Container Apps abzurufen.
```
az containerapp connection list-support-types --output table
```

Erstellen einer Dienstverbindung (Vorschau)

Verwenden Sie Dienstconnector, um eine Dienstverbindung zwischen Ihren Azure Container Apps und Azure Blob Storage herzustellen. In diesem Beispiel wird die Verbindung mit Blob Storage veranschaulicht, aber Sie können denselben Prozess für andere unterstützte Azure-Dienste verwenden.

Wählen Sie die Suchressourcen, Dienste und Dokumente (G +/) oben im Azure-Portal aus, geben Sie Container Apps in den Filter ein, und wählen Sie Container Apps aus.
Wählen Sie den Namen der Azure Container Apps-Ressource aus, die Sie mit einer Zielressource verbinden möchten.
Wählen Sie im linken Inhaltsverzeichnis Service Connector (Vorschau) aus. Klicken Sie anschließend auf Erstellen.

Wählen Sie auf der Registerkarte Grundlagen die folgenden Einstellungen aus, oder geben Sie sie ein:

Einstellung	Beispiel	BESCHREIBUNG
Container	my-container-app	Der Container in Ihrer Container-App.
Diensttyp	Speicher – Blob	Der Diensttyp, den Sie mit Ihrer Container-App verbinden möchten.
Abonnement	Mein Abonnement	Das Abonnement, das den Dienst enthält, mit dem Sie eine Verbindung herstellen möchten. Der Standardwert ist das Abonnement, das diese Container-App enthält.
Verbindungsname	storageblob_700ae	Der Verbindungsname, der die Verbindung zwischen Ihrer Container-App und dem Zieldienst identifiziert. Verwenden Sie den von Service Connector bereitgestellten Verbindungsnamen oder wählen Sie Ihren eigenen Verbindungsnamen.
Speicherkonto	mein-speicherkonto	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	.NET	Der Anwendungsstapel, der mit dem ausgewählten Zieldienst funktioniert. Der Standardwert ist None, wodurch eine Liste mit Konfigurationen generiert wird. Wenn Sie den App-Stapel oder das Client-SDK in Der ausgewählten App kennen, wählen Sie denselben App-Stapel für den Clienttyp aus.

Wählen Sie Weiter: Authentifizierung aus, um eine Authentifizierungsmethode auszuwählen: vom System zugewiesene verwaltete Identität (SMI), vom Benutzer zugewiesene verwaltete Identität (UMI), Verbindungszeichenfolge oder Dienstprinzipal.
Wählen Sie systemseitig zugewiesene verwaltete Identität aus, um eine Verbindung über eine Identität herzustellen, die automatisch in Microsoft Entra ID generiert wird und an den Lebenszyklus der Dienstinstanz gebunden ist. Dies ist die empfohlene Authentifizierungsoption.
Wählen Sie Vom Benutzer zugewiesene verwaltete Identität aus, um sich über eine eigenständige Identität zu authentifizieren, die einer oder mehreren Instanzen eines Azure-Diensts zugewiesen ist. Wählen Sie ein Abonnement aus, das eine vom Benutzer zugewiesene verwaltete Identität enthält, und wählen Sie dann die Identität aus.

Wenn Sie noch keine benutzerseitig zugewiesene verwaltete Identität haben, erstellen Sie eine.
1. Öffnen Sie die Azure-Plattform in einer neuen Registerkarte und suchen Sie nach Verwaltete Identitäten.
2. Wählen Sie Verwaltete Identitäten und dann Erstellen aus
3. Geben Sie ein Abonnement, eine Ressourcengruppe, eine Region und einen Instanznamen ein
4. Wählen Sie Überprüfen + erstellen und danach Erstellen aus.
5. Nachdem Ihre verwaltete Identität bereitgestellt wurde, kehren Sie zur Registerkarte „Dienstconnector“ zurück, wählen Sie Zurück und dann Weiter aus, um die Daten des Formulars zu aktualisieren. Wählen Sie unter Benutzerseitig zugewiesene verwaltete Identität die von Ihnen erstellte Identität aus.
Weitere Informationen finden Sie unter Erstellen einer benutzerseitig zugewiesenen verwalteten Identität.
1. Wählen Sie Dienstprinzipal aus, um einen Dienstprinzipal zu verwenden, der die Zugriffsrichtlinie und Berechtigungen für Benutzer*innen/Anwendungen in Microsoft Entra ID definiert.
2. Wählen Sie einen Dienstprinzipal aus der Liste aus und geben Sie ein Geheimnis ein
Warnung

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

Wählen Sie Verbindungszeichenfolge aus, um ein oder mehrere Schlüssel-Wert-Paare mit reinen Geheimnissen oder Token zu generieren oder zu konfigurieren.
Wählen Sie Weiter: Netzwerk aus, um die Netzwerkkonfiguration auszuwählen, und wählen Sie Firewallregeln konfigurieren aus, um den Zugriff auf den Zieldienst zu ermöglichen, damit Ihre Container-App auf den Blobspeicher zugreifen kann.
Wählen Sie Weiter: Überprüfen + Erstellen aus, um die bereitgestellten Informationen zu überprüfen. Die Ausführung der endgültigen Überprüfung dauert einige Sekunden.
Wählen Sie Erstellen aus, um die Dienstverbindung zu erstellen. Der Vorgang kann bis zu einer Minute dauern.

Verwaltete Identität (empfohlen)
Verbindungszeichenfolge

Führen Sie den az containerapp connection create Befehl aus, um eine Dienstverbindung von Azure Container Apps zu einem Blobspeicher mit einer vom System zugewiesenen verwalteten Identität herzustellen. Sie können diesen Befehl auf zwei verschiedene Arten ausführen:

Generieren Sie die neue Verbindung Schritt für Schritt.

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

Generieren Sie die neue Verbindung in einem Schritt. Ersetzen Sie die Platzhalter durch Ihre eigenen Informationen: <source-subscription>, <source_resource_group>, <app>, <target-subscription>, <target_resource_group> und <account>.

az containerapp connection create storage-blob \                         
   --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.App/containerApps/<app> \
   --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
   --system-identity

Tipp

Wenn Sie nicht über ein Blob Storage-Konto verfügen, führen Sie az containerapp connection create storage-blob --new --system-identity aus, um ein Konto zu erstellen und mit Ihrer Container-App mithilfe einer verwalteten Identität zu verbinden.

Warnung

Microsoft empfiehlt, immer den sichersten Authentifizierungsflow zu verwenden. Der in diesem Verfahren beschriebene Authentifizierungsflow erfordert ein sehr hohes Vertrauen in die Anwendung und bringt Risiken mit sich, die in 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 containerapp connection create aus, um mit einer Verbindungszeichenfolge eine Dienstverbindung von Container-Apps zu einem Blobspeicher zu erstellen. Sie können diesen Befehl auf zwei verschiedene Arten ausführen:

Generieren Sie die neue Verbindung Schritt für Schritt.

az containerapp connection create storage-blob --secret

az containerapp connection create storage-blob \                         
   --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.App/containerApps/<app> \
   --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
   --secret name=<secret-name> secret=<secret>

Tipp

Wenn Sie nicht über ein Blob Storage-Konto verfügen, führen Sie az containerapp connection create storage-blob --new --secret aus, um ein Konto zu erstellen und mit Ihrer Container-App mithilfe einer verwalteten Identität zu verbinden.

Dienstverbindungen anzeigen

Container Apps-Verbindungen werden unter Einstellungen > Dienstconnector (Vorschau) angezeigt. Wählen Sie > aus, um die Liste zu erweitern und die für Ihre Anwendung erforderlichen Eigenschaften anzuzeigen.
Wählen Sie Ihre Verbindung und dann Überprüfen aus, um den Dienstconnector aufzufordern, Ihre Verbindung zu überprüfen.
Wählen Sie Weitere Informationen aus, um Details zur Verbindungsüberprüfung anzuzeigen.

Führen Sie den Befehl az containerapp connection list aus, um alle bereitgestellten Verbindungen Ihrer Container-App aufzulisten. Ersetzen Sie die Platzhalter <container-app-resource-group> und <container-app-name> aus dem folgenden Befehl durch Ihre eigenen Informationen. Sie können auch die --output table Option zum Anzeigen weiterer Informationen zu Ihren Verbindungen entfernen.

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

Die Ausgabe zeigt auch den Bereitstellungsstatus Ihrer Verbindungen an.

Weitere Informationen zu Dienstconnector finden Sie in den folgenden Leitfäden:

Feedback

War diese Seite hilfreich?

Last updated on 2025-09-19