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

W tym przewodniku Szybki start opisano kroki tworzenia połączenia z usługą w usłudze aplikacja systemu Azure przy użyciu interfejsu wiersza polecenia platformy Azure.

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

Wymagania wstępne

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

• Ten przewodnik Szybki start wymaga wersji 2.30.0 lub nowszej interfejsu wiersza polecenia platformy Azure. W przypadku korzystania z usługi Azure Cloud Shell najnowsza wersja jest już zainstalowana.
• W tym przewodniku Szybki start założono, że masz już co najmniej usługę App Service uruchomioną na platformie Azure. Jeśli nie masz usługi App Service, utwórz je.

Początkowa konfiguracja

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 użyj polecenia az webapp connection list-support-types interfejsu wiersza polecenia platformy Azure, aby uzyskać listę obsługiwanych usług docelowych dla usługi App Service.

   az webapp connection list-support-types --output table
   

Tworzenie połączenia z usługą

Korzystanie z tożsamości zarządzanej

Ważne

Korzystanie z tożsamości zarządzanej wymaga uprawnienia do przypisania roli Entra firmy Microsoft. Bez tego uprawnienia tworzenie połączenia zakończy się niepowodzeniem. Możesz poprosić właściciela subskrypcji o przyznanie Ci tego uprawnienia lub użycie klucza dostępu w celu utworzenia połączenia.

Użyj polecenia az webapp connection interfejsu wiersza polecenia platformy Azure, aby utworzyć połączenie usługi z usługą Blob Storage z przypisaną przez system tożsamością zarządzaną, podając następujące informacje:

• Nazwa grupy zasobów, która zawiera usługę App Service
• Nazwa usługi App Service
• Nazwa grupy zasobów zawierającej konto magazynu
• Nazwa konta magazynu

az webapp connection create storage-blob

Uwaga

Jeśli nie masz usługi Blob Storage, możesz uruchomić polecenie az webapp connection create storage-blob --new --system-identity , aby aprowizować nowy zasób usługi Blob Storage i bezpośrednio połączyć go z wystąpieniem usługi App Service.

Używanie klucza 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.

Użyj polecenia az webapp connection create interfejsu wiersza polecenia platformy Azure, aby utworzyć połączenie usługi z usługą Azure Blob Storage z kluczem dostępu, podając następujące informacje:

• Nazwa źródłowej grupy zasobów usługi obliczeniowej: nazwa grupy zasobów usługi App Service.
• Nazwa usługi App Service: nazwa usługi App Service, która łączy się z usługą docelową.
• Nazwa grupy zasobów usługi docelowej: nazwa grupy zasobów usługi Blob Storage.
• Nazwa konta magazynu: nazwa konta usługi Blob Storage.

az webapp connection create storage-blob --secret

Napiwek

Jeśli nie masz usługi Blob Storage, uruchom polecenie az webapp connection create storage-blob --new --secret , aby aprowizować nowy i bezpośrednio nawiązać połączenie z zasobem usługi App Service.

Wyświetlanie połączeń

Uruchom polecenie az webapp connection interfejsu wiersza polecenia platformy Azure, aby wyświetlić listę połączeń z usługą App Service, podając następujące informacje:

• Nazwa grupy zasobów, która zawiera usługę App Service
• Nazwa usługi App Service

az webapp connection list -g "<your-app-service-resource-group>" -n "<your-app-service-name>" --output table

Następne kroki

Postępuj zgodnie z poniższymi samouczkami, aby rozpocząć tworzenie własnej aplikacji za pomocą łącznika usługi.

Samouczek: aplikacja internetowa i usługa Storage przy użyciu interfejsu wiersza polecenia platformy Azure

Samouczek: aplikacja internetowa i usługa PostgreSQL z interfejsem wiersza polecenia platformy Azure