More than 3 years have passed since last update.

富士通システムズウェブテクノロジーAdvent Calendar 2019

AWS初心者がCodeBuildとCodeDeployを使ってCI/CDやってみた

Posted at 2019-12-17

富士通システムズウェブテクノロジー Advent Calendar 2019 18日目の投稿です。
(お約束)記事の内容は全て個人の見解であり、執筆内容は執筆者自身の責任です。所属する組織は関係ありません。
執筆者は入社三年目なので、至らない点や誤り等あればご指摘いただけると泣いて喜びます。

AWSでCI/CDやってみようと思った理由

せっかくやるなら自動化でしょって思ったから
クラウドを使ってCI/CDをできるってかっよくね？そう思ったから
どうせやるなら記録に残った方がいいかな？と思ったから
・・・そうです。ただの自己満です。
どうか、わがままにお付き合い下さい。

筆者のレベル

リージョンの指定方法知らずにずっとオハイヨのリージョンで作業してたぐらいにはAWS初心者です
CI/CDについてちょっとは分かる
他のクラウドに触れたことがある
dockerは多少使える
得意と言えるほどでもないけどできる分野
- インフラ < ミドル < アプリの順番

前提

AWSのアカウント発行する
CI/CDについての説明は省略
MVCモデルで構築したJava言語のソースコードを使用
ビルドツールはGradleを使用（独自docker image）
AWSのロールについての説明は無いです
備忘録的に書いてるだけなので悪しからず

ざっくりな全体構成

鉄板構成なんじゃないかと

かる～く使用するツールの説明

AWS CodeCommit

gitリポジトリサービス
Javaのソースコードを配備するのに使用しました

AWS CodeBuild

専用のビルドスクリプトを元にビルドやらテストやらできるやつ
デフォルトでは8種類のビルド環境を用意してくれてる
AWS上に構築した、独自のビルド環境（dockerイメージ）も使用できる
ビルド + S3（後述）に成果物を格納するのに使用しました

AWS CodeDeploy

専用のデプロイスクリプトを元に成果物を特定のサーバやサービスに配備したり、シェルの実行やらできるやつ
S3（後述）に配備された成果物をEC2（後述）に構築したVMにデプロイし、成果物の展開やら実行やらをするのに使用しました

EC2

VM構築サービス
OSは色々選べます（今回はCentOSを選びました）
VMにtomcatをインストールしてMVCで作ったJavaのソースコードを実行できるようにしました

S3

ストレージです
バックアップファイルやアーカイブなど色々なデータを置くことができます
成果物（warファイル）の置き場として使用しました

ECR

Container Registryです（dockerイメージ置き場だと思ってもらえれば）
コンテナベースで作成したサービス等の配備先として使用できます
今回は独自のビルド環境を構築したのでそちらの配備先として使用しました
CodeDeployに必要なagentはインストールしました

いざ実践

CodeCommitにリポジトリを作成する

入力された数値の足し算だけをして次画面に結果を返却するだけのプログラムを作って、CodeCommit上に格納しただけ

（ソースは公開してないです。需要があればソース公開します。）

Codebuldeでソースコードをビルドする前に...

ECR上にビルド環境を作成する

（やった後にDockerfileで書いていないことを非常に後悔...）

Gradleプロジェクトをビルドするための環境をdockerコンテナベースで用意する

ローカルにdockerサービスをインストール
CentOSのdockerイメージをPull + 起動
Java + Gradleのインストール
dockerイメージをdocker tagコマンドでイメージ名を書き換え
作成したECRにイメージをPUSH

これだけでAWS上に自身が作成したdockerイメージを格納することが可能

S3に成果物を格納する領域を作成する

※ S3上に構築するバケット名は重複が認められていない為、独自の名前を指定して作成する。

CodeBuile上にビルドプロジェクトを作成する

送信元に上記手順で作成したCodeCommitのリポジトリを指定する
環境に上記手順で作成したECR上のdockerイメージを指定する
ビルドの仕様にbuildspecを使用するを選択する
アーティファクトに上記手順で作成したS3上のバケットを指定する

buildspec.ymlを作成する

CodeCommit上のリポジトリのルートディレクリにbuildspec.ymlという名前のファイルを作成します

version: 0.2 
 
phases: 
  install: 
    commands:  
      - gradle -v 
  build: 
    commands: 
      - gradle war 
      - tar -cvf sampleJava.tar ./build ./appspec.yml ./deploy.sh 
       
artifacts: 
  files: 
    - ./sampleJava.tar

phasesタグにはinstallジョブとbuildタグを指定
installタグではgradleのバージョン確認コマンドのみ実行（もちろんなくてもいい）
biuldタグではgradleのwarファイル作成コマンドと、成果物をtarに固めるコマンドを実行

ビルドプロジェクトを動かしてみる

成功しました
画面をスクロールしていくとログも確認することができます。

成果物がS3上に格納されたことを確認

ログには格納が成功した旨がログ出力されてる

S3上に無事格納されてました

CodeDeployで成果物をデプロイするまえに...

EC2上にVMを構築する

OSにCentOSを使用しました
tomcatをインストールしました
CodeDeploy用のagentをインストールしました

appspec.ymlを作成する

CodeCommit上のリポジトリのルートディレクリにappspec.ymlという名前のファイルを作成します

version: 0.0 
os: linux 
files: 
  - source: / 
    destination: /home/centos 
hooks: 
  ApplicationStart: 
    - location: deploy.sh 
      runas: root

上記手順で作成したVMの/home/centosディレクトリに成果物を配備します
デプロイ時にdeploy.shを実行します
deploy.shの実行はrootユーザで行います

また、デプロイ時に実行するコマンドをまとめたシェルを作成しました

systemctl stop tomcat 
rm -fr /var/lib/tomcat/webapps/sampleJava/* 
mkdir /var/lib/tomcat/webapps/sampleJava 
cp /home/centos/build/libs/sampleJava.war /var/lib/tomcat/webapps 
unzip /var/lib/tomcat/webapps/sampleJava.war -d /var/lib/tomcat/webapps/sampleJava 
systemctl start tomcat