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

W tym przewodniku Szybki start pokazano, jak połączyć usługę Azure Spring Apps z innymi zasobami w chmurze przy użyciu interfejsu wiersza polecenia platformy Azure i łącznika usług.

Łą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

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

• Co najmniej jedna aplikacja hostowana przez usługę Azure Spring Apps w regionie obsługiwanym przez łącznik usługi. Jeśli jej nie masz, wdróż pierwszą aplikację w usłudze Azure Spring 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.

• Wersja 2.37.0 lub nowsza 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 Azure Spring Apps musi być zainstalowane w interfejsie wiersza polecenia platformy Azure lub usłudze Cloud Shell. Aby go zainstalować, uruchom polecenie az extension add --name spring.

Konfiguracja początkowa

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 spring connection list-support-types , aby uzyskać listę obsługiwanych usług docelowych dla usługi Azure Spring Apps.

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

   Napiwek

   az spring Jeśli polecenie nie jest rozpoznawane przez system, sprawdź, czy zainstalowano wymagane rozszerzenie, uruchamiając polecenie az extension add --name spring.

Tworzenie połączenia z usługą

Utwórz połączenie z usługi Azure Spring Apps 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ć uprawnienia do modyfikowania przypisań ról w identyfikatorze Entra firmy Microsoft. Poproś właściciela subskrypcji o udzielenie Ci uprawnienia do przypisania roli lub użycie klucza dostępu w celu utworzenia połączenia.

1. Uruchom polecenie , az spring connection create aby połączyć aplikację wdrożona w usłudze Azure Spring Apps z zasobem usługi Blob Storage przy użyciu przypisanej przez system tożsamości zarządzanej.

2. Podaj następujące informacje w żądaniu interfejsu wiersza polecenia lub usługi Cloud Shell:

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

   Ustawienie	opis
   The resource group which contains the spring-cloud	Nazwa grupy zasobów, która zawiera aplikację hostowaną przez usługę Azure Spring Apps.
   Name of the spring-cloud service	Nazwa zasobu usługi Azure Spring Apps.
   Name of the spring-cloud app	Nazwa aplikacji hostowanej przez usługę Azure Spring Apps, która łączy się z usługą docelową.
   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 spring connection create storage-blob --new --system-identity , aby aprowizować nową usługę Blob Storage i bezpośrednio połączyć ją z aplikacją hostowaną przez usługę Azure Spring Apps 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 spring connection create aby utworzyć połączenie usługi między usługą Azure Spring Apps i usługą Azure Blob Storage przy użyciu klucza dostępu.

   az spring connection create storage-blob --secret
   

2. Podaj następujące informacje w żądaniu interfejsu wiersza polecenia lub usługi Cloud Shell:

   Ustawienie	opis
   The resource group which contains the spring-cloud	Nazwa grupy zasobów, która zawiera aplikację hostowaną przez usługę Azure Spring Apps.
   Name of the spring-cloud service	Nazwa zasobu usługi Azure Spring Apps.
   Name of the spring-cloud app	Nazwa aplikacji hostowanej przez usługę Azure Spring Apps, która łączy się z usługą docelową.
   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 spring connection create storage-blob --new --secret , aby aprowizować nową usługę Blob Storage i bezpośrednio połączyć ją z aplikacją hostowaną przez usługę Azure Spring Apps przy użyciu parametry połączenia.

Wyświetlanie połączeń

Uruchom az spring connection list polecenie , aby wyświetlić listę wszystkich aprowizowanych połączeń usługi Azure Spring Apps.

Zastąp symbole <azure-spring-apps-resource-group>zastępcze , <azure-spring-apps-name>i <app-name> z poniższego polecenia nazwą grupy zasobów usługi Azure Spring Apps, nazwą zasobu usługi Azure Spring Apps i nazwą aplikacji. Możesz również usunąć opcję wyświetlania --output table dodatkowych informacji o połączeniach.

az spring connection list --resource-group <azure-spring-apps-resource-group> --service <azure-spring-apps-name> --app <app-name>--output table

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

Następne kroki

Zapoznaj się z poniższymi przewodnikami, aby uzyskać więcej informacji na temat łącznika usług i usługi Azure Spring Apps.

Samouczek: Azure Spring Apps + MySQL

Samouczek: Azure Spring Apps + Apache Kafka w usłudze Confluent Cloud