Condividi tramite


Guida introduttiva: Avvia la tua prima applicazione Java in Azure Container Apps usando un file WAR o JAR

Questo articolo illustra come distribuire l'applicazione di esempio Spring PetClinic in App Azure Container usando un file di archivio di applicazioni Web (WAR) o un file jar (Java Archive).

Sono disponibili diverse opzioni per la distribuzione di applicazioni Java, incluse le opzioni seguenti:

  • Distribuzione da un file system locale o da un repository di codice.
  • Distribuzione con Maven o un IDE.
  • Distribuzione tramite un file WAR, un file JAR o direttamente dal codice sorgente.

Al termine di questa esercitazione si distribuisce un'applicazione Web che è possibile gestire tramite il portale di Azure. Lo screenshot seguente mostra la home page dell'applicazione PetClinic distribuita in App Azure Container:

Screenshot della pagina principale dell'applicazione PetClinic.

Prerequisiti

Compilare il progetto

Compilare il progetto attenendosi alla procedura seguente:

  1. Clonare il "repository Azure Container Apps Java Samples" usando il comando seguente:

    git clone https://github.com/Azure-Samples/azure-container-apps-java-samples.git
    
  1. Clonare il repository Spring PetClinic Sample Application usando il comando seguente:

    git clone https://github.com/spring-petclinic/spring-framework-petclinic.git
    
  1. Passare alla cartella spring-petclinic usando il comando seguente:

    cd azure-container-apps-java-samples/spring-petclinic/spring-petclinic/
    
  2. Inizializzare e aggiornare il repository Spring PetClinic Sample Application alla versione più recente usando il comando seguente:

    git submodule update --init --recursive
    
  3. Usare il comando seguente per pulire l'area di compilazione Maven, compilare il codice del progetto e creare un file JAR, ignorando tutti i test durante questi processi:

    mvn clean verify
    

È ora disponibile un file /target/petclinic.jar .

  1. Passare alla cartella spring-framework-petclinic usando il comando seguente:

    cd spring-framework-petclinic
    
  2. Usare il comando seguente per pulire l'area di compilazione Maven, compilare il codice del progetto e creare un file JAR, ignorando tutti i test durante questi processi:

    mvn clean verify
    

È ora disponibile un file /target/petclinic.war .

Distribuire il progetto

Distribuire il pacchetto JAR in App Azure Container usando il comando seguente:

Nota

La versione predefinita di JDK è 17. È possibile specificare la versione usando le variabili di ambiente. Per modificare la versione di JDK per la compatibilità con l'applicazione, usare l'argomento --build-env-vars BP_JVM_VERSION=<your-JDK-version> . Per altre informazioni, vedere Creare variabili di ambiente per Java in App Contenitore di Azure (anteprima).For more information, see Build environment variables for Java in Azure Container Apps (preview).

az containerapp up \
    --resource-group <resource-group> \
    --name <container-app-name> \
    --subscription <subscription-ID>\
    --location <location> \
    --environment <environment-name> \
    --artifact <JAR-file-path-and-name> \
    --ingress external \
    --target-port 8080 \
    --query properties.configuration.ingress.fqdn

Distribuire il file WAR in App Azure Container usando il comando seguente:

Nota

La versione predefinita di Tomcat è 9. Per modificare la versione per la compatibilità con l'applicazione, usare l'argomento --build-env-vars BP_TOMCAT_VERSION=<your-Tomcat-version> . In questo esempio la versione di Tomcat è impostata su 10, incluse le eventuali versioni secondarie, impostando BP_TOMCAT_VERSION=10.*. Per altre informazioni, vedere Creare variabili di ambiente per Java in App Contenitore di Azure (anteprima).For more information, see Build environment variables for Java in Azure Container Apps (preview).

az containerapp up \
    --resource-group <resource-group> \
    --name <container-app-name> \
    --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

Verificare lo stato dell'app

In questo esempio, il comando containerapp up include l'argomento --query properties.configuration.ingress.fqdn, che restituisce il nome di dominio completo (FQDN), noto anche come URL dell'app.

Visualizzare l'applicazione incollando questo URL in un browser.

Pulire le risorse

Se si prevede di continuare a lavorare con altre guide introduttive ed esercitazioni, è possibile lasciare queste risorse sul posto. Quando le risorse non sono più necessarie, è possibile rimuoverle per evitare addebiti di Azure usando il comando seguente:

az group delete --name <resource-group>