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 in un AWS Elastic Beanstalk ambiente.

Il tuo AWS account

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

Se hai già un AWS account, puoi passare a. Prerequisiti

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 con 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.

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.

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.

<?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.

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.

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

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 AWS interrompe tutte le risorse associate all'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 le seguenti risorse: AWS

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.

Dopo aver distribuito una o due applicazioni di esempio e essere pronti per iniziare a sviluppare ed eseguire applicazioni Java localmente, consulta. 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.