QuickStart: distribuzione di un'applicazione Java su Elastic Beanstalk

Questo QuickStart tutorial illustra il processo di creazione di un'applicazione Java e la sua distribuzione su un AWS Elastic Beanstalk ambiente.

Nota

Questo QuickStart tutorial è destinato a scopi dimostrativi. Non utilizzate l'applicazione creata in questo tutorial per il traffico di produzione.

La tua AWS account

Se non lo sei già AWS cliente, devi creare un AWS conto. La registrazione ti consente di accedere a Elastic Beanstalk e ad altri AWS i servizi di cui hai bisogno.

Se hai già un AWS account, puoi passare aPrerequisiti.

Crea un AWS account

Iscriviti per un Account AWS

Se non hai un Account AWS, completa i seguenti passaggi per crearne uno.

Per iscriverti a un Account AWS

1. Apri la https://portal.aws.amazon.com/billing/registrazione.

2. Segui le istruzioni online.

   Nel corso della procedura di registrazione riceverai una telefonata, durante la quale sarà necessario inserire un codice di verifica attraverso la tastiera del telefono.

   Quando ti iscrivi a un Account AWS, un Utente root dell'account AWSviene creato. L'utente root ha accesso a tutti Servizi AWS e le risorse presenti nell'account. Come best practice di sicurezza, assegna l'accesso amministrativo a un utente e utilizza solo l'utente root per eseguire attività che richiedono l'accesso di un utente root.

AWS ti invia un'email di conferma dopo il completamento della procedura di registrazione. In qualsiasi momento, puoi visualizzare l'attività corrente del tuo account e gestirlo accedendo a https://aws.amazon.com/e scegliendo Il mio account.

Crea un utente con accesso amministrativo

Dopo esserti registrato per un Account AWS, proteggi il tuo Utente root dell'account AWS, abilita AWS IAM Identity Center e crea un utente amministrativo in modo da non utilizzare l'utente root per le attività quotidiane.

Proteggi i tuoi Utente root dell'account AWS

1. Accedi a AWS Management Consolecome proprietario dell'account selezionando Utente root e inserendo il Account AWS indirizzo email. Nella pagina successiva, inserisci la password.

   Per informazioni sull'accesso tramite utente root, consulta Accesso come utente root in Accedi ad AWS Guida per l'utente.

2. Attiva l'autenticazione a più fattori (MFA) per il tuo utente root.

   Per istruzioni, consulta Abilitare un MFA dispositivo virtuale per il Account AWS utente root (console) nella Guida per l'IAMutente.

Crea un utente con accesso amministrativo

1. Abilita IAM Identity Center.

   Per istruzioni, vedi Abilitazione AWS IAM Identity Center nella AWS IAM Identity Center Guida per l'utente.

2. In IAM Identity Center, concedi l'accesso amministrativo a un utente.

   Per un tutorial sull'utilizzo di IAM Identity Center directory come fonte di identità, vedi Configurare l'accesso utente con l'impostazione predefinita IAM Identity Center directory nella AWS IAM Identity Center Guida per l'utente.

Accesso come utente amministratore

• Per accedere con il tuo utente IAM Identity Center, utilizza l'accesso URL che ti è stato inviato al tuo indirizzo e-mail quando hai creato l'utente IAM Identity Center.

  Per informazioni sull'accesso tramite un utente di IAM Identity Center, vedi Accesso a AWS accedere al portale in Accedi ad AWS Guida per l'utente.

Assegna l'accesso a ulteriori utenti

1. In IAM Identity Center, crea un set di autorizzazioni che segua la migliore pratica di applicazione delle autorizzazioni con privilegi minimi.

   Per istruzioni, vedere Creare un set di autorizzazioni nella AWS IAM Identity Center Guida per l'utente.

2. Assegna al gruppo prima gli utenti e poi l'accesso con autenticazione unica (Single Sign-On).

   Per istruzioni, consulta Aggiungere gruppi nella AWS IAM Identity Center Guida per l'utente.

Prerequisiti

Per seguire le procedure in questa guida, devi usare un terminale a riga di comando o una shell per eseguire i comandi. I comandi vengono visualizzati in elenchi preceduti da un simbolo di prompt ($) e dal nome della directory corrente, se appropriato.

~/eb-project$ this is a command
this is output

Su Linux e macOS usa la tua shell e il tuo programma di gestione dei pacchetti preferiti. Su Windows puoi installare il sottosistema Windows per Linux per ottenere una versione integrata per Windows di Ubuntu e Bash.

EB CLI

Questo tutorial utilizza l'Elastic Beanstalk Command Line Interface (EB). CLI Per i dettagli sull'installazione e la configurazione dell'EBCLI, consulta e. Installazione dell'interfaccia a riga di comando di Elastic Beanstalk Configurazione dell'interfaccia a riga di comando EB

Java e Maven

Se Amazon Corretto non è installato sul tuo computer locale, puoi installarlo seguendo le istruzioni di installazione nella Amazon Corretto User Guide.

Verifica l'installazione di Java eseguendo il comando seguente.

~$ java -version 

Questo tutorial utilizza Maven. Segui le istruzioni per il download e l'installazione sul sito Web di Apache Maven Project. Per ulteriori informazioni su Maven, consulta il Maven Users Center sul sito web del progetto Apache Maven.

Verifica l'installazione di Maven eseguendo il seguente comando.

~$ mvn -v

Passaggio 1: creare un'applicazione Java

Crea una directory di progetto.

~$ mkdir eb-java
~$ cd eb-java

Successivamente, crea un'applicazione che distribuirai utilizzando Elastic Beanstalk. Creeremo un servizio RESTful web «Hello World».

Questo esempio utilizza il framework Spring Boot. Questa applicazione apre un listener sulla porta 5000. Elastic Beanstalk inoltra le richieste all'applicazione sulla porta 5000 per impostazione predefinita.

Crea i seguenti file:

Questo file crea una semplice applicazione Spring Boot.

Esempio ~/eb-java/src/main/java/com/example/Application.java

package com.example;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

Questo file crea una mappatura che restituisce una stringa che definiamo qui.

Esempio ~/eb-java/src/main/java/com/example/Controller.java

package com.example;
    
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
    
@RestController
public class Controller {
    
    @GetMapping("/")
    public String index() {
       return "Hello Elastic Beanstalk!";
    }
}

Questo file definisce la configurazione del progetto Maven.

Esempio ~/eb-java/pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.2.3</version>
  </parent>

  <groupId>com.example</groupId>
  <artifactId>BeanstalkJavaExample</artifactId>
  <version>1.0-SNAPSHOT</version>

  <properties>
    <java.version>21</java.version>
  </properties>

  <dependencies>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-rest</artifactId>
    </dependency>
  </dependencies>

  <build>
    <plugins>
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
    </plugins>
  </build>

</project>

Questo file di proprietà sostituisce la porta predefinita impostata su 5000. Questa è la porta predefinita a cui Elastic Beanstalk invia il traffico per le applicazioni Java.

Esempio ~/eb-java/application.properties

server.port=5000

Passaggio 2: Esegui l'applicazione localmente

Package della tua applicazione con il seguente comando:

~/eb-java$ mvn clean package

Esegui l'applicazione localmente con il seguente comando:

~/eb-java$ java -jar target/BeanstalkJavaExample-1.0-SNAPSHOT.jar

Mentre l'applicazione è in esecuzione, accedi al http://127.0.0.1:5000/ menu nel tuo browser. Dovresti vedere il testo «Hello Elastic Beanstalk!».

Fase 3: Implementa la tua applicazione Java con l'EB CLI

Prima di distribuire l'applicazione Java su Elastic Beanstalk, puliamo l'applicazione di compilazione dalla directory e creiamo un Buildfile e un Procfile per controllare come l'applicazione viene creata ed eseguita nell'ambiente Elastic Beanstalk.

Per preparare e configurare la distribuzione delle applicazioni

1. Pulisci l'applicazione integrata.

   ~/eb-java$ mvn clean

2. Crea un Buildfile.

   Esempio ~/eb-java/Buildfile

   build: mvn clean package

   Questo Buildfile specifica il comando usato per creare l'applicazione. Se non includi un file Buildfile per un'applicazione Java, Elastic Beanstalk non tenterà di creare la tua applicazione.

3. Crea un Procfile.

   Esempio ~/eb-java/Procfile

   web: java -jar target/BeanstalkJavaExample-1.0-SNAPSHOT.jar

   Questo Procfile specifica il comando usato per eseguire l'applicazione. Se non includi un file Procfile per un'applicazione Java, Elastic Beanstalk presuppone che ci JAR sia un file nella radice del pacchetto sorgente e tenta di eseguirlo con il comando. java -jar

Ora che hai impostato i file di configurazione per creare e avviare l'applicazione, sei pronto per distribuirla.

Per creare un ambiente e distribuire l'applicazione Java

1. Inizializza il tuo CLI repository EB con il comando. eb init

   ~/eb-java eb init -p corretto java-tutorial --region us-east-2
           
   Application java-tutorial has been created.

   Questo comando crea un'applicazione denominata java-tutorial e configura il repository locale per creare ambienti con l'ultima versione della piattaforma Java.

2. (Facoltativo) Esegui eb init nuovamente per configurare una coppia di key pair predefinita SSH da utilizzare per connetterti all'EC2istanza che esegue l'applicazione.

   ~/eb-java$ eb init
   Do you want to set up SSH for your instances?
   (y/n): y
   Select a keypair.
   1) my-keypair
   2) [ Create new KeyPair ]

   Seleziona una coppia di chiavi se ne hai già una, oppure segui le istruzioni per creare una nuova. Se il prompt non è visualizzato o devi modificare le impostazioni in seguito, esegui eb init -i.

3. Crea un ambiente e distribuisci in esso l'applicazione con eb create: Elastic Beanstalk crea automaticamente un file zip per l'applicazione e lo avvia sulla porta 5000.

   ~/eb-java$ eb create java-env

   Elastic Beanstalk impiega circa cinque minuti per creare l'ambiente.

Fase 4: Esegui l'applicazione su Elastic Beanstalk

Una volta completato il processo di creazione dell'ambiente, apri il sito Web con. eb open

~/eb-java eb open

Complimenti! Hai distribuito un'applicazione Java con Elastic Beanstalk! Si aprirà una finestra del browser che utilizza il nome di dominio creato per l'applicazione.

Fase 5: rimozione

Puoi chiudere il tuo ambiente quando hai finito di lavorare con l'applicazione. Elastic Beanstalk termina tutto AWS risorse associate al tuo ambiente.

Per terminare l'ambiente Elastic Beanstalk con CLI EB, esegui il comando seguente.

~/eb-java$ eb terminate

AWS risorse per la tua applicazione

Hai appena creato un'applicazione a istanza singola. Funge da semplice applicazione di esempio con una singola EC2 istanza, quindi non richiede il bilanciamento del carico o la scalabilità automatica. Per le applicazioni a istanza singola, Elastic Beanstalk crea quanto segue: AWS risorse:

• EC2istanza: una macchina EC2 virtuale Amazon configurata per eseguire app Web sulla piattaforma scelta.

  Ogni piattaforma esegue un insieme diverso di software, file di configurazione e script per supportare una versione della lingua, un framework, un container Web specifici o una determinata combinazione di tutti questi elementi. La maggior parte delle piattaforme utilizza Apache o nginx come proxy inverso che elabora il traffico web su cui viene eseguita l'app Web, inoltra le richieste all'app, fornisce asset statici e genera log degli accessi e di errore.

• Gruppo di sicurezza dell'istanza: un gruppo EC2 di sicurezza Amazon configurato per consentire il traffico in entrata sulla porta 80. Questa risorsa consente al HTTP traffico proveniente dal sistema di bilanciamento del carico di raggiungere l'EC2istanza su cui è in esecuzione la tua app web. Per impostazione predefinita, il traffico non è consentito su altre porte.

• Bucket Amazon S3: posizione di storage per il codice sorgente, i log e altri artefatti creati quando si utilizza Elastic Beanstalk.

• CloudWatch Allarmi Amazon: due CloudWatch allarmi che monitorano il carico sulle istanze nel tuo ambiente e vengono attivati se il carico è troppo alto o troppo basso. Quando viene attivato un allarme, il gruppo Auto Scaling aumenta o diminuisce di conseguenza.

• AWS CloudFormation stack — Elastic Beanstalk utilizza AWS CloudFormation per avviare le risorse nell'ambiente e propagare le modifiche alla configurazione. Le risorse sono definite in un modello che è possibile visualizzare nella AWS CloudFormation console.

• Nome di dominio: un nome di dominio che viene indirizzato alla tua app Web nel modulo subdomain.region.elasticbeanstalk.com.

Elastic Beanstalk gestisce tutte queste risorse. Quando arresti l'ambiente, Elastic Beanstalk termina tutte le risorse che contiene.

Passaggi successivi

Quando disponi di un'applicazione in esecuzione in un ambiente, puoi distribuire una nuova versione dell'applicazione o un'applicazione diversa in qualsiasi momento. La distribuzione di una nuova versione dell'applicazione è molto rapida perché non richiede il provisioning o il riavvio delle istanze. EC2 Puoi anche esplorare il tuo nuovo ambiente utilizzando la console Elastic Beanstalk. Per i passaggi dettagliati, consulta Esplora il tuo ambiente nel capitolo Guida introduttiva di questa guida.

Prova altri tutorial

Se desideri provare altri tutorial con diverse applicazioni di esempio, consulta. Esempi di applicazioni e tutorial

Dopo aver distribuito una o due applicazioni di esempio e essere pronti per iniziare a sviluppare ed eseguire applicazioni Java localmente, vedi. Configurazione dell'ambiente di sviluppo Java

Esegui la distribuzione con la console Elastic Beanstalk

Puoi anche utilizzare la console Elastic Beanstalk per avviare l'applicazione di esempio. Per i passaggi dettagliati, consulta Creare un'applicazione di esempio nel capitolo Guida introduttiva di questa guida.