Szybki start: łączenie usługi Azure Spring Apps z bazami danych i usługami za pomocą łącznika usługi

Rozpocznij pracę z łącznikiem usługi, aby połączyć usługę Azure Spring Apps z bazami danych, kontami magazynu i innymi usługami platformy Azure. Łącznik usługi upraszcza uwierzytelnianie i konfigurację, umożliwiając łączenie się z zasobami przy użyciu tożsamości zarządzanych innych metod uwierzytelniania.

Ten artykuł zawiera instrukcje krok po kroku dotyczące witryny Azure Portal i interfejsu wiersza polecenia platformy Azure. Wybierz preferowaną metodę przy użyciu powyższych kart.

Note

Plany Podstawowa, Standardowa i Enterprise zostały wprowadzone w okresie wycofania 17 marca 2025 r. Aby uzyskać więcej informacji, zobacz ogłoszenie o wycofaniu usługi Azure Spring Apps.

Prerequisites

• Konto Azure z aktywną subskrypcją. Utwórz bezpłatne konto platformy Azure.
• Aplikacja wdrożona w usłudze Azure Spring Apps w regionie obsługiwanym przez łącznik usługi.
• Zasób docelowy do łączenia usługi Azure Spring Apps z. Na przykład usługa Azure Key Vault.
• Niezbędne uprawnienia do tworzenia połączeń usług i zarządzania nimi.

• Konto Azure z aktywną subskrypcją. Utwórz bezpłatne konto platformy Azure.
• Aplikacja wdrożona w usłudze Azure Spring Apps w regionie obsługiwanym przez łącznik usługi.
• Zasób docelowy do łączenia usługi Azure Spring Apps z. Na przykład usługa Azure Key Vault.
• Niezbędne uprawnienia do tworzenia połączeń usług i zarządzania nimi.

• Użyj środowiska Bash w Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Get started with Azure Cloud Shell.

  

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

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

  • Gdy zostaniesz o to poproszony/a, zainstaluj rozszerzenie Azure CLI przy pierwszym użyciu. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Używanie rozszerzeń i zarządzanie nimi za pomocą interfejsu wiersza polecenia platformy Azure.

  • Uruchom az version, aby sprawdzić zainstalowaną wersję i biblioteki zależne. Aby zaktualizować do najnowszej wersji, uruchom 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
   

   Wskazówka

   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 następujące polecenie, aby uzyskać listę obsługiwanych usług docelowych dla usługi Azure Spring Apps.

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

   Wskazówka

   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ą

Użyj łącznika usługi, aby utworzyć bezpieczne połączenie usługi między usługą Azure Spring Apps i usługą Azure Blob Storage. W tym przykładzie pokazano nawiązywanie połączenia z usługą Blob Storage, ale możesz użyć tego samego procesu w przypadku innych obsługiwanych usług platformy Azure.

1. Wybierz pasek wyszukiwania Wyszukaj zasoby, usługi i dokumenty (G +/) w górnej części witryny Azure Portal, wpisz Azure Spring Apps w filtrze i wybierz pozycję Azure Spring Apps.

   

2. Wybierz nazwę wystąpienia usługi Azure Spring Apps, które chcesz połączyć z zasobem docelowym.

3. W obszarze Ustawienia wybierz pozycję Aplikacje i wybierz aplikację z listy.

   

4. Wybierz pozycję Łącznik usługi z menu usługi i wybierz pozycję Utwórz.

5. Na karcie Podstawowe wybierz lub wprowadź następujące ustawienia.

   Setting	Example	Description
   Typ usługi	Key Vault	Typ usługi, z którą chcesz połączyć aplikację.
   Nazwa połączenia	keyvault_17d38	Nazwa połączenia, która identyfikuje połączenie między aplikacją a usługą docelową. Użyj nazwy połączenia dostarczonej przez łącznik usługi lub wprowadź własną nazwę połączenia.
   Subscription	my-subscription	Subskrypcja zawierająca usługę docelową (usługę, z którą chcesz nawiązać połączenie). Wartość domyślna to subskrypcja zawierająca aplikację wdrożona w usłudze Azure Spring Apps.
   Skrzynka kluczy	my-keyvault-name	Docelowa usługa Key Vault, z którą chcesz nawiązać połączenie. Jeśli wybierzesz inny typ usługi, wybierz odpowiednie wystąpienie usługi docelowej.
   Typ klienta	SpringBoot	Stos aplikacji, który współpracuje z wybraną usługą docelową. Oprócz platformy SpringBoot i języka Java obsługiwane są również inne stosy.

6. Wybierz pozycję Dalej: Uwierzytelnianie , aby wybrać typ uwierzytelniania. Zalecamy użycie przypisanej przez system tożsamości zarządzanej w celu nawiązania połączenia z usługą Key Vault.

   

7. Wybierz pozycję Dalej: Sieć , aby wybrać konfigurację sieci, a następnie wybierz pozycję Konfiguruj reguły zapory, aby umożliwić dostęp do usługi docelowej , aby aplikacja mogła uzyskać dostęp do usługi Blob Storage.

   

8. Wybierz pozycję Dalej: Przejrzyj i utwórz , aby przejrzeć podane informacje. Poczekaj kilka sekund, aż łącznik usługi zweryfikuje informacje, a następnie wybierz pozycję Utwórz , aby utworzyć połączenie z usługą.

Tożsamość zarządzana (zalecane)

Uruchom polecenie , az spring connection create aby połączyć aplikację wdrożona w usłudze Azure Spring Apps z zasobem usługi Blob Storage z przypisaną przez system tożsamością zarządzaną. To polecenie można uruchomić na dwa różne sposoby:

• Wygeneruj nowe połączenie krok po kroku.

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

• Wygeneruj nowe połączenie jednocześnie. Zastąp symbole zastępcze własnymi informacjami: <source-subscription>, , <source_resource_group>, <azure-spring-apps-resource><app>, <target-subscription><target_resource_group>i <account>.

     az spring connection create storage-blob \                         
     --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.AppPlatform/Spring/<azure-spring-apps-resource>/apps/<app> \
     --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
     --system-identity
  

Wskazówka

Jeśli nie masz konta usługi Blob Storage, uruchom polecenie az spring connection create storage-blob --new --system-identity , aby go utworzyć i połącz go z aplikacją hostowaną w usłudze Azure Spring Apps przy użyciu tożsamości zarządzanej.

Parametry połączenia

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.

Uruchom polecenie , az spring connection create aby połączyć aplikację wdrożona w usłudze Azure Spring Apps z zasobem usługi Blob Storage z parametrami połączenia. To polecenie można uruchomić na dwa różne sposoby:

• Wygeneruj nowe połączenie krok po kroku.

  az spring connection create storage-blob --secret
  

• Wygeneruj nowe połączenie jednocześnie. Zastąp symbole zastępcze własnymi informacjami: <source-subscription>, , <source_resource_group>, <azure-spring-apps-resource><app><target-subscription><target_resource_group><account>, <secret-name>, , i .<secret>

  az spring connection create storage-blob \                         
     --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.AppPlatform/Spring/<azure-spring-apps-resource>/apps/<app> \
     --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
      --secret name=<secret-name> secret=<secret>
  

Wskazówka

Jeśli nie masz konta usługi Blob Storage, uruchom polecenie az spring connection create storage-blob --new --secret , aby go utworzyć i połącz go z aplikacją hostowaną w usłudze Azure Spring Apps przy użyciu parametrów połączenia.

Wyświetlanie połączeń usług

Połączenia usługi Azure Spring Apps są wyświetlane w obszarze Ustawienia > Łącznik usługi.

1. Wybierz > , aby rozwinąć listę i uzyskać dostęp do właściwości wymaganych przez aplikację.

2. Wybierz pozycję Weryfikuj , aby sprawdzić stan połączenia, a następnie wybierz pozycję Dowiedz się więcej , aby przejrzeć szczegóły weryfikacji połączenia.

   

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-resource-name>i <app-name> z poniższego polecenia własnymi informacjami. 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-resource-name> --app <app-name> --output table

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

Treści powiązane

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