翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # QuickStart: Elastic Beanstalk に Java アプリケーションをデプロイする この QuickStart チュートリアルでは、Java アプリケーションを作成し、 AWS Elastic Beanstalk 環境にデプロイするプロセスについて説明します。 **本番稼働用ではない** 例はデモンストレーションのみを目的としています。サンプルアプリケーションを本番環境で使用しないでください。 **Topics** + [AWS アカウント](#java-quickstart-aws-account) + [前提条件](#java-quickstart-prereq) + [ステップ 1: Java アプリケーションを作成する](#java-quickstart-create-app) + [ステップ 2: アプリケーションをローカルに実行する](#java-quickstart-run-local) + [ステップ 3: EB CLI を使用して Java アプリケーションをデプロイする](#java-quickstart-deploy) + [ステップ 4: Elastic Beanstalk でアプリケーションを実行する](#java-quickstart-run-eb-ap) + [ステップ 5：クリーンアップ](#java-tutorial-cleanup) + [AWS アプリケーションの リソース](#java-quickstart-eb-resources) + [次の手順](#java-quickstart-next-steps) + [Elastic Beanstalk コンソールでデプロイする](#java-quickstart-console) ## AWS アカウント まだ AWS のお客様でない場合は、 AWS アカウントを作成する必要があります。サインアップすると、Elastic Beanstalk やその他の必要な AWS サービスにアクセスできます。 AWS アカウントをすでにお持ちの場合は、「」に進むことができます[前提条件](#java-quickstart-prereq)。 ### AWS アカウントを作成する #### にサインアップする AWS アカウント がない場合は AWS アカウント、次の手順を実行して作成します。 **にサインアップするには AWS アカウント** 1. [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup) を開きます。 1. オンラインの手順に従います。 サインアップ手順の一環として、電話またはテキストメッセージを受け取り、電話キーパッドで検証コードを入力します。 にサインアップすると AWS アカウント、 *AWS アカウントのルートユーザー* が作成されます。ルートユーザーには、アカウントのすべての AWS のサービス とリソースへのアクセス権があります。セキュリティベストプラクティスとして、ユーザーに管理アクセス権を割り当て、[ルートユーザーアクセスが必要なタスク](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks)の実行にはルートユーザーのみを使用するようにしてください。 AWS サインアッププロセスが完了すると、 から確認メールが送信されます。[https://aws.amazon.com/](https://aws.amazon.com/) の **[マイアカウント]** をクリックして、いつでもアカウントの現在のアクティビティを表示し、アカウントを管理することができます。 #### 管理アクセスを持つユーザーを作成する にサインアップしたら AWS アカウント、日常的なタスクにルートユーザーを使用しないように AWS アカウントのルートユーザー、 を保護し AWS IAM アイデンティティセンター、 を有効にして管理ユーザーを作成します。 **を保護する AWS アカウントのルートユーザー** 1. **ルートユーザー**を選択し、 AWS アカウント E メールアドレスを入力して、アカウント所有者[AWS マネジメントコンソール](https://console.aws.amazon.com/)として にサインインします。次のページでパスワードを入力します。 ルートユーザーを使用してサインインする方法については、「*AWS サインイン ユーザーガイド*」の「[ルートユーザーとしてサインインする](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial)」を参照してください。 1. ルートユーザーの多要素認証 (MFA) を有効にします。 手順については、*IAM* [ユーザーガイドの AWS アカウント 「ルートユーザー (コンソール) の仮想 MFA デバイス](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html)を有効にする」を参照してください。 **管理アクセスを持つユーザーを作成する** 1. IAM アイデンティティセンターを有効にします。 手順については、「*AWS IAM アイデンティティセンター ユーザーガイド*」の「[AWS IAM アイデンティティセンターの有効化](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-set-up-for-idc.html)」を参照してください。 1. IAM アイデンティティセンターで、ユーザーに管理アクセスを付与します。 を ID ソース IAM アイデンティティセンターディレクトリ として使用する方法のチュートリアルについては、*AWS IAM アイデンティティセンター 「 ユーザーガイド*」の[「デフォルトを使用してユーザーアクセスを設定する IAM アイデンティティセンターディレクトリ](https://docs.aws.amazon.com//singlesignon/latest/userguide/quick-start-default-idc.html)」を参照してください。 **管理アクセス権を持つユーザーとしてサインインする** + IAM アイデンティティセンターのユーザーとしてサインインするには、IAM アイデンティティセンターのユーザーの作成時に E メールアドレスに送信されたサインイン URL を使用します。 IAM Identity Center ユーザーを使用してサインインする方法については、*AWS サインイン 「 ユーザーガイド*[」の AWS 「 アクセスポータルにサインイン](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html)する」を参照してください。 **追加のユーザーにアクセス権を割り当てる** 1. IAM アイデンティティセンターで、最小特権のアクセス許可を適用するというベストプラクティスに従ったアクセス許可セットを作成します。 手順については、「*AWS IAM アイデンティティセンター ユーザーガイド*」の「[アクセス許可セットを作成する](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-started-create-a-permission-set.html)」を参照してください。 1. グループにユーザーを割り当て、そのグループにシングルサインオンアクセス権を割り当てます。 手順については、「*AWS IAM アイデンティティセンター ユーザーガイド*」の「[グループを追加する](https://docs.aws.amazon.com//singlesignon/latest/userguide/addgroups.html)」を参照してください。 ## 前提条件 このガイドの手順に従うには、run commands のためのコマンドラインターミナルまたはシェルが必要になります。コマンドは、該当する場合、プロンプト記号 (\$1) と現在のディレクトリの名前が前に付けられて、リストに示されます。 ``` ~/eb-project$ this is a command this is output ``` Linux および macOS では、任意のシェルとパッケージ管理者を使用できます。Windows では、[Linux 用の Windows サブシステムをインストール](https://docs.microsoft.com/en-us/windows/wsl/install-win10)して、Ubuntu および Bash の Windows に統合されたバージョンを入手できます。 ### EB CLI このチュートリアルでは、Elastic Beanstalk コマンドラインインターフェイス (EB CLI) を使用します。EB CLI をインストールおよび設定する手順の詳細については、「[セットアップスクリプトを使用して EB CLI をインストールする (推奨)](eb-cli3.md#eb-cli3-install)」および「[EB CLI の設定](eb-cli3-configuration.md)」を参照してください。 ### Java と Maven ローカルマシンに Amazon Corretto がインストールされていない場合は、「*Amazon Corretto ユーザーガイド*」の「[インストール手順](https://docs.aws.amazon.com/corretto/latest/corretto-21-ug/amazon-linux-install.html)」に従ってインストールできます。 次のコマンドを実行して、Java のインストールを確認します。 ``` ~$ java -version ``` このチュートリアルでは、Maven を使用します。Apache Maven Project ウェブサイトの[ダウンロード](https://maven.apache.org/download.cgi)と[インストール](https://maven.apache.org/install.html)の手順に従います。Maven の詳細については、Apache Maven Project ウェブサイトの「[Maven ユーザーセンター](https://maven.apache.org/users/index.html)」を参照してください。 次のコマンドを実行して、Maven のインストールを確認します。 ``` ~$ mvn -v ``` ## ステップ 1: Java アプリケーションを作成する プロジェクトディレクトリを作成します。 ``` ~$ mkdir eb-java ~$ cd eb-java ``` 次に、Elastic Beanstalk を使用してデプロイするアプリケーションを作成します。ここでは、"Hello World" という RESTful ウェブサービスを作成します。 この例では、[Spring Boot](https://spring.io/projects/spring-boot) フレームワークを使用します。このアプリケーションは、ポート 5000 でリスナーを開きます。デフォルトでは、Elastic Beanstalk はポート 5000 でアプリケーションにリクエストを転送します。 次のファイルを作成します。 このファイルは、シンプルな Spring Boot アプリケーションを作成します。 **Example `~/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); } } ``` このファイルは、ここで定義する文字列を返すマッピングを作成します。 **Example `~/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!"; } } ``` このファイルは、Maven プロジェクト設定を定義します。 **Example `~/eb-java/pom.xml`** ``` 4.0.0 org.springframework.boot spring-boot-starter-parent 3.2.3 com.example BeanstalkJavaExample 1.0-SNAPSHOT 21 org.springframework.boot spring-boot-starter-data-rest org.springframework.boot spring-boot-maven-plugin ``` このプロパティファイルは、デフォルトのポートを 5000 に上書きします。これは、Elastic Beanstalk が Java アプリケーションにトラフィックを送信するデフォルトのポートです。 **Example `~/eb-java/application.properties`** ``` 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\$1」というテキストが表示されます。 ## ステップ 3: EB CLI を使用して Java アプリケーションをデプロイする Java アプリケーションを Elastic Beanstalk にデプロイする前に、ビルドアプリケーションをディレクトリからクリーンアップし、[Buildfile](java-se-buildfile.md) と [Procfile](java-se-procfile.md) を作成して、Elastic Beanstalk 環境でアプリケーションがビルドおよび実行される方法を制御します。 **アプリケーションのデプロイを準備および設定するには** 1. ビルドされたアプリケーションをクリーンアップします。 ``` ~/eb-java$ mvn clean ``` 1. `Buildfile` を作成します。 **Example `~/eb-java/Buildfile`** ``` build: mvn clean package ``` この `Buildfile` は、アプリケーションのビルドに使用されるコマンドを指定します。Java アプリケーション用の `Buildfile` を含めない場合、Elastic Beanstalk はアプリケーションのビルドを試みません。 1. `Procfile` を作成します。 **Example `~/eb-java/Procfile`** ``` web: java -jar target/BeanstalkJavaExample-1.0-SNAPSHOT.jar ``` この `Procfile` は、アプリケーションの実行に使用されるコマンドを指定します。Java アプリケーション用の `Procfile` を含めない場合、Elastic Beanstalk はソースバンドルのルートに 1 つの JAR ファイルがあると想定し、`java -jar` コマンドを使用してそれを実行しようとします。 これで、アプリケーションをビルドして起動するための設定ファイルを設定できたので、デプロイする準備が整いました。 **環境を作成し、Java アプリケーションをデプロイするには** 1. **eb init** コマンドを使用して EB CLI リポジトリを初期化します。 ``` ~/eb-java eb init -p corretto java-tutorial --region us-east-2 Application java-tutorial has been created. ``` このコマンドは、`java-tutorial` という名前のアプリケーションを作成し、ローカルリポジトリを設定して最新の Java プラットフォームバージョンで環境を作成します。 1. (オプション) **eb init** を再度実行してデフォルトのキーペアを設定し、アプリケーションを実行している EC2 インスタンスに SSH を使用して connect できるようにします。 ``` ~/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 ] ``` 1 つのキーペアがすでにある場合はそれを選択するか、またはプロンプトに従ってキーペアを作成します。プロンプトが表示されないか設定を後で変更する必要がない場合は、**eb init -i** を実行します。 1. 環境を作成し、**eb create** を使用してそこにアプリケーションをデプロイします。Elastic Beanstalk は、アプリケーションの zip ファイルを自動的にビルドし、ポート 5000 で起動します。 ``` ~/eb-java$ eb create java-env ``` Elastic Beanstalk が環境を作成するのに約 5 分かかります。 ## ステップ 4: Elastic Beanstalk でアプリケーションを実行する 環境を作成するプロセスが完了したら、**eb open** でウェブサイトを開きます。 ``` ~/eb-java eb open ``` お疲れ様でした。Elastic Beanstalk で Java アプリケーションをデプロイしました。これにより、アプリケーション用に作成されたドメイン名を使用してブラウザ Window が開きます。 ## ステップ 5：クリーンアップ アプリケーションでの作業が終了したら、環境を終了できます。Elastic Beanstalk は、環境に関連付けられているすべての AWS リソースを終了します。 EB CLI を使用して Elastic Beanstalk 環境を終了するには、次のコマンドを実行します。 ``` ~/eb-java$ eb terminate ``` ## AWS アプリケーションの リソース 1 つのインスタンスアプリケーションを作成しました。1 つの EC2 インスタンスを持つ簡単なサンプルアプリケーションとして動作するため、ロードバランシングや自動スケーリングは必要ありません。単一インスタンスアプリケーションの場合、Elastic Beanstalk は次の AWS リソースを作成します。 + **EC2 インスタンス** – 選択したプラットフォームでウェブアプリケーションを実行するよう設定された Amazon EC2 仮想マシン。 各プラットフォームは、それぞれ特定の言語バージョン、フレームワーク、ウェブコンテナ、またはそれらの組み合わせをサポートするための、さまざまなソフトウェア、設定ファイル、スクリプトを実行します。ほとんどのプラットフォームでは、ウェブアプリケーションの前にウェブトラフィックを処理するリバースプロキシとして Apache または nginx のいずれかを使用します。そのプロキシがリクエストをアプリケーションに転送し、静的アセットを提供して、アクセスログとエラーログを生成します。 + **インスタンスセキュリティグループ** – ポート 80 上の受信トラフィックを許可するよう設定された Amazon EC2 セキュリティグループ。このリソースでは、ロードバランサーからの HTTP トラフィックが、ウェブ・アプリケーションを実行している EC2 インスタンスに達することができます。デフォルトでは、トラフィックは他のポート上で許可されません。 + **Amazon S3 バケット** – Elastic Beanstalk の使用時に作成されるソースコード、ログ、その他のアーティファクトの保存場所。 + **Amazon CloudWatch アラーム** – 環境内のインスタンスの負荷を監視する 2 つの CloudWatch アラーム。負荷が高すぎる、または低すぎる場合にトリガーされます。アラームがトリガーされると、Auto Scaling グループはレスポンスとしてスケールアップまたはダウンを行います。 + **CloudFormation スタック** – Elastic Beanstalk は CloudFormation を使用して環境内のリソースを起動し、設定変更を伝達します。リソースは、[CloudFormation コンソール](https://console.aws.amazon.com/cloudformation)に表示できるテンプレートで定義されます。 + **ドメイン名** – ウェブ・アプリケーションまでのルートとなるドメイン名であり、**subdomain*.*region*.elasticbeanstalk.com* の形式です。 Elastic Beanstalk は、これらのリソースをすべて管理します。環境を終了すると、Elastic Beanstalk は含まれているすべてのリソースを終了します。 ## 次の手順 アプリケーションを実行する環境を手に入れた後、アプリケーションの新しいバージョンや、異なるアプリケーションをいつでもデプロイできるようになります。新しいアプリケーションバージョンのデプロイは、プロビジョニングや EC2 インスタンスの再開が必要ないため、非常に素早く行えます。Elastic Beanstalk コンソールを使用して新しい環境を調べることもできます。詳細な手順については、このガイドの「*開始方法*」の章の「[環境を探索する](GettingStarted.md#GettingStarted.Explore)」を参照してください。 **その他のチュートリアルを試す** 異なるアプリケーション例の他のチュートリアルを試したい場合は、「[サンプルアプリケーションとチュートリアル](java-getstarted.md)」を参照してください。 1 つか 2 つのサンプルアプリケーションをデプロイし、ローカルにアプリケーションを開発して実行する準備が整ったら、「[Java 開発環境をセットアップする](java-development-environment.md)」を参照します。 ## Elastic Beanstalk コンソールでデプロイする Elastic Beanstalk コンソールを使用してサンプルアプリケーションを起動することもできます。詳細な手順については、このガイドの「*開始方法*」の章の「[サンプルアプリケーションを作成する](GettingStarted.md#GettingStarted.CreateApp)」を参照してください。