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

Artikel
10/14/2024

In deze quickstart ziet u hoe u Azure Container 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.

Belangrijk

Serviceconnector in Container Apps is momenteel in preview. Raadpleeg de Aanvullende voorwaarden voor Microsoft Azure-previews voor juridische voorwaarden die van toepassing zijn op Azure-functies die in bèta of preview zijn of die anders nog niet algemeen beschikbaar zijn.

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 is geïmplementeerd in 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.

Eerste installatie

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

Maak een verbinding met een beheerde identiteit of een toegangssleutel.

Beheerde identiteit
Toegangssleutel

Belangrijk

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

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
```

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.

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.

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
```

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.

Volgende stappen

Interne werking van serviceconnector

Delen via