Quickstart: Bouwen en implementeren vanuit lokale broncode naar Azure Container Apps
In dit artikel wordt gedemonstreert hoe u een microservice bouwt en implementeert in Azure Container Apps vanuit lokale broncode met behulp van de programmeertaal van uw keuze. In deze quickstart maakt u een back-end-web-API-service die een statische verzameling muziekalbums retourneert.
In de volgende schermopname ziet u de uitvoer van de album-API-service die u implementeert.
Vereisten
U hebt het volgende nodig om dit project te voltooien:
| Vereiste | Instructies |
|---|---|
| Azure-account | Als u nog geen account hebt, maakt u gratis een account. U hebt de machtiging Inzender of Eigenaar voor het Azure-abonnement nodig om door te gaan. Raadpleeg Azure-rollen toewijzen met behulp van Azure Portal voor meer informatie. |
| Git | Installeer Git. |
| Azure-CLI | Installeer de Azure CLI. |
Instellingen
Als u zich wilt aanmelden bij Azure vanuit de CLI, voert u de volgende opdracht uit en volgt u de aanwijzingen om het verificatieproces te voltooien.
az login
Voer de upgradeopdracht uit om ervoor te zorgen dat u de nieuwste versie van de CLI uitvoert.
az upgrade
Installeer of werk vervolgens de Azure Container Apps-extensie voor de CLI bij.
az extension add --name containerapp --upgrade --allow-preview true
Nu de huidige extensie is geïnstalleerd, registreert u de Microsoft.App en Microsoft.OperationalInsights naamruimten.
az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights
Omgevingsvariabelen maken
Nu de CLI-installatie is voltooid, kunt u de omgevingsvariabelen definiëren die in dit artikel worden gebruikt.
Definieer de volgende variabelen in uw bash-shell.
export RESOURCE_GROUP="album-containerapps"
export LOCATION="canadacentral"
export ENVIRONMENT="env-album-containerapps"
export API_NAME="album-api"
De voorbeeldcode halen
Voer de volgende opdracht uit om de voorbeeldtoepassing te klonen in de taal van uw keuze en wijzig deze in de projectbronmap.
git clone https://github.com/azure-samples/containerapps-albumapi-csharp.git
cd containerapps-albumapi-csharp/src
De container-app bouwen en implementeren
Voer eerst de volgende opdracht uit om de resourcegroep te maken die de resources bevat die u in deze quickstart maakt.
az group create --name $RESOURCE_GROUP --location $LOCATION
Bouw en implementeer uw eerste container-app met de containerapp up opdracht. Met deze opdracht wordt het volgende uitgevoerd:
- De resourcegroep maken
- Een Azure Container Registry maken
- Bouw de containerinstallatiekopieën en push deze naar het register
- De Container Apps-omgeving maken met een Log Analytics-werkruimte
- De container-app maken en implementeren met behulp van de ingebouwde containerinstallatiekopie
De up opdracht maakt gebruik van het Dockerfile in de projectmap om de containerinstallatiekopieën te bouwen. De EXPOSE instructie in het Dockerfile definieert de doelpoort. Dit is de poort die wordt gebruikt om inkomend verkeer naar de container te verzenden.
In het volgende codevoorbeeld geeft de . (punt) aan containerapp up dat deze moet worden uitgevoerd in de huidige map van het project dat ook het Dockerfile bevat.
az containerapp up \
--name $API_NAME \
--resource-group $RESOURCE_GROUP \
--location $LOCATION \
--environment $ENVIRONMENT \
--source .
Notitie
Als de opdracht een fout retourneert met het bericht 'AADSTS50158: Externe beveiligingsvraag niet tevreden', voert az login --scope https://graph.microsoft.com//.default u uit om u aan te melden met de vereiste machtigingen en voert u de az containerapp up opdracht opnieuw uit.
Implementatie verifiëren
Zoek de URL van de container-app in de uitvoer van de az containerapp up opdracht. Navigeer naar de URL in uw browser. Voeg /albums toe aan het einde van de URL om het antwoord van de API te bekijken.
Limieten
De maximale grootte voor het uploaden van broncode is 200 MB. Als het uploaden de limiet overschrijdt, wordt fout 413 geretourneerd.
Resources opschonen
Als u niet doorgaat met de zelfstudie Een front-end implementeren, kunt u de Azure-resources die tijdens deze quickstart zijn gemaakt, verwijderen met de volgende opdracht.
Let op
Met de volgende opdracht verwijdert u de opgegeven resourcegroep en alle resources erin. Als de groep resources bevat die buiten het bereik van deze quickstart vallen, worden ze ook verwijderd.
az group delete --name $RESOURCE_GROUP
Tip
Ondervindt u problemen? Laat het ons weten op GitHub door een probleem te openen in de Azure Container Apps-opslagplaats.
Volgende stappen
Nadat u deze quickstart hebt voltooid, kunt u doorgaan met zelfstudie: Communicatie tussen microservices in Azure Container Apps om te leren hoe u een front-endtoepassing implementeert die de API aanroept.