Quickstart: Een serviceverbinding maken in Azure Spring Apps met de Azure CLI

In deze quickstart ziet u hoe u Azure Spring Apps verbindt met andere cloudresources met behulp van de Azure CLI en Service Connector.

Met serviceconnector kunt u snel rekenservices verbinden met cloudservices, terwijl u de verificatie- en netwerkinstellingen van uw verbinding beheert.

Vereisten

• Een Azure-abonnement. Als u geen Azure-abonnement hebt, kunt u een gratis Azure-account maken voordat u begint.

• Ten minste één toepassing die wordt gehost door Azure Spring Apps in een regio die wordt ondersteund door Service Connector. Als u er nog geen hebt, implementeert u uw eerste toepassing in Azure Spring Apps.

• Gebruik de Bash-omgeving in Azure Cloud Shell. Zie quickstart voor Bash in Azure Cloud Shell voor meer informatie.

  

• Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.

  • Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht az login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij Azure CLI voor aanvullende aanmeldingsopties.

  • Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.

  • Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.

• Versie 2.37.0 of hoger van de Azure CLI. Als u wilt upgraden naar de nieuwste versie, voert u uit az upgrade. Als u Azure Cloud Shell gebruikt, is de nieuwste versie al geïnstalleerd.

• De Azure Spring Apps-extensie moet zijn geïnstalleerd in de Azure CLI of de Cloud Shell. Voer uit az extension add --name springom het te installeren.

Initiële installatie

1. Als u serviceconnector voor het eerst gebruikt, start u met de opdracht az provider register om de serviceconnectorresourceprovider te registreren.

   az provider register -n Microsoft.ServiceLinker
   

   Tip

   U kunt controleren of de resourceprovider al is geregistreerd door de opdracht az provider show -n "Microsoft.ServiceLinker" --query registrationStateuit te voeren. Als de uitvoer is Registered, is serviceconnector al geregistreerd.

2. Voer desgewenst de opdracht az spring connection list-support-types uit om een lijst met ondersteunde doelservices voor Azure Spring Apps op te halen.

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

   Tip

   Als de az spring opdracht niet wordt herkend door het systeem, controleert u of u de vereiste extensie hebt geïnstalleerd door uit te voeren az extension add --name spring.

Een serviceverbinding maken

Maak een verbinding vanuit Azure Spring Apps met behulp van een beheerde identiteit of een toegangssleutel.

Beheerde identiteit

Belangrijk

Als u een beheerde identiteit wilt gebruiken, moet u over de machtiging beschikken om roltoewijzingen in Microsoft Entra-id te wijzigen. Zonder deze machtiging mislukt het maken van de verbinding. Vraag de eigenaar van uw abonnement u een roltoewijzingsmachtiging te verlenen of gebruik een toegangssleutel om de verbinding te maken.

1. Voer de az spring connection create opdracht uit om een serviceverbinding met een Blob Storage te maken met een door het systeem toegewezen beheerde identiteit

2. Geef de volgende informatie op in de CLI- of Cloud Shell-aanvraag:

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

   Instelling	Beschrijving
   The resource group which contains the spring-cloud	De naam van de resourcegroep die een app bevat die wordt gehost door Azure Spring Apps.
   Name of the spring-cloud service	De naam van de Azure Spring Apps-resource.
   Name of the spring-cloud app	De naam van de toepassing die wordt gehost door Azure Spring Apps die verbinding maakt met de doelservice.
   The resource group which contains the storage account	De naam van de resourcegroep met het opslagaccount.
   Name of the storage account	De naam van het opslagaccount waarmee u verbinding wilt maken. In deze handleiding gebruiken we een Blob Storage.

Tip

Als u geen Blob Storage hebt, kunt u uitvoeren az spring connection create storage-blob --new --system-identity om een nieuwe Blob Storage in te richten en deze rechtstreeks te verbinden met uw toepassing die wordt gehost door Azure Spring Apps met behulp van een beheerde identiteit.

Toegangssleutel

Waarschuwing

Microsoft raadt u aan de veiligste verificatiestroom te gebruiken die beschikbaar is. De verificatiestroom die in deze procedure wordt beschreven, vereist een zeer hoge mate van vertrouwen in de toepassing en brengt risico's met zich mee die niet aanwezig zijn in andere stromen. U moet deze stroom alleen gebruiken wanneer andere veiligere stromen, zoals beheerde identiteiten, niet haalbaar zijn.

1. Voer de az spring connection create opdracht uit om een serviceverbinding te maken tussen Azure Spring Apps en een Azure Blob Storage met behulp van een toegangssleutel.

   az spring connection create storage-blob --secret
   

2. Geef de volgende informatie op in de CLI- of Cloud Shell-aanvraag:

   Instelling	Beschrijving
   The resource group which contains the spring-cloud	De naam van de resourcegroep die de app bevat die wordt gehost door Azure Spring Apps.
   Name of the spring-cloud service	De naam van de Azure Spring Apps-resource.
   Name of the spring-cloud app	De naam van de toepassing die wordt gehost door Azure Spring Apps die verbinding maakt met de doelservice.
   The resource group which contains the storage account	De naam van de resourcegroep met het opslagaccount.
   Name of the storage account	De naam van het opslagaccount waarmee u verbinding wilt maken. In deze handleiding gebruiken we een Blob Storage.

Tip

Als u geen Blob Storage hebt, kunt u uitvoeren az spring connection create storage-blob --new --secret om een nieuwe Blob Storage in te richten en deze rechtstreeks te verbinden met uw toepassing die wordt gehost door Azure Spring Apps met behulp van een verbindingsreeks.

Verbindingen weergeven

Voer de opdracht uit az spring connection list om alle ingerichte verbindingen van Uw Azure Spring Apps weer te geven.

Vervang de tijdelijke aanduidingen <azure-spring-apps-resource-group><azure-spring-apps-name>en <app-name> gebruik de onderstaande opdracht door de naam van uw Azure Spring Apps-resourcegroep, de naam van uw Azure Spring Apps-resource en de naam van uw toepassing. U kunt ook de --output table optie verwijderen om meer informatie over uw verbindingen weer te geven.

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

In de uitvoer wordt ook de inrichtingsstatus van uw verbindingen weergegeven: mislukt of geslaagd.

Volgende stappen

Raadpleeg de onderstaande handleidingen voor meer informatie over Service Connector en Azure Spring Apps.

Zelfstudie: Azure Spring Apps + MySQL

Zelfstudie: Azure Spring Apps + Apache Kafka in Confluent Cloud