Quickstart: Een artefactbestand implementeren in Azure Container Apps (preview)
In deze quickstart leert u hoe u een container-app implementeert vanuit een vooraf samengesteld artefactbestand. In het voorbeeld in dit artikel wordt een Java-toepassing geïmplementeerd met behulp van een JAR-bestand, dat een Java-specifiek manifestbestand bevat. Uw taak is om een back-end-web-API-service te maken die een statische verzameling muziekalbums retourneert. Nadat u deze quickstart hebt voltooid, kunt u doorgaan met communicatie tussen microservices om te leren hoe u een front-endtoepassing implementeert die de API aanroept.
In de volgende schermopname ziet u de uitvoer van de album-API-service die u implementeert.
Vereisten
| 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. |
| GitHub-account | Ontvang er gratis een. |
| git | Git installeren |
| Azure-CLI | Installeer de Azure CLI. |
| Java | De JDK installeren, 17 of hoger aanbevelen |
| Maven | Installeer maven. |
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.
Als u fouten ontvangt over ontbrekende parameters wanneer u opdrachten uitvoert az containerapp in Azure CLI of cmdlets vanuit de Az.App module in Azure PowerShell, moet u ervoor zorgen dat de nieuwste versie van de Azure Container Apps-extensie is geïnstalleerd.
az extension add --name containerapp --upgrade
Notitie
Vanaf mei 2024 schakelen Azure CLI-extensies standaard geen preview-functies meer in. Als u toegang wilt krijgen tot de preview-functies van Container Apps, installeert u de Container Apps-extensie met --allow-preview true.
az extension add --name containerapp --upgrade --allow-preview true
Nu de huidige extensie of module 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 uw Azure CLI-installatie is voltooid, kunt u de omgevingsvariabelen definiëren die in dit artikel worden gebruikt.
Definieer de volgende variabelen in uw bash-shell.
RESOURCE_GROUP="album-containerapps"
LOCATION="canadacentral"
ENVIRONMENT="env-album-containerapps"
API_NAME="album-api"
SUBSCRIPTION=<YOUR_SUBSCRIPTION_ID>
Indien nodig kunt u een query uitvoeren op uw abonnements-id.
az account list --output table
De GitHub-opslagplaats voorbereiden
Begin met het klonen van de voorbeeldopslagplaats.
Gebruik de volgende Git-opdracht om de voorbeeld-app te klonen in de map code-naar-cloud :
git clone https://github.com/azure-samples/containerapps-albumapi-java code-to-cloud
cd code-to-cloud
Een JAR-bestand bouwen
Notitie
Het Java-voorbeeld ondersteunt alleen een Maven-build, wat resulteert in een uitvoerbaar JAR-bestand. De build maakt gebruik van standaardinstellingen omdat het doorgeven van omgevingsvariabelen niet wordt ondersteund.
Bouw het project met Maven.
mvn clean package -DskipTests
Het project lokaal uitvoeren
java -jar target\containerapps-albumapi-java-0.0.1-SNAPSHOT.jar
Als u wilt controleren of de toepassing wordt uitgevoerd, opent u een browser en gaat u naar http://localhost:8080/albums. De pagina retourneert een lijst met de JSON-objecten.
Het artefact implementeren
Bouw en implementeer uw eerste container-app vanuit uw lokale JAR-bestand met de containerapp up opdracht.
Met deze opdracht gebeurt het volgende:
- Hiermee maakt u de resourcegroep
- Hiermee maakt u een Azure Container Registry
- Hiermee wordt de containerinstallatiekopieën gebouwd en naar het register gepusht
- Maakt de Container Apps-omgeving met een Log Analytics-werkruimte
- Maakt en implementeert de container-app met behulp van een openbare containerinstallatiekopieën
De up opdracht maakt gebruik van het Docker-bestand in de hoofdmap van de opslagplaats om de containerinstallatiekopieën te bouwen. De EXPOSE instructie in het Docker-bestand definieert de doelpoort. Een Docker-bestand is echter niet vereist om een container-app te bouwen.
Notitie
Opmerking: Wanneer u containerapp up in combinatie met een Docker-less-codebasis gebruikt, gebruikt u de parameter zodat de --location toepassing wordt uitgevoerd op een andere locatie dan US - oost.
az containerapp up \
--name $API_NAME \
--resource-group $RESOURCE_GROUP \
--location $LOCATION \
--environment $ENVIRONMENT \
--artifact ./target/containerapps-albumapi-java-0.0.1-SNAPSHOT.jar \
--ingress external \
--target-port 8080 \
--subscription $SUBSCRIPTION
Implementatie verifiëren
Kopieer de FQDN naar een webbrowser. Ga vanuit uw webbrowser naar het /albums eindpunt van de FQDN.
Een WAR-bestand implementeren
U kunt uw container-app ook implementeren vanuit een WAR-bestand.
Resources opschonen
Als u deze toepassing niet meer gaat gebruiken, kunt u het Azure Container Apps-exemplaar en alle bijbehorende services verwijderen door de resourcegroep te verwijderen.
Volg deze stappen om de resources te verwijderen die u hebt gemaakt:
az group delete \
--resource-group $RESOURCE_GROUP
Tip
Ondervindt u problemen? Laat het ons weten op GitHub door een probleem te openen in de Azure Container Apps-opslagplaats.