EC2にJARファイルを配置し、Webアプリケーションを起動してみた

 

  •  
  • Facebookでシェア  
MAXIMUM が に投稿

タグ

今回は、Terraformで作成したEC2インスタンスにJARファイルを配置し、Webアプリケーションを起動します。

0. 前提

今回の操作では、以前Terraformで作成したEC2インスタンスを使用します。
環境構築については、過去の記事を参照してください。

今回の環境構成は下記のとおりです。

項目 設定
リージョン 東京(ap-northeast-1)
OS Amazon Linux 2023
インスタンスタイプ t3.micro
Java 17
Webアプリケーション Spring Boot
ポート 8080

今回の構成は下記のとおりです。

ローカルPC
  │
  │ SCPでJARファイルを転送
  ↓
EC2インスタンス
  ├─ Java 17
  └─ app.jar
       └─ Spring Boot(8080番ポート)

今回はWebアプリケーションの起動確認のみ行うため、データベースには接続しません。

1. JARファイルを確認

まず、ローカルPCにあるJARファイルを確認します。
MavenでビルドしたJARファイルは、通常targetディレクトリに生成されます。 下記のコマンドで確認します。

ls -lh *.jar

今回は、既に作成済みのdemo-0.0.1-SNAPSHOT.jarを使用します。
※Jar作成例

2. EC2インスタンスの接続先を取得

続いて、Terraformで作成したEC2インスタンスのパブリックIPアドレスを取得します。
ローカルPCのターミナルで下記のコマンドを実行します。

EC2_IP=$(terraform -chdir="$HOME/terraform-ec2-study" output -raw public_ip)

取得したIPアドレスを確認します。

echo "$EC2_IP"

パブリックIPアドレスが表示されればOKです。

3. JARファイルをEC2に配置

SCPを使用して、ローカルPCからEC2インスタンスへJARファイルを転送します。
SCPとは、SSHを利用してファイルを転送する仕組みです。
JARファイルが配置されているプロジェクトのルートディレクトリで下記のコマンドを実行します。

scp -i ~/.ssh/terraform-study-ec2 demo-0.0.1-SNAPSHOT.jar ec2-user@"$EC2_IP":/home/ec2-user/app.jar

今回は、EC2の/home/ec2-user/にapp.jarという名前で配置します。
転送が完了したら、SSHでEC2インスタンスへ接続します。

ssh -i ~/.ssh/terraform-study-ec2 ec2-user@"$EC2_IP"

接続後、下記のコマンドでJARファイルを確認します。

ls -lh ~/app.jar

app.jarが表示されれば、ファイルの配置は完了です。

4. Webアプリケーションを起動

EC2インスタンス上でWebアプリケーションを起動します。
まず、Javaのバージョンを確認します。

java -version

Java 17が表示されればOKです。
続いて、下記のコマンドを実行します。

java -jar ~/app.jar --server.address=127.0.0.1

今回はEC2内部からのみ接続を受け付ける設定にしています。
正常に起動すると、下記のようなログが表示されます。

Started EC2 Demo at http://127.0.0.1:8080/
Health: http://127.0.0.1:8080/health
Started at 2026-11-19T16:17:25.414494907+09:00

これでWebアプリケーションが起動しました。
次作業用に別タブでターミナルを開き直しておいてください。

5. Webアプリケーションの動作確認

続いて、ローカルPCのブラウザからWebアプリケーションにアクセスします。
今回はSSHポートフォワーディングを使用します。

SSHポートフォワーディングとは、SSH接続を経由してEC2内部のポートにアクセスする仕組みです。
Webアプリケーションを起動したターミナルはそのままにして、ローカルPCで別のターミナルを開きます。
新しいターミナルでパブリックIPアドレスを取得し、SSH接続します。

EC2_IP=$(terraform -chdir="$HOME/terraform-ec2-study" output -raw public_ip) && ssh -i ~/.ssh/terraform-study-ec2 -N -L 18080:127.0.0.1:8080 ec2-user@"$EC2_IP"

続いて、ブラウザから下記のURLにアクセスします。

http://localhost:18080/

画面に下記のようなWebアプリケーションの応答が表示されればOKです。

※表示内容は使用するJARファイルによって異なります。

今回はSSH経由で接続するため、セキュリティグループで8080番ポートを外部に公開する必要はありません。

6. Webアプリケーションを停止

動作確認が完了したら、Webアプリケーションを停止します。
起動しているターミナルでCtrl + Cを入力します。
同様に、SSHポートフォワーディングもCtrl + Cで終了します。
最後にSSH接続を終了します。

exit

なお、今回の方法ではWebアプリケーションを手動で起動しています。
サーバー再起動時にも自動起動させたい場合は、systemdなどを使用してサービス化する必要があります。

また、EC2インスタンスを今後使用しない場合は、Terraformで削除します。

terraform -chdir="$HOME/terraform-ec2-study" destroy

確認画面でyesを入力すると、Terraformで作成したリソースが削除されます。
※EC2インスタンスを削除すると、配置したJARファイルも失われます。

7. まとめ

今回はEC2インスタンスにJARファイルを配置し、Webアプリケーションを起動しました。
ローカルPCにあるJARファイルをSCPで転送することで、EC2上でもWebアプリケーションを実行できました。
また、SSHポートフォワーディングを使用することで、8080番ポートを外部公開せずにブラウザから動作確認できました。

コメントを追加

プレーンテキスト

  • HTMLタグは利用できません。
  • 行と段落は自動的に折り返されます。
  • ウェブページのアドレスとメールアドレスは自動的にリンクに変換されます。
CAPTCHA
この質問はあなたが人間の訪問者であるかどうかをテストし、自動化されたスパム送信を防ぐためのものです。
画像
Jar起動
添付ファイル