Distribuire un'app Java in app Web di Azure per contenitori tramite Azure Toolkit for IntelliJ

  • Articolo

I contenitori Docker sono un metodo molto diffuso per distribuire applicazioni Web. L'uso dei contenitori Docker permette agli sviluppatori di consolidare tutti i file di progetto e le dipendenze in un unico pacchetto per la distribuzione in un server. Azure Toolkit for IntelliJ semplifica questo processo per gli sviluppatori Java aggiungendo funzionalità per la distribuzione di contenitori in Microsoft Azure.

Questo articolo indica i passaggi necessari per creare un'app Web Hello World di base e pubblicarla in un contenitore Linux in Azure usando Azure Toolkit for IntelliJ.

Prerequisiti

Nota

Per completare i passaggi di questa esercitazione, è necessario configurare Docker in modo da esporre il daemon sulla porta 2375 senza TLS. È possibile configurare questa impostazione durante l'installazione di Docker o tramite il menu delle impostazioni di Docker.

Docker settings menu

Installazione e accesso

La procedura seguente illustra il processo di accesso ad Azure nell'ambiente di sviluppo IntelliJ.

  1. Se non è stato installato il plug-in, vedere Installazione di Azure Toolkit for IntelliJ.

  2. Per accedere all'account Azure, passare alla barra laterale sinistra di Azure Explorer e quindi fare clic sull'icona Azure Sign In (Accesso ad Azure). In alternativa, è possibile passare a Tools (Strumenti), espandere Azure e fare clic su Azure Sign in (Accesso ad Azure).

    Sign in to Azure on IntelliJ.

  3. Nella finestra Azure Sign In (Accesso ad Azure) selezionare Device Login (Accesso dispositivo) e quindi fare clic su Sign in (Accedi) (altre opzioni di accesso).

  4. Nella finestra di dialogo Azure Device Login (Accesso dispositivo Azure) fare clic su Copy&Open (Copia e apri).

  5. Nel browser incollare il codice dispositivo (copiato facendo clic su Copy&Open nell'ultimo passaggio) e quindi fare clic su Avanti.

  6. Selezionare l'account Azure e completare le procedure di autenticazione necessarie per eseguire l'accesso.

  7. Dopo l'accesso, chiudere il browser e tornare all'IDE di IntelliJ. Nella finestra di dialogo Select Subscriptions (Seleziona sottoscrizioni) selezionare le sottoscrizioni da usare e quindi fare clic su Select (Seleziona).

Creazione di un nuovo progetto di app Web

  1. Fare clic su File, espandere New (Nuovo) e quindi fare clic su Project (Progetto).

  2. Nella finestra di dialogo New Project (Nuovo progetto) selezionare Maven e assicurarsi che l'opzione Create from Archetype (Crea da archetipo) sia selezionata. Nell'elenco selezionare maven-archetype-webapp e quindi fare clic su Next (Avanti).

    Select the maven-archetype-webapp option.

  3. Espandere l'elenco a discesa Artifact Coordinates (Coordinate artefatto) per visualizzare tutti i campi di input, specificare le informazioni seguenti per la nuova app Web e fare clic su Next (Avanti):

    • Nome: nome dell'app Web. Questo valore verrà inserito automaticamente nel campo ArtifactId dell'app Web.
    • GroupId: nome del gruppo di artefatti, in genere un dominio aziendale. ad esempio com.microsoft.azure.
    • Versione: manterrà la versione predefinita 1.0-SN piattaforma di strumenti analitici HOT.

  4. Personalizzare eventuali impostazioni di Maven o accettare quelle predefinite e quindi fare clic su Finish (Fine).

  5. Passare al progetto nella scheda Project (Progetto) a sinistra e aprire il file src/main/webapp/index.jsp. Sostituire il codice con quello seguente e salvare le modifiche:

    <html>
 <body>
   <b><% out.println("Hello World!"); %></b>
 </body>
</html>

    Open the index.jsp file.

Creare un'istanza di Registro Azure Container da usare come registro Docker privato

La procedura seguente illustra come usare il portale di Azure per creare un'istanza di Registro Azure Container.

Nota

Per usare l'interfaccia della riga di comando di Azure invece del portale di Azure, seguire i passaggi in Creare un registro contenitori Docker privato usando l'interfaccia della riga di comando di Azure 2.0.

  1. Aprire il portale di Azure ed effettuare l'accesso.

    Dopo aver effettuato l'accesso all'account nel portale di Azure, è possibile seguire la procedura illustrata nell'articolo Creare un registro per contenitori Docker privati con il portale di Azure, parafrasata per semplicità nei passaggi seguenti.

  2. Fare clic sull'icona di menu + Crea una risorsa, quindi sulla categoria Contenitori e infine su Registro contenitori.

  3. Quando viene visualizzata la pagina Crea registro contenitori specificare le informazioni seguenti:

    • Sottoscrizione: specifica la sottoscrizione di Azure che si vuole usare per il nuovo registro contenitori.

    • Gruppo di risorse: specifica il gruppo di risorse per il registro contenitori. Selezionare una delle seguenti opzioni:

      • Crea nuovo: specifica che si intende creare un nuovo gruppo di risorse.
      • Usa esistente: specifica che sarà possibile scegliere in un elenco i gruppi di risorse associate all'account di Azure.

    • Nome registro: specifica il nome del nuovo registro contenitori.

    • Località: specifica l'area in cui verrà creato il registro contenitori, ad esempio "Stati Uniti occidentali".

    • SKU: specifica il livello di servizio per il registro contenitori. Per questa esercitazione selezionare Basic. Per altre informazioni, vedere Livelli di servizio di Registro Azure Container.

  4. Fare clic su Rivedi e crea e verificare che le informazioni siano corrette. Per finire, fare clic su Crea.

Distribuire l'app Web in un contenitore Docker

La procedura seguente consente di configurare il supporto Docker per l'app Web e di distribuire l'app Web in un contenitore Docker.

  1. Passare al progetto nella scheda Project (Progetto) a sinistra e fare clic con il pulsante destro del mouse sul progetto. Espandere Azure e fare clic su Add Docker Support (Aggiungi supporto Docker).

    Verrà automaticamente creato un file Docker con una configurazione predefinita.

    The docker support file.

  2. Dopo aver aggiunto il supporto per Docker, fare clic con il pulsante destro del mouse in Project Explorer (Esplora progetti), espandere Azure e quindi fare clic su Run on Web App for Containers (Esegui in app Web per contenitori).

  3. Nella finestra di dialogo Run on Web App for Containers (Esegui in app Web per contenitori) immettere le informazioni seguenti:

    • Name (Nome): specifica il nome descrittivo visualizzato in Azure Toolkit.

    • Registro Contenitori: scegliere il registro contenitori dal menu a discesa creato nella sezione precedente di questo articolo. I campi Server URL (URL server), Username (Nome utente) e Password verranno popolati automaticamente.

    • Image and tag (Immagine e tag): specifica il nome dell'immagine del contenitore. In genere viene usata questa sintassi: "registro.azurecr.io/nomeapp:latest", dove:

      • registro è il registro contenitori creato nella sezione precedente di questo articolo
      • nomeapp è il nome dell'app Web

    • Use Existing Web App (Usa app Web esistente) o Create New Web App (Crea nuova app Web): specifica se il contenitore verrà distribuito in un'app Web esistente o se creare una nuova app Web. Con il valore specificato in App name (Nome app) verrà creato l'URL dell'app Web, ad esempio wingtiptoys.azurewebsites.net.

    • Resource Group (Gruppo di risorse): specifica se usare un gruppo di risorse esistente o crearne uno nuovo.

    • servizio app Piano: specifica se si userà un piano di servizio app esistente o si creerà un nuovo piano di servizio app.

  4. Al termine della configurazione delle impostazioni indicate sopra, fare clic su Run (Esegui). Al completamento della distribuzione dell'app Web, lo stato verrà visualizzato nella finestra Run (Esegui).

  5. Dopo la pubblicazione dell'app Web, è possibile passare all'URL specificato in precedenza per l'app Web, ad esempio wingtiptoys.azurewebsites.net.

    Browsing to your web app

Facoltativo: modificare le impostazioni di pubblicazione dell'app Web

  1. Dopo aver pubblicato l'app Web, le impostazioni verranno salvate come predefinite e sarà possibile eseguire l'applicazione su Azure facendo clic sulla freccia verde sulla barra degli strumenti. È possibile modificare queste impostazioni facendo clic sul menu a discesa per l'app Web e quindi scegliendo Edit Configurations (Modifica configurazioni).

    Edit configuration menu.

  2. Quando viene visualizzata la finestra di dialogo Run/Debug Configurations (Esecuzione/debug configurazioni), è possibile modificare qualsiasi impostazione predefinita e quindi fare clic su OK.

Passaggi successivi

Per altre risorse per Docker, vedere il sito Web Docker ufficiale.

Per segnalare bug o richiedere nuove funzionalità, creare problemi nel repository GitHub o porre domande su Stack Overflow con tag azure-java-tools.

Per altre informazioni sull'uso di Java con Azure, vedere i collegamenti seguenti: