QuickStart: Stellen Sie eine Java-Anwendung auf Elastic Beanstalk bereit

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

Ihre AWS Konto

Wenn Sie noch kein AWS Kunde sind, müssen Sie ein AWS Konto erstellen. Wenn Sie sich registrieren, können Sie auf Elastic Beanstalk und andere AWS Dienste zugreifen, die Sie benötigen.

Wenn Sie bereits ein AWS Konto haben, können Sie zu wechseln. Voraussetzungen

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-integrated Version von Ubuntu und Bash zu erhalten.

EB-CLI

Dieses Tutorial verwendet die Befehlszeilenschnittstelle Elastic Beanstalk Command Line Interface (EB CLI). Detaillierte Anweisungen zum Installieren und Konfigurieren der EB CLI finden Sie unter EB CLI mit Setup-Skript installieren (empfohlen) 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 https://maven.apache.org/install.html Installationsanweisungen auf der Apache Maven Project-Website. Weitere Informationen zu Maven finden Sie im Maven Users Center auf der Apache Maven Project-Website.

Verifizieren 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 erstellen einen "Hello World"-RESTful-Webservice.

In diesem Beispiel wird das Spring Boot-Framework verwendet. Diese Anwendung öffnet einen Listener auf Port 5000. Elastic Beanstalk leitet Anfragen standardmäßig auf 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 einen String zurückgibt, den 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 auf 5000. Dies ist der Standardport, an den Elastic Beanstalk Datenverkehr für Java-Anwendungen sendet.

server.port=5000

Schritt 2: Führen Sie Ihre Anwendung lokal aus

Verpacken 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

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

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

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 steuern, wie die Anwendung in Ihrer Elastic Beanstalk-Umgebung erstellt und ausgeführt wird.

Nachdem Sie die Konfigurationsdateien eingerichtet haben, um Ihre Anwendung zu erstellen und zu starten, 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 mit Ihrer AWS Umgebung verbundenen Ressourcen.

Führen Sie den folgenden Befehl aus, um Ihre Elastic Beanstalk-Umgebung mit der EB-CLI zu beenden.

~/eb-java$ eb terminate

AWS Ressourcen für Ihre Anwendung

Sie haben gerade eine Einzelinstanzanwendung erstellt. Sie dient als einfache Beispielanwendung mit einer einzelnen EC2-Instance, sodass kein Lastenausgleich oder automatische Skalierung erforderlich sind. Für Einzelinstanzanwendungen erstellt Elastic Beanstalk die folgenden Ressourcen: AWS

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. Das Bereitstellen einer neuen Anwendungsversion geht sehr schnell, da keine EC2-Instances bereitgestellt oder neu gestartet werden müssen. Sie können Ihre neue Umgebung auch mithilfe der Elastic Beanstalk-Konsole erkunden. Eine ausführliche Anleitung finden Sie unter Erkunden Sie Ihre Umgebung im Kapitel Erste Schritte dieses Handbuchs.

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

Stellen Sie die Bereitstellung mit der Elastic Beanstalk-Konsole bereit

Sie können auch die Elastic Beanstalk-Konsole verwenden, um die Beispielanwendung zu starten. Eine ausführliche Anleitung finden Sie unter Erstellen einer Beispielanwendung im Kapitel Erste Schritte dieses Handbuchs.