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