Guida introduttiva: Eseguire la distribuzione in app contenitore di Azure con IntelliJ IDEA

Questo articolo illustra come distribuire un'applicazione in contenitori in App Azure Container usando Azure Toolkit for IntelliJ IDEA. L'articolo usa un servizio API Web back-end di esempio che restituisce una raccolta statica di album musicali.

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Se non si ha già una sottoscrizione, creare un account gratuito prima di iniziare.
• Java Development Kit (JDK) supportato. Per altre informazioni sui JDK disponibili per l'uso durante lo sviluppo in Azure, vedere Supporto java in Azure e Azure Stack.
• IntelliJ IDEA, Ultimate o Community Edition.
• Maven 3.5.0+.
• Un client Docker.
• Azure Toolkit for IntelliJ. Per altre informazioni, vedere Installare Azure Toolkit for IntelliJ. È anche necessario accedere all'account Azure per Azure Toolkit for IntelliJ. Per altre informazioni, vedere Istruzioni di accesso per Azure Toolkit for IntelliJ.

Clonare il progetto

1. Usare i comandi seguenti per clonare l'app di esempio ed eseguire il check-out del IDE ramo:

   git clone https://github.com/Azure-Samples/containerapps-albumapi-java
   cd containerapps-albumapi-java
   git checkout IDE
   

2. Selezionare Apri per aprire il progetto in IntelliJ IDEA.

Compilare ed eseguire il progetto in locale

1. Usare il comando seguente per compilare il progetto con Maven:

   mvn clean package -DskipTests
   

2. Per verificare che l'applicazione sia in esecuzione, aprire un browser e passare a http://localhost:8080/albums. La pagina restituisce un elenco di oggetti JSON simili all'output del comando seguente:

   java -jar target\containerapps-albumapi-java-0.0.1-SNAPSHOT.jar
   

Eseguire il push dell'immagine in un Registro Azure Container

Per distribuire il progetto in App Azure Container, è necessario compilare l'immagine del contenitore ed eseguirne prima il push in un Registro Azure Container.

1. Nella visualizzazione Azure Explorer espandere il nodo Azure, fare clic con il pulsante destro del mouse su Registri contenitori e quindi scegliere Crea nel portale di Azure.

2. Nella pagina Crea registro contenitori immettere le informazioni seguenti:

   • Sottoscrizione: specifica la sottoscrizione di Azure che si vuole usare per il registro contenitori.
   • Gruppo di risorse: specifica il gruppo di risorse per il registro contenitori. Selezionare una delle opzioni seguenti:
     • Crea nuovo: specifica che si intende creare un nuovo gruppo di risorse.
     • Usa esistente: specifica che è necessario selezionare da un elenco di gruppi di risorse associati all'account Azure.
   • Nome registro: specifica un nome per il nuovo registro contenitori.
   • Località: specifica l'area in cui viene creato il registro contenitori, ad esempio Stati Uniti occidentali.
   • SKU: specifica il livello di servizio per il registro contenitori. Per questa esercitazione selezionare Basic.

3. Selezionare Rivedi e crea e verificare che le informazioni siano corrette. Quindi, selezionare Crea.

4. Nella scheda Progetto passare al progetto e aprire Dockerfile.

5. Selezionare l'icona di Azure e quindi selezionare Push Image to Registro Azure Container (Esegui push immagine in Registro Azure Container).

6. Selezionare il Registro di sistema creato nel passaggio precedente, immettere le informazioni seguenti e quindi selezionare Esegui.

   • Nome repository: specifica il nome del repository.
   • Nome tag: specifica la versione di un'immagine o di un altro artefatto.

   

Creare un ambiente e un'app contenitore

Usare la procedura seguente per configurare l'ambiente e distribuire un'app contenitore in Azure:

1. Fare clic con il pulsante destro del mouse su Ambiente app contenitore nella visualizzazione Azure Explorer e quindi scegliere Crea ambiente app contenitore.

2. Nella pagina Crea ambiente app contenitore immettere le informazioni seguenti e quindi selezionare OK.

   • Sottoscrizione: specifica la sottoscrizione di Azure che si vuole usare.
   • Gruppo di risorse: specifica il gruppo di risorse per le app contenitore. Selezionare una delle opzioni seguenti:
     • Crea nuovo: specifica che si intende creare un nuovo gruppo di risorse.
     • Usa esistente: specifica che è necessario selezionare da un elenco di gruppi di risorse associati all'account Azure.
   • Nome: specifica il nome per il nuovo ambiente di app contenitore.
   • Area: specifica l'area appropriata, ad esempio Stati Uniti orientali.
   • Area di lavoro Log Analytics: specifica l'area di lavoro Log Analytics che si vuole usare o accettare l'impostazione predefinita.

   

3. Fare clic con il pulsante destro del mouse sull'ambiente delle app contenitore creato e selezionare Crea>app contenitore in Azure Explorer. Immettere le informazioni seguenti:

   • Sottoscrizione: specifica la sottoscrizione di Azure che si vuole usare.
   • Gruppo di risorse: specifica il gruppo di risorse per le app contenitore. Selezionare una delle opzioni seguenti:
     • Crea nuovo: specifica che si intende creare un nuovo gruppo di risorse.
     • Usa esistente: specifica che è necessario selezionare da un elenco di gruppi di risorse associati all'account Azure.
   • Nome: specifica il nome di una nuova app contenitore.
   • Area: specifica l'area appropriata, ad esempio Stati Uniti orientali.
   • Ambiente: specifica l'ambiente di app contenitore che si vuole usare.
   • Guida introduttiva: selezionare Usa immagine di avvio rapido.

   

4. Seleziona OK. Il toolkit visualizza un messaggio di stato quando la creazione dell'app ha esito positivo.

Distribuire l'app contenitore

1. Nella scheda Progetto passare al progetto e aprire Dockerfile.

   

2. Selezionare l'icona di Azure e quindi selezionare Deploy Image to Container App (Distribuisci immagine nell'app contenitore).

   

3. Nella pagina Deploy Image to Azure Container Apps (Distribuisci immagine in app Azure Container) immettere le informazioni seguenti e quindi selezionare Esegui.

   • Dockerfile/Image: specifica il percorso del Dockerfile o accetta l'impostazione predefinita.
   • Registro Contenitori: specifica il registro contenitori che si vuole usare.
   • Nome repository: specifica il nome del repository che si vuole usare nel Registro Container.
   • Nome tag: specifica il nome del tag che si vuole usare nel Registro Container.
   • App contenitore: specifica l'app contenitore in cui si vuole eseguire la distribuzione.
   • Ingresso: abilitare l'ingresso per le applicazioni che richiedono un endpoint HTTP o TCP. Selezionare Abilita.
   • Traffico esterno: abilitare il traffico esterno per le applicazioni che necessitano di un endpoint HTTP o TCP. Selezionare Abilita.
   • Porta di destinazione: impostare questo valore sul numero di porta usato dal contenitore. Aprire la porta 8080 in questo passaggio.

   

4. Al termine della distribuzione, Azure Toolkit for IntelliJ visualizza una notifica. Selezionare Sfoglia per aprire l'app distribuita in un browser.

   

Nella barra degli indirizzi del browser aggiungere il /albums percorso alla fine dell'URL dell'app per visualizzare i dati da una richiesta API di esempio.

Pulire le risorse

Se si vuole pulire e rimuovere una risorsa di App Contenitore di Azure, è possibile eliminare la risorsa o il gruppo di risorse. L'eliminazione del gruppo di risorse comporta anche l'eliminazione di tutte le altre risorse associate. Per pulire le risorse, seguire questa procedura:

1. Per eliminare le risorse di App Azure Container, passare alla barra laterale di Azure Explorer a sinistra e individuare l'elemento Ambiente app contenitore.

2. Fare clic con il pulsante destro del mouse sul servizio App Azure Container da eliminare e quindi scegliere Elimina.

3. Per eliminare il gruppo di risorse, visitare il portale di Azure ed eliminare manualmente le risorse nella sottoscrizione.

Passaggi successivi

• Panoramica di Java in App Contenitore di Azure