Quickstart: Een serviceverbinding maken in Azure Container Apps met de Azure CLI (preview)

In deze quickstart ziet u hoe u Azure Container Apps verbindt met andere cloudresources met behulp van de Azure CLI en Service Connector (preview). Met serviceconnector kunt u snel rekenservices verbinden met cloudservices, terwijl u de verificatie- en netwerkinstellingen van uw verbinding beheert.

Vereisten

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

• Ten minste één toepassing die is geïmplementeerd in Azure Container Apps in een regio die wordt ondersteund door Service Connector. Als u er nog geen hebt, maakt en implementeert u een container in Container 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 moet zijn geïnstalleerd. 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 Container Apps-extensie moet worden geïnstalleerd in de Azure CLI of de Cloud Shell. Voer uit az extension add --name containerappom het te installeren.

Uw omgeving instellen

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 containerapp connection list-support-types uit om een lijst met ondersteunde doelservices voor Container Apps op te halen.

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

Een serviceverbinding maken (preview)

Maak een verbinding met een beheerde identiteit of een toegangssleutel.

Beheerde identiteit

Belangrijk

Als u een beheerde identiteit wilt gebruiken, moet u over de machtiging beschikken om de roltoewijzing van Microsoft Entra te wijzigen. Vraag de eigenaar van uw abonnement u deze machtiging te verlenen of gebruik in plaats daarvan een toegangssleutel om de verbinding te maken.

1. Voer de az containerapp connection create opdracht uit om een serviceverbinding te maken vanuit Container Apps naar een Blob Storage met een door het systeem toegewezen beheerde identiteit.

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

2. Geef de volgende informatie op in de azure CLI-aanvraag:

   Instelling	Beschrijving
   The resource group that contains the container app	De naam van de resourcegroep met de container-app.
   Name of the container app	De naam van de container-app.
   The container where the connection information will be saved	De naam van de container-app.
   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.

Notitie

Als u geen Blob Storage hebt, kunt u een az containerapp connection create storage-blob --new --system-identity nieuwe Blob Storage inrichten en deze rechtstreeks verbinden met uw container-app 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 containerapp connection create opdracht uit om een serviceverbinding te maken tussen Container Apps en Azure Blob Storage met behulp van een toegangssleutel.

   az containerapp connection create storage-blob --secret
   

2. Geef de volgende informatie op in de azure CLI-aanvraag:

   Instelling	Beschrijving
   The resource group that contains the container app	De naam van de resourcegroep met de container-app.
   Name of the container app	De naam van de container-app.
   The container where the connection information will be saved	De naam van de container-app.
   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 een az containerapp connection create storage-blob --new --secret nieuwe Blob Storage inrichten en deze rechtstreeks verbinden met uw container-app met behulp van een verbindingsreeks.

Verbindingen weergeven

Gebruik de Azure CLI-opdracht az containerapp connection list om alle ingerichte verbindingen van uw container-app weer te geven. Vervang de tijdelijke aanduidingen <container-app-resource-group> en <container-app-name> de onderstaande opdracht door de resourcegroep en de naam van uw container-app. U kunt ook de --output table optie verwijderen om meer informatie over uw verbindingen weer te geven.

az containerapp connection list -g "<container-app-resource-group>" --name "<container-app-name>" --output table

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

Verwante koppelingen

• Container Apps: Java Quarkus-app verbinden met PostgreSQL
• Container Apps: ASP.NET Core-app verbinden met App Configuration