QuickStart: Eine Java-Anwendung auf Elastic Beanstalk bereitstellen

Dieses QuickStart Tutorial führt Sie durch den Prozess der Erstellung einer Java-Anwendung und deren Bereitstellung auf einem AWS Elastic Beanstalk Umgebung.

Ihre AWS Konto

Wenn Sie noch kein AWS Kunde, Sie müssen einen erstellen AWS Konto. Wenn Sie sich registrieren, erhalten Sie Zugriff auf Elastic Beanstalk und andere AWS Dienste, die Sie benötigen.

Wenn Sie bereits eine haben AWS Konto, zu dem Sie weitermachen könnenVoraussetzungen.

Voraussetzungen

Um die Verfahren in diesem Leitfaden zu befolgen, benötigen Sie ein Befehlszeilen-Terminal oder eine Shell für die Ausführung der Befehle. Befehle werden ggf. in Auflistungen mit einem vorangestellten Eingabeaufforderungssymbol ($) und dem Namen des aktuellen Verzeichnisses angezeigt.

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

In Linux und macOS können Sie Ihren bevorzugten Shell- und Paket-Manager verwenden. Unter Windows können Sie das Windows-Subsystem für Linux installieren, um eine Windows-integrierte Version von Ubuntu und Bash zu erhalten.

EB CLI

In diesem Tutorial wird das Elastic Beanstalk Command Line Interface (EBCLI) verwendet. Einzelheiten zur Installation und Konfiguration des EB finden Sie CLI unter Installieren Sie die Elastic Beanstalk Beanstalk-Befehlszeilenschnittstelle und. Konfigurieren der EB CLI

Java und Maven

Wenn Sie Amazon Corretto nicht auf Ihrem lokalen Computer installiert haben, können Sie es installieren, indem Sie den Installationsanweisungen im Amazon Corretto-Benutzerhandbuch folgen.

Überprüfen Sie Ihre Java-Installation, indem Sie den folgenden Befehl ausführen.

~$ java -version 

Dieses Tutorial verwendet Maven. Folgen Sie den Download - und Installationsanweisungen auf der Apache Maven Project-Website. Weitere Informationen zu Maven finden Sie im Maven Users Center auf der Apache Maven Project-Website.

Überprüfen Sie Ihre Maven-Installation, indem Sie den folgenden Befehl ausführen.

~$ mvn -v

Schritt 1: Erstellen Sie eine Java-Anwendung

Erstellen Sie ein Projektverzeichnis.

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

Erstellen Sie anschließend eine Anwendung, die Sie mit Elastic Beanstalk bereitstellen. Wir werden einen „Hello World“ RESTful -Webservice erstellen.

In diesem Beispiel wird das Spring Boot-Framework verwendet. Diese Anwendung öffnet einen Listener auf Port 5000. Elastic Beanstalk leitet Anfragen standardmäßig an Port 5000 an Ihre Anwendung weiter.

Erstellen Sie die folgenden Dateien:

Diese Datei erstellt eine einfache Spring Boot-Anwendung.

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);
    }
}

Diese Datei erstellt ein Mapping, das eine Zeichenfolge zurückgibt, die wir hier definieren.

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!";
    }
}

Diese Datei definiert die Maven-Projektkonfiguration.

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

Diese Eigenschaftendatei überschreibt den Standardport 5000. Dies ist der Standardport, an den Elastic Beanstalk Traffic für Java-Anwendungen sendet.

server.port=5000

Schritt 2: Führen Sie Ihre Anwendung lokal aus

Package Sie Ihre Anwendung mit dem folgenden Befehl:

~/eb-java$ mvn clean package

Führen Sie Ihre Anwendung lokal mit dem folgenden Befehl aus:

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

Während die Anwendung ausgeführt wird, navigieren Sie http://127.0.0.1:5000/ in Ihrem Browser zu. Du solltest den Text „Hello Elastic Beanstalk!“ sehen.

Schritt 3: Stellen Sie Ihre Java-Anwendung mit dem EB bereit CLI

Bevor wir Ihre Java-Anwendung auf Elastic Beanstalk bereitstellen, löschen wir die Build-Anwendung aus Ihrem Verzeichnis und erstellen ein Buildfile und ein Procfile, um zu kontrollieren, wie die Anwendung in Ihrer Elastic Beanstalk Beanstalk-Umgebung erstellt und ausgeführt wird.

Nachdem Sie nun die Konfigurationsdateien zum Erstellen und Starten Ihrer Anwendung eingerichtet haben, können Sie sie bereitstellen.

Schritt 4: Führen Sie Ihre Anwendung auf Elastic Beanstalk aus

Wenn der Prozess zur Erstellung Ihrer Umgebung abgeschlossen ist, öffnen Sie Ihre Website mit. eb open

~/eb-java eb open

Herzlichen Glückwunsch! Sie haben eine Java-Anwendung mit Elastic Beanstalk bereitgestellt! Es wird ein Browserfenster mit dem für die Anwendung erstellten Domainnamen geöffnet.

Schritt 5: Bereinigen

Sie können Ihre Umgebung beenden, wenn Sie mit der Arbeit an Ihrer Anwendung fertig sind. Elastic Beanstalk beendet alle AWS Ressourcen, die mit Ihrer Umgebung verknüpft sind.

Um Ihre Elastic Beanstalk Beanstalk-Umgebung mit dem EB zu beenden, CLI führen Sie den folgenden Befehl aus.

~/eb-java$ eb terminate

AWS Ressourcen für Ihre Anwendung

Sie haben gerade eine Einzelinstanzanwendung erstellt. Es dient als einfache Beispielanwendung mit einer einzigen EC2 Instanz, sodass kein Lastenausgleich oder auto Skalierung erforderlich sind. Für Einzelinstanzanwendungen erstellt Elastic Beanstalk Folgendes: AWS Ressourcen:

Elastic Beanstalk verwaltet all diese Ressourcen. Wenn Sie die Umgebung beenden, werden alle darin enthaltenen Ressourcen von Elastic Beanstalk beendet.

Nächste Schritte

Nachdem Sie eine Umgebung erstellt haben, in der eine Anwendung ausgeführt wird, können Sie jederzeit eine neue Version der Anwendung oder eine andere Anwendung bereitstellen. Die Bereitstellung einer neuen Anwendungsversion ist sehr schnell, da dafür keine Bereitstellung oder Neustarts von Instances erforderlich sind. EC2 Sie können Ihre neue Umgebung auch mit der Elastic Beanstalk Beanstalk-Konsole erkunden. Ausführliche Schritte finden Sie unter Erkunden Sie Ihre Umgebung im Kapitel Erste Schritte dieses Handbuchs.

Wenn Sie eine oder zwei Beispielanwendungen bereitgestellt haben und bereit sind, Java-Anwendungen lokal zu entwickeln und auszuführen, finden Sie weitere Informationen unterEinrichten der Java-Entwicklungsumgebung.

Bereitstellung mit der Elastic Beanstalk Beanstalk-Konsole

Sie können die Beispielanwendung auch mit der Elastic Beanstalk Beanstalk-Konsole starten. Ausführliche Schritte finden Sie unter Erstellen einer Beispielanwendung im Kapitel Erste Schritte dieses Handbuchs.