QuickStart: Java アプリケーションを Elastic Beanstalk にデプロイする

この QuickStart チュートリアルでは、Java アプリケーションを作成して にデプロイするプロセスについて説明します。 AWS Elastic Beanstalk 環境。

の AWS アカウント

をまだお持ちでない場合 AWS お客様は、 を作成する必要があります。 AWS アカウント。サインアップすると、Elastic Beanstalk やその他の にアクセスできます。 AWS 必要な サービス。

が既にある場合 AWS アカウント、 に進むことができます前提条件。

前提条件

このガイドの手順に従うには、run command のためのコマンドラインターミナルまたはシェルが必要になります。コマンドは、該当する場合、プロンプト記号 ($) と現在のディレクトリの名前が前に付けられて、リストに示されます。

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

Linux および macOS では、任意のシェルとパッケージ管理者を使用できます。Windows では、Linux 用 Windows サブシステムをインストールして、Windows 統合バージョンの Ubuntu と Bash を取得できます。

EB CLI

このチュートリアルでは、Elastic Beanstalk コマンドラインインターフェイス (EB) を使用しますCLI。EB のインストールと設定の詳細についてはCLI、Elastic Beanstalk コマンドラインインターフェイスをインストールする「」および「」を参照してくださいEB CLI の設定。

Java と Maven

ローカルマシンに Amazon Corretto がインストールされていない場合は、「Amazon Corretto ユーザーガイド」のインストール手順に従ってインストールできます。

次のコマンドを実行して、Java のインストールを確認します。

~$ java -version 

このチュートリアルでは Maven を使用します。Apache Maven プロジェクトのウェブサイトのダウンロードとインストールの手順に従います。Maven の詳細については、Apache Maven プロジェクトウェブサイトの Maven Users Centre を参照してください。

次のコマンドを実行して、Maven のインストールを確認します。

~$ mvn -v

ステップ 1: Java アプリケーションを作成する

プロジェクトディレクトリを作成します。

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

次に、Elastic Beanstalk を使用してデプロイするアプリケーションを作成します。「Hello WorldRESTful」ウェブサービスを作成します。

この例では、Spring Boot フレームワークを使用しています。このアプリケーションは、ポート 5000 でリスナーを開きます。デフォルトでは、Elastic Beanstalk はポート 5000 でアプリケーションにリクエストを転送します。

次のファイルを作成します。

このファイルはシンプルな 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);
    }
}

このファイルは、ここで定義する文字列を返すマッピングを作成します。

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

このファイルは 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>

このプロパティファイルは、デフォルトのポートを 5000 に上書きします。これは、Elastic Beanstalk が for Java アプリケーションにトラフィックを送信するデフォルトのポートです。

server.port=5000

ステップ 2: アプリケーションをローカルで実行する

次のコマンドを使用してアプリケーションをパッケージ化します。

~/eb-java$ mvn clean package

次のコマンドを使用して、アプリケーションをローカルで実行します。

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

アプリケーションの実行中、ブラウザhttp://127.0.0.1:5000/で に移動します。「Hello Elastic Beanstalk!」というテキストが表示されます。

ステップ 3: EB を使用して Java アプリケーションをデプロイする CLI

Java アプリケーションを Elastic Beanstalk にデプロイする前に、ビルドアプリケーションをディレクトリからクリーンアップし、ビルドファイルと Procfile を作成して、Elastic Beanstalk 環境でアプリケーションがどのように構築および実行されるかを制御します。

これで、アプリケーションを構築して起動するための設定ファイルがセットアップされたので、デプロイする準備が整いました。

ステップ 4: Elastic Beanstalk でアプリケーションを実行する

環境を作成するプロセスが完了したら、 でウェブサイトを開きますeb open。

~/eb-java eb open

お疲れ様でした。Elastic Beanstalk で Java アプリケーションをデプロイしました。これにより、アプリケーション用に作成されたドメイン名を使用してブラウザ Window が開きます。

ステップ 5：クリーンアップ

アプリケーションの使用が終了したら、環境を終了できます。Elastic Beanstalk はすべての AWS 環境に関連付けられた リソース。

EB を使用して Elastic Beanstalk 環境を終了するには、次のコマンドCLIを実行します。

~/eb-java$ eb terminate

AWS アプリケーションの リソース

1 つのインスタンスアプリケーションを作成しました。単一のEC2インスタンスで簡単なサンプルアプリケーションとして機能するため、負荷分散や自動スケーリングは必要ありません。単一インスタンスアプリケーションの場合、Elastic Beanstalk は以下を作成します。 AWS リソース：

Elastic Beanstalk は、これらのリソースをすべて管理します。環境を終了すると、Elastic Beanstalk は含まれているすべてのリソースを終了します。

次のステップ

アプリケーションを実行する環境を手に入れた後、アプリケーションの新しいバージョンや、異なるアプリケーションをいつでもデプロイできるようになります。新しいアプリケーションバージョンのデプロイは、EC2インスタンスのプロビジョニングや再起動を必要としないため、非常に高速です。Elastic Beanstalk コンソールを使用して新しい環境を調べることもできます。詳細な手順については、このガイドの「開始方法」の章の「環境を探索する」を参照してください。

サンプルアプリケーションを 1 つまたは 2 つデプロイし、Java アプリケーションの開発と実行をローカルで開始する準備ができたら、「」を参照してくださいJava 開発環境をセットアップする。

Elastic Beanstalk コンソールを使用してデプロイする

Elastic Beanstalk コンソールを使用してサンプルアプリケーションを起動することもできます。詳細な手順については、このガイドの「開始方法」の章の「サンプルアプリケーションの作成」を参照してください。