Szybki start: tworzenie połączenia usługi w usłudze Azure Container Apps przy użyciu interfejsu wiersza polecenia platformy Azure (wersja zapoznawcza)

W tym przewodniku Szybki start pokazano, jak połączyć usługę Azure Container Apps z innymi zasobami w chmurze przy użyciu interfejsu wiersza polecenia platformy Azure i łącznika usługi (wersja zapoznawcza). Łącznik usług umożliwia szybkie łączenie usług obliczeniowych z usługami w chmurze przy jednoczesnym zarządzaniu uwierzytelnianiem połączenia i ustawieniami sieci.

Wymagania wstępne

• Aktywna subskrypcja platformy Azure. Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure.

• Co najmniej jedna aplikacja wdrożona w usłudze Azure Container Apps w regionie obsługiwanym przez łącznik usługi. Jeśli go nie masz, utwórz i wdróż kontener w usłudze Container Apps.

• Użyj środowiska powłoki Bash w usłudze Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Szybki start dotyczący powłoki Bash w usłudze Azure Cloud Shell.

  

• Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj interfejs wiersza polecenia platformy Azure. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie interfejsu wiersza polecenia platformy Azure w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić interfejs wiersza polecenia platformy Azure w kontenerze platformy Docker.

  • Jeśli korzystasz z instalacji lokalnej, zaloguj się do interfejsu wiersza polecenia platformy Azure za pomocą polecenia az login. Aby ukończyć proces uwierzytelniania, wykonaj kroki wyświetlane w terminalu. Aby uzyskać inne opcje logowania, zobacz Logowanie się przy użyciu interfejsu wiersza polecenia platformy Azure.

  • Po wyświetleniu monitu zainstaluj rozszerzenie interfejsu wiersza polecenia platformy Azure podczas pierwszego użycia. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Korzystanie z rozszerzeń w interfejsie wiersza polecenia platformy Azure.

  • Uruchom polecenie az version, aby znaleźć zainstalowane wersje i biblioteki zależne. Aby uaktualnić do najnowszej wersji, uruchom polecenie az upgrade.

• Należy zainstalować wersję 2.37.0 lub nowszą interfejsu wiersza polecenia platformy Azure. Aby przeprowadzić uaktualnienie do najnowszej wersji, uruchom polecenie az upgrade. W przypadku korzystania z usługi Azure Cloud Shell najnowsza wersja jest już zainstalowana.

• Rozszerzenie Container Apps musi być zainstalowane w interfejsie wiersza polecenia platformy Azure lub usłudze Cloud Shell. Aby go zainstalować, uruchom polecenie az extension add --name containerapp.

Konfigurowanie środowiska

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

   Napiwek

   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.

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

Utwórz połączenie przy użyciu tożsamości zarządzanej lub klucza dostępu.

Tożsamość zarządzana

Ważne

Aby użyć tożsamości zarządzanej, musisz mieć uprawnienie do modyfikowania przypisania roli Microsoft Entra. Poproś właściciela subskrypcji o przyznanie Ci tego uprawnienia lub użyj klucza dostępu, aby utworzyć połączenie.

1. Uruchom polecenie , az containerapp connection create aby utworzyć połączenie usługi z usługi Container Apps do usługi Blob Storage z przypisaną przez system tożsamością zarządzaną.

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

2. Podaj następujące informacje w żądaniu interfejsu wiersza polecenia platformy Azure:

   Ustawienie	opis
   The resource group that contains the container app	Nazwa grupy zasobów z aplikacją kontenera.
   Name of the container app	Nazwa aplikacji kontenera.
   The container where the connection information will be saved	Nazwa kontenera aplikacji kontenera.
   The resource group which contains the storage account	Nazwa grupy zasobów z kontem magazynu.
   Name of the storage account	Nazwa konta magazynu, z którym chcesz nawiązać połączenie. W tym przewodniku używamy usługi Blob Storage.

Uwaga

Jeśli nie masz usługi Blob Storage, możesz uruchomić polecenie az containerapp connection create storage-blob --new --system-identity , aby aprowizować nową usługę Blob Storage i bezpośrednio połączyć ją z aplikacją kontenera przy użyciu tożsamości zarządzanej.

Klucz dostępu

Ostrzeżenie

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.

1. Uruchom polecenie , az containerapp connection create aby utworzyć połączenie usługi między usługą Container Apps i usługą Azure Blob Storage przy użyciu klucza dostępu.

   az containerapp connection create storage-blob --secret
   

2. Podaj następujące informacje w żądaniu interfejsu wiersza polecenia platformy Azure:

   Ustawienie	opis
   The resource group that contains the container app	Nazwa grupy zasobów z aplikacją kontenera.
   Name of the container app	Nazwa aplikacji kontenera.
   The container where the connection information will be saved	Nazwa kontenera aplikacji kontenera.
   The resource group which contains the storage account	Nazwa grupy zasobów z kontem magazynu.
   Name of the storage account	Nazwa konta magazynu, z którym chcesz nawiązać połączenie. W tym przewodniku używamy usługi Blob Storage.

Napiwek

Jeśli nie masz usługi Blob Storage, możesz uruchomić polecenie az containerapp connection create storage-blob --new --secret , aby aprowizować nową usługę Blob Storage i bezpośrednio połączyć ją z aplikacją kontenera przy użyciu parametry połączenia.

Wyświetlanie połączeń

Użyj polecenia interfejsu wiersza polecenia az containerapp connection list platformy Azure, aby wyświetlić listę wszystkich aprowizowanych połączeń aplikacji kontenera. Zastąp symbole <container-app-resource-group> zastępcze i <container-app-name> z poniższego polecenia grupą zasobów i nazwą aplikacji kontenera. Możesz również usunąć opcję wyświetlania --output table dodatkowych informacji o połączeniach.

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

Dane wyjściowe zawierają również stan aprowizacji połączeń: niepowodzenie lub powodzenie.

Pokrewne łącza

• Container Apps: łączenie aplikacji Java Quarkus z bazą danych PostgreSQL
• Container Apps: łączenie aplikacji ASP.NET Core z usługą App Configuration