【CodePipeline×ElasticBeanstalk】JavaアプリケーションをCodePipelineでElasticBeanstalkにCI/CDする その3

11756 ワード
spring-boot AWS ElasticBeanstalk Java CodePipeline Java テキストリンク

Javaアプリケーション（データベースから値を取得し、JSON形式で結果を返す）をCodePipelineでElasticBeanstalkにCI/CDするハンズオンです。
【CodePipeline×ElasticBeanstalk】JavaアプリケーションをCodePipelineでElasticBeanstalkにCI/CDする その2
の続きです。

環境

  • OS：Windows10
  • IDE：Eclipse 2020-03
  • JDK：Amazon Correto 8
  • フレームワーク：Spring Boot
  • AWS
    • CodePipeline
      • CodeCommit
      • CodeBuild
      • CodeDeploy
    • Elastic Beantalk
      • Java SE（Java 8 バージョン 2.10.8）
        → 異なるプラットフォームブランチ（Corretto 11など）でも同手順でできます。
      • RDS：MySQL Community Edition（バージョン8.0.17）

手順

5. パイプラインの作成

いよいよ最終段階。
CodePipelineを作成して、Elastic Beanstalk環境にデプロイします。

[1] CodePipelineの作成

(1)マネジメントコンソールにて、CodePipelineを探し、クリック。

(2)「パイプラインを作成する」をクリック。

(3)「パイプラインの設定を選択する」画面に遷移したら、「パイプライン名」を入力し（①）、「新しいサービスロール」を選択し(②：デフォルト）、「次に」をクリック（③）。
これにより、パイプライン作成時に「ロール名」に記載のロールが作成されます。

(4)次に、「ソースステージを追加する」画面です。
以下の通り入力・選択し、「次に」をクリック（⑤）

No 名称 設定内容
① ソースプロバイダー AWS CodeCommit
② リポジトリ名 手順2：Gitリポジトリの作成で作成したリポジトリ名
③ ブランチ名 master
④ 検出オプションを変更する Amazon CloudWatch Events（推奨）

(5) 続いて、「ビルドステージを追加」画面です。
「プロバイダーを構築する」にて、「AWS CodeBuild」を（①）、「リージョン」は「アジアパシフィック（東京）」を選択し（②）、「プロジェクトを作成する」をクリック（③）。

(6)「ビルドを作成する」ウィンドウが立ち上がります。
以下の通り入力・設定し、「CodePipelineに進む」をクリック。

No 名称 設定内容
① プロジェクト名 任意の名称（今回は「sample-eb-java-build」）
② 環境イメージ マネージド型イメージ
③ オペレーティングシステム AmazonLinux 2
④ ランタイム Standard
⑤ イメージ aws/codebuild/amazonlinux2-x86_64-standard:3.0
⑥ イメージのバージョン 最新のものを選択
⑦ 環境タイプ Linux
⑧ サービスロール 新しいサービスロール
⑨ ロール名 自動で入力される（必要に応じて変更）
⑩ ビルド仕様 ビルドコマンドの挿入
⑪ ビルドコマンド ※の通り入力
⑫ 入力モード エディタ（キャプチャは「エディタに切り替え」をクリックしてエディタでの編集モードになっている状態）
※ビルドコマンドの内容
version: 0.2

phases:
  install:
    runtime-versions:
      java: corretto8
  build:
    commands:
       - ./gradlew build

上記は、javaのcorretto8をインストールして、ビルドを実施する、という内容になっています。

(6) 「ビルドステージを追加する」画面に戻ったら、「CodeBuildで<プロジェクト名>が正常に作成されました。」となっていることを確認し（①）、「次に」をクリック（②）。

(7) 「デプロイ - オプショナル」画面に遷移したら、以下の通り入力・選択し、「次に」（⑤）をクリック。

No 名称 設定内容
① デプロイプロバイダー AWS Elastic Beanstalk
② リージョン アジアパシフィック（②）
③ アプリケーション名 「3. Elastic Beanstalk環境の作成」で作成したアプリケーション
④ 環境名 「3. Elastic Beanstalk環境の作成」で作成した環境

(8) 「レビュー」画面に遷移したら、内容を確認し、「パイプラインを作成する」をクリック。

(9) パイプラインが作成され、「2. Gitリポジトリの作成」にて、コミット・プッシュされたコードが順に、ビルド、デプロイされます。

(10) デプロイまで成功（緑色のチェックマークがつく）になったら、OKです。

今後は、CodeCommitのリポジトリのmasterブランチに変更が加わるたびに、このパイプラインが実行されます。
実環境であれば、子ブランチからプルリク → マージされた場合に実行される形になるでしょう。

もし、パイプライン実行時にエラーが発生した場合は、
【CodePipeline×Elastic Beanstalk】JavaアプリケーションをCodePipelineでElasticBeanstalkにCI/CDする、のエラーとその対応方法まとめ
を参考に解決してみてください。

(11) Elastic Beanstalkの確認もしましょう。
マネジメントコンソールにて、「サービス」（①） > 「Elastic Beanstalk」の順にクリック。

(12) ナビゲーションペインにて、「環境」をクリック。

(13) 以下のように、ヘルスが「OK」となっていれば成功です！（①）

[2] 動作確認

(1) 動作確認をしましょう。
ブラウザにて、以下の通り入力＆Enterして、以下のような結果が返却されれば成功です！

実行URL
(2)の②に記載のドメイン/shop-information/1

6. 後片付け

最後に後片付けを行います。
このまま放置しておくと、Elastic Beanstalk環境の作成にて作成された、EC2インスタンス、RDSインスタンスの稼働分だけ、課金されてしまいますので、後片付け（削除）しておきましょう。

[1]Elastic Beanstalk

(1) マネジメントコンソールにて、「サービス」（①） > 「Elastic Beanstalk」の順にクリック。

(2) ナビゲーションペインにて、「環境」をクリック。

(3) 対象の環境のラジオボタンを選択し（①）、「アクション」 > 「環境の終了」をクリック。

(4) 「環境の削除の確認」画面に遷移するので、環境の名前を入力し（①）、「削除」をクリック（②）。

(5) 続いて、「アプリケーション」の削除。
Elastic Beanstalkのナビゲーションペインにて、「アプリケーション」をクリック。

(6) 対象のアプリケーションのラジオボタンを選択し（①）、「アクション」 > 「アプリケーションの削除」をクリック。

(7)「アプリケーションの削除の確認」のモーダルが立ち上がるので、対象のアプリケーション名を入力し（①）、「削除」をクリック（②）。

[2]CodePipeline

(1) 次に、CodePipeline。
少なくとも、コードに変更を行わなければ料金は発生しないのですが、逆を言えば、なんらかの拍子に変更が加わってしまうと料金が発生してしまうので、こちらも削除しておきましょう。

マネジメントコンソールにて、「サービス」（①） > 「Code Pipeline」の順にクリック。

(2) 対象のパイプラインのラジオボタンを選択し（①）、「パイプラインを削除する」をクリック（②）。

(3) 削除確認のモーダルが立ち上がるので、「delete」と入力し（①）、「削除」をクリック（②）

終わりに

長時間お疲れさまでした。

自分は、1-[3]-(5)のgradlewの権限変更で3日、そして、5-[1]-(10）のデプロイの段階で3回エラーで躓いて何度も心が折れそうになりました。
だけど、できた時の達成感はハンパない！！
少しでも多くの皆さんのお役に立てばと思い、記事にまとめました。

もし至らない点、気づいた点などあればコメントいただければ幸いです。

更新履歴

  • 2020/08/21：手順「5. パイプラインの作成」のビルドコマンドの内容を変更

参考

5. パイプラインの作成

6. 後片付け