Quickstart: Uw eerste Java-toepassing starten in Azure Container Apps
In dit artikel leest u hoe u de Spring PetClinic-voorbeeldtoepassing implementeert om uit te voeren in Azure Container Apps. In plaats van handmatig een Dockerfile te maken en rechtstreeks een containerregister te gebruiken, kunt u uw Java-toepassing rechtstreeks implementeren vanuit een Java Archive-bestand (JAR) of een WAR-bestand (Web Application Archive).
Aan het einde van deze zelfstudie implementeert u een webtoepassing die u kunt beheren via Azure Portal.
De volgende afbeelding is een schermopname van hoe uw toepassing eruitziet zodra deze in Azure is geïmplementeerd.
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. |
| Cli-extensie voor Container Apps | Gebruik versie 0.3.47 of hoger. Gebruik de az extension add --name containerapp --upgrade --allow-preview opdracht om de nieuwste versie te installeren. |
| Java | Installeer de Java Development Kit. Gebruik versie 17 of hoger. |
| Apache Maven | Download en installeer Apache Maven. |
Het project voorbereiden
Kloon de Spring PetClinic-voorbeeldtoepassing naar uw computer.
git clone https://github.com/spring-projects/spring-petclinic.git
git clone https://github.com/spring-petclinic/spring-framework-petclinic.git
Het project bouwen
Ga naar de spring-petclinische map.
cd spring-petclinic
Schoon het Maven-buildgebied op, compileer de code van het project en maak een JAR-bestand, allemaal tijdens het overslaan van tests.
mvn clean verify
Nadat u de buildopdracht hebt uitgevoerd, wordt een bestand met de naam petclinic.jar gegenereerd in de map /target .
Notitie
Indien nodig kunt u de Tomcat-versie opgeven in de omgevingsvariabelen van de Java-build.
Schakel over naar de map spring-framework-petclinic .
cd spring-framework-petclinic
Schoon het Maven-buildgebied op, compileer de code van het project en maak een WAR-bestand, allemaal tijdens het overslaan van tests.
mvn clean verify
Nadat u de build-opdracht hebt uitgevoerd, wordt een bestand met de naam petclinic.war gegenereerd in de map /target .
Het project implementeren
Implementeer het JAR-pakket in Azure Container Apps.
Notitie
Indien nodig kunt u de JDK-versie opgeven in de omgevingsvariabelen van de Java-build.
U kunt nu uw WAR-bestand implementeren met de az containerapp up CLI-opdracht.
az containerapp up \
--name <CONTAINER_APP_NAME> \
--resource-group <RESOURCE_GROUP> \
--subscription <SUBSCRIPTION_ID>\
--location <LOCATION> \
--environment <ENVIRONMENT_NAME> \
--artifact <JAR_FILE_PATH_AND_NAME> \
--ingress external \
--target-port 8080 \
--query properties.configuration.ingress.fqdn
Notitie
De standaardversie van JDK is 17. Als u de JDK-versie wilt wijzigen voor compatibiliteit met uw toepassing, kunt u het --build-env-vars BP_JVM_VERSION=<YOUR_JDK_VERSION> argument gebruiken om het versienummer aan te passen.
U vindt meer toepasselijke omgevingsvariabelen voor build in Java build-omgevingsvariabelen.
Implementeer het WAR-pakket in Azure Container Apps.
U kunt nu uw WAR-bestand implementeren met de az containerapp up CLI-opdracht.
az containerapp up \
--name <CONTAINER_APP_NAME> \
--resource-group <RESOURCE_GROUP> \
--subscription <SUBSCRIPTION>\
--location <LOCATION> \
--environment <ENVIRONMENT_NAME> \
--artifact <WAR_FILE_PATH_AND_NAME> \
--build-env-vars BP_TOMCAT_VERSION=10.* \
--ingress external \
--target-port 8080 \
--query properties.configuration.ingress.fqdn
Notitie
De standaardversie van Tomcat is 9. Als u de Tomcat-versie wilt wijzigen voor compatibiliteit met uw toepassing, kunt u het --build-env-vars BP_TOMCAT_VERSION=<YOUR_TOMCAT_VERSION> argument gebruiken om het versienummer aan te passen.
In dit voorbeeld is de Tomcat-versie ingesteld op 10 (inclusief eventuele secundaire versies) door de BP_TOMCAT_VERSION=10.* omgevingsvariabele in te stellen.
U vindt meer toepasselijke omgevingsvariabelen voor build in Java build-omgevingsvariabelen.
App-status controleren
In dit voorbeeld containerapp up bevat de opdracht het --query properties.configuration.ingress.fqdn argument, dat de FQDN (Fully Qualified Domain Name) retourneert, ook wel de URL van de app genoemd.
Bekijk de toepassing door deze URL in een browser te plakken. Uw app moet er ongeveer uitzien als in de volgende schermopname.