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

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 usługi Połączenie or. Usługa Połączenie or umożliwia szybkie łączenie usług obliczeniowych z usługami w chmurze przy jednoczesnym zarządzaniu ustawieniami uwierzytelniania i sieci połączenia.

Ważne

Usługa Połączenie or w usłudze Container Apps jest obecnie dostępna w wersji zapoznawczej. Zobacz Dodatkowe warunki użytkowania wersji zapoznawczych platformy Microsoft Azure, aby zapoznać się z postanowieniami prawnymi dotyczącymi funkcji platformy Azure, które są w wersji beta lub wersji zapoznawczej albo w inny sposób nie zostały jeszcze wydane jako ogólnie dostępne.

Wymagania wstępne

• 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 Container Apps w regionie obsługiwanym przez usługę Połączenie or. 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.

Początkowa konfiguracja

1. Jeśli używasz Połączenie usługi po raz pierwszy, uruchom polecenie az provider register, aby zarejestrować dostawcę zasobów usługi Połączenie or.

   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, usługa Połączenie or została już zarejestrowana.

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ą

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. Bez tego uprawnienia tworzenie połączenia zakończy się niepowodzeniem. 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

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.

Następne kroki

Wewnętrzne Połączenie or usługi