Szybki start: łączenie usługi Azure Container Apps z bazami danych i usługami za pomocą łącznika usługi (wersja zapoznawcza)

Zacznij korzystać z Łącznika usługi, aby połączyć Azure Container Apps z bazami danych, kontami magazynu i innymi usługami platformy Azure. Łącznik usługi upraszcza uwierzytelnianie i konfigurację, umożliwiając łączenie się z zasobami przy użyciu tożsamości zarządzanych lub innych metod uwierzytelniania.

Ten artykuł zawiera instrukcje krok po kroku dotyczące witryny Azure Portal i interfejsu wiersza polecenia platformy Azure. Wybierz preferowaną metodę, korzystając z zakładek powyżej.

Ważne

Wsparcie dla Łącznika Usług (wersja zapoznawcza) w Azure Container Apps kończy się 30 marca 2026 r. Po tej dacie nowe połączenia usług przy użyciu łącznika usługi (wersja zapoznawcza) nie są dostępne za pośrednictwem żadnego interfejsu. Aby uzyskać więcej informacji, zobacz RETIREMENT: Service Connector (wersja zapoznawcza) w usłudze Azure Container Apps.

Prerequisites

Konto Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
Aplikacja wdrożona w Container Apps w regionie obsługiwanym przez Service Connector.
Zasób docelowy, do którego można podłączyć aplikacje kontenerowe, taki jak konto usługi Blob Storage.
Niezbędne uprawnienia do tworzenia połączeń usług i zarządzania nimi.

Konto Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
Aplikacja wdrożona w Container Apps w regionie obsługiwanym przez Service Connector.
Zasób docelowy, do którego można podłączyć aplikacje kontenerowe, taki jak konto usługi Blob Storage.
Niezbędne uprawnienia do tworzenia połączeń usług i zarządzania nimi.

Użyj środowiska Bash w Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Get started with Azure Cloud Shell.
Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj Azure CLI. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie Azure CLI w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić Azure CLI w kontenerze Docker.
- Jeśli korzystasz z instalacji lokalnej, zaloguj się do Azure CLI za pomocą polecenia az login. Aby zakończyć proces uwierzytelniania, wykonaj kroki wyświetlane na Twoim terminalu. Aby uzyskać inne opcje logowania, zobacz Uwierzytelnianie na platformie Azure przy użyciu interfejsu wiersza polecenia platformy Azure.
- Gdy zostaniesz o to poproszony/a, zainstaluj rozszerzenie Azure CLI przy pierwszym użyciu. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Używanie rozszerzeń i zarządzanie nimi za pomocą interfejsu wiersza polecenia platformy Azure.
- Uruchom az version, aby sprawdzić zainstalowaną wersję i biblioteki zależne. Aby zaktualizować do najnowszej wersji, uruchom az upgrade.

Ten szybki start wymaga wersji 2.30.0 lub nowszej Azure CLI. Aby przeprowadzić uaktualnienie do najnowszej wersji, uruchom polecenie az upgrade. W przypadku korzystania z usługi Azure Cloud Shell najnowsza wersja jest już zainstalowana.

Konfigurowanie środowiska

Jeśli używasz łącznika usługi po raz pierwszy, uruchom polecenie az provider register , aby zarejestrować dostawcę zasobów łącznika usług.
```
az provider register -n Microsoft.ServiceLinker
```
Wskazówka

Możesz sprawdzić, czy dostawca zasobów został już zarejestrowany, uruchamiając polecenie az provider show -n "Microsoft.ServiceLinker" --query registrationState. Jeśli dane wyjściowe to Registered, łącznik usługi został już zarejestrowany.
Opcjonalnie uruchom polecenie az containerapp connection list-support-types , aby uzyskać listę obsługiwanych usług docelowych dla usługi Container Apps.
```
az containerapp connection list-support-types --output table
```

Tworzenie połączenia z usługą (wersja zapoznawcza)

Użyj łącznika usługi, aby utworzyć połączenie usługi między usługą Azure Container Apps i usługą Azure Blob Storage. W tym przykładzie pokazano nawiązywanie połączenia z usługą Blob Storage, ale możesz użyć tego samego procesu w przypadku innych obsługiwanych usług platformy Azure.

Wybierz pasek wyszukiwania Wyszukaj zasoby, usługi i dokumenty (G +/) w górnej części witryny Azure Portal, wpisz pozycję Container Apps w filtrze i wybierz pozycję Aplikacje kontenera.
Wybierz nazwę zasobu Container Apps, który chcesz połączyć z zasobem docelowym.
Wybierz pozycję Łącznik usługi (wersja zapoznawcza) z lewego spisu treści. Następnie wybierz pozycję Utwórz.

Na karcie Podstawowe wybierz lub wprowadź następujące ustawienia.

Setting	Example	Description
Container	my-container-app	Kontener w twojej aplikacji kontenerowej.
Typ usługi	Storage — Blob	Typ usługi, którą chcesz połączyć z aplikacją kontenera.
Subscription	my-subscription	Subskrypcja zawierająca usługę, z którą chcesz nawiązać połączenie. Wartość domyślna to subskrypcja zawierająca tę aplikację kontenera.
Nazwa połączenia	storageblob_700ae	Nazwa połączenia, która identyfikuje połączenie między aplikacją kontenera a usługą docelową. Użyj nazwy połączenia dostarczonej przez łącznik usługi lub wybierz własną nazwę połączenia.
Konto magazynu	my-storage-account	Docelowe konto magazynu, z którym chcesz nawiązać połączenie. Jeśli wybierzesz inny typ usługi, wybierz odpowiednie wystąpienie usługi docelowej.
Typ klienta	.NET	Stos aplikacji, który współpracuje z wybraną usługą docelową. Wartość domyślna to Brak, która generuje listę konfiguracji. Jeśli znasz wybrany stos aplikacji lub zestaw SDK klienta, wybierz ten sam stos aplikacji dla typu klienta.

Wybierz pozycję Dalej: Uwierzytelnianie , aby wybrać metodę uwierzytelniania: tożsamość zarządzana przypisana przez system (SMI), tożsamość zarządzana przypisana przez użytkownika (UMI), parametry połączenia lub jednostka usługi.
Wybierz tożsamość zarządzaną przypisaną przez system, aby nawiązać połączenie za pośrednictwem tożsamości, która jest automatycznie generowana w Microsoft Entra ID i związana z cyklem życia wystąpienia usługi. Jest to zalecana opcja uwierzytelniania.
Wybierz Tożsamość zarządzaną przypisaną przez użytkownika, aby uwierzytelnić się za pomocą autonomicznej tożsamości przypisanej do co najmniej jednego wystąpienia usługi Azure. Wybierz subskrypcję zawierającą tożsamość zarządzaną przypisaną przez użytkownika, a następnie wybierz tożsamość.

Jeśli nie masz jeszcze tożsamości zarządzanej przypisanej przez użytkownika, utwórz jedną z nich:
1. Otwórz platformę Azure na nowej karcie i wyszukaj tożsamości zarządzane.
2. Wybierz pozycję Tożsamości zarządzane i wybierz pozycję Utwórz.
3. Wprowadź subskrypcję, grupę zasobów, region i nazwę wystąpienia.
4. Wybierz Przejrzyj i utwórz, a następnie Utwórz
5. Po wdrożeniu tożsamości zarządzanej wróć do karty Łącznik usługi, wybierz pozycję Wstecz i Dalej, aby odświeżyć dane formularza. W obszarze Tożsamość zarządzana przypisana przez użytkownika wybierz utworzoną tożsamość.
Aby uzyskać więcej informacji, zobacz tworzenie tożsamości zarządzanej przypisanej przez użytkownika.
1. Wybierz pozycję Pełnomocnik usługi aby skorzystać z pełnomocnika usługi, który definiuje zasady dostępu i uprawnienia użytkownika/aplikacji w Microsoft Entra ID.
2. Wybierz jednostkę usługi z listy i wprowadź wpis tajny
Warning

Firma Microsoft zaleca korzystanie z najbezpieczniejszego dostępnego przepływu uwierzytelniania. Przepływ uwierzytelniania opisany w tej procedurze wymaga bardzo wysokiego poziomu zaufania w aplikacji i niesie ze sobą ryzyko, które nie występują w innych przepływach. Tego przepływu należy używać tylko wtedy, gdy inne bezpieczniejsze przepływy, takie jak tożsamości zarządzane, nie są opłacalne.

Wybierz pozycję Parametry połączenia, aby wygenerować lub skonfigurować jedną lub wiele par klucz-wartość z czystymi sekretami lub tokenami.
Wybierz pozycję Dalej: Sieć , aby wybrać konfigurację sieci, a następnie wybierz pozycję Konfiguruj reguły zapory, aby umożliwić dostęp do usługi docelowej , aby aplikacja kontenera mogła uzyskać dostęp do usługi Blob Storage.
Wybierz pozycję Dalej: Przejrzyj i utwórz , aby przejrzeć podane informacje. Uruchamianie ostatecznej weryfikacji trwa kilka sekund.
Wybierz Utwórz, aby utworzyć połączenie usługi. Wykonanie operacji może potrwać do minuty.

Tożsamość zarządzana (zalecane)
Parametry połączenia

Uruchom polecenie az containerapp connection create, aby utworzyć połączenie serwisowe z Container Apps do Blob Storage z systemowo przypisaną tożsamością zarządzaną. To polecenie można uruchomić na dwa różne sposoby:

Wygeneruj nowe połączenie krok po kroku.

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

Wygeneruj nowe połączenie jednocześnie. Zastąp symbole zastępcze własnymi informacjami: <source-subscription>, , <source_resource_group>, <app><target-subscription>, <target_resource_group>, i <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

Wskazówka

Jeśli nie masz konta usługi Blob Storage, uruchom polecenie az containerapp connection create storage-blob --new --system-identity , aby go utworzyć i połącz go z aplikacją kontenera przy użyciu tożsamości zarządzanej.

Warning

Firma Microsoft zaleca korzystanie z najbezpieczniejszego dostępnego przepływu uwierzytelniania. Przepływ uwierzytelniania opisany w tej procedurze wymaga bardzo wysokiego poziomu zaufania w aplikacji i niesie ze sobą ryzyko, które nie występują w innych przepływach. Tego przepływu należy używać tylko wtedy, gdy inne bezpieczniejsze przepływy, takie jak tożsamości zarządzane, nie są opłacalne.

Uruchom polecenie az containerapp connection create aby utworzyć połączenie usługi z Container Apps do Blob Storage z ciągiem połączenia. To polecenie można uruchomić na dwa różne sposoby:

Wygeneruj nowe połączenie krok po kroku.

az containerapp connection create storage-blob --secret

Wygeneruj nowe połączenie jednocześnie. Zastąp symbole zastępcze własnymi informacjami: <source-subscription>, <source_resource_group>, <app>, <target-subscription>, <target_resource_group>, <account>, <secret-name> i <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>

Wskazówka

Jeśli nie masz konta usługi Blob Storage, uruchom polecenie az containerapp connection create storage-blob --new --secret , aby go utworzyć i połącz go z aplikacją kontenera przy użyciu tożsamości zarządzanej.

Wyświetl połączenia usług

Połączenia usługi Container Apps są wyświetlane w obszarze Ustawienia > Łącznik usługi (wersja zapoznawcza). Wybierz > , aby rozwinąć listę i wyświetlić właściwości wymagane przez aplikację.
Wybierz swoje połączenie, a następnie potwierdź, aby umożliwić Łącznikowi Usług sprawdzenie połączenia.
Wybierz pozycję Dowiedz się więcej , aby przejrzeć szczegóły weryfikacji połączenia.

Uruchom polecenie az containerapp connection list , aby wyświetlić listę wszystkich aprowizowanych połączeń aplikacji kontenera. Zastąp elementy <container-app-resource-group> oraz <container-app-name> w poniższym poleceniu swoimi informacjami. Możesz również usunąć opcję wyświetlania --output table dodatkowych informacji o połączeniach.

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

Dane wynikowe zawierają również stan wdrożenia połączeń.

Aby uzyskać więcej informacji na temat Service Connector, zapoznaj się z następującymi przewodnikami:

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2025-09-19