■AWSのCode シリーズ

CodeCommit
ソースコードを管理するGitリポジトリサービス

CodeBuild
ソースコードのビルド/テスティングサービス

CodeDeploy
ビルドされたモジュールのデプロイサービス

CodePipeline
継続的デリバリー/継続的インテグレーションをサポートするサービス

1.CodeCommit

概要
- 簡単にGitリポジトリをホストすることができる。
- サードバーティ製のツールも利用可能。
- プルリクエスト機能も利用可能。

接続方法
- コンソール
- https
- ssh

基本的な利用の流れ

その他参考情報

1-1 CodeCommitのリポジトリを作成する

[リポジトリ名]に任意のものを入力

1-2 初期セットアップ、コードのPush

IAMユーザの権限を使って、CodeCommitのリポジトリに接続し、Pushします。

gitを利用するのに最初に実行。

git config --global credential.helper '!aws --region ap-northeast-1 codecommit credential-helper $@'
git config --global credential.UseHttpPath true

誰が登録したかわかるようにユーザー情報を入れる。

git config --global user.name "[user_name]"
git config --global user.email "[user_email]"

gitでこのディレクトリを管理すると定義する。

git init

##.gitができあがっていることも確認しておく。
ll -a
drwxrwxr-x 7 ec2-user ec2-user 4096  3月 26 00:47 .git

先程作成したリポジトリをリモートとして登録する。

git remote add origin [https_clone_url]

git status
On branch master

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)

    buildspec.yml
    src/

nothing added to commit but untracked files present (use "git add" to track)

全てを追加する。

git add -A

git status
On branch master

No commits yet

Changes to be committed:
  (use "git rm --cached <file>..." to unstage)

    new file:   buildspec.yml
    new file:   src/appspec.yml
    new file:   src/img/img1.jpeg
    new file:   src/img/img2.jpeg
    new file:   src/index.php
    new file:   src/script/clean.sh

コミットする。

git commit -m "first commit"
[master (root-commit) e9e67f0] first commit
 6 files changed, 69 insertions(+)
 create mode 100644 buildspec.yml
 create mode 100644 src/appspec.yml
 create mode 100644 src/img/img1.jpeg
 create mode 100644 src/img/img2.jpeg
 create mode 100644 src/index.php
 create mode 100644 src/script/clean.sh

pushする。

git push origin master
[ec2-user@demo-batch work]$ git push origin master
Counting objects: 11, done.
Compressing objects: 100% (9/9), done.
Writing objects: 100% (11/11), 516.43 KiB | 18.44 MiB/s, done.
Total 11 (delta 0), reused 0 (delta 0)
To https://git-codecommit.ap-northeast-1.amazonaws.com/v1/repos/demo-codcommit
 * [new branch]      master -> master

コンソールからpushされたことも確認する。

2.CodeBuild

概要

ビルドサービス
ソースコードのコンパイルを行ったり、テストを実行する環境を簡単に構築することができる。
CodeBuild上で行う作業については、buildspec.ymlに定義する。

流れ

2-1 成果物格納用のS3バケットを準備しておく

S3バケットを作成し、バージョニングを有効にしておく。

バージョニングについては実際に試されている↓の記事が参考になりました。
今さらだけどS3のバージョニングを試してみた。

2-2 buildspec.ymlを作成する

buildspec.yml


##[application-name] は後で必要になるので適当な名前に、
##[S3-bucket-name]は「2-1 成果物格納用のS3バケットを準備しておく」で作成したS3バケットを指定。

version: 0.1

phases:
  build:
    commands:
      - aws deploy push --region ap-northeast-1 --application-name [application-name] --s3-location s3://[S3-bucket-name]/sample.zip --source src
artifacts:
  files:
    - '**/*'
  base-directory: src
  name: sample.zip

2-3 CodeBuildプロジェクトを作成する

[Project name] は任意の名前を入力

[Source provider][リポジトリ] は「1.AWSCodeCommit」のリポジトリから取ってくるように指定します。

[Operating system]は Ubuntu しか選べません。
Amazon Linux2も選べるようになりましたね。
[Runtime]は PHP にしておきます。

[Service role]は New service role で新しく作成する。※後でポリシーを追加します。

[Type]は AmazonS3
[Bucket name]に作成したS3バケットを指定
[Enable semantic versioning]にチェック
[Namespace type]はBuild IDを指定

2-4 Service roleにIMAポリシーを追加する

先ほど作成した、Service roleに以下2つのポリシーを追加してください。

AWSCodeDeployDeployerAccess AmazonS3FullAccess

3.CodeDeploy

デプロイ自動化サービス
appspec.ymlにデプロイ時の動作を定義する
デプロイ方式を1台、半分、全台など選択可能。
デプロイ先にエージェントをインストールする必要がある。

AppSpec の「hooks」
Hooksでライフサイクルイベントを設定してデプロイ時に任意のスクリプトを実行できます。
また、スクリプトの実行ポイントは複数あり、細かく制御可能です。
フックスクリプトはアプリケーションのアーカイブ（zip）にバンドルし、S3やCodeCommitにアップロードします。
通常、アプリケーションにhooksディレクトリやScripsディレクトリを作成し、実行権を付与したスクリプトファイルを配置します。

AppSpec の「hooks」セクション
 CodeDeployのApplicationStopイベントフックはどう実行される?

3-1 EC2インスタンスにIAMロールを作成する

EC2に以下のIAMロールのポリシーで作成し、EC2にアタッチする。

AmazonS3FullAccess

3-2 EC2インスタンスにCodeDeployエージェントをインストールする

wget https://aws-codedeploy-ap-northeast-1.s3.amazonaws.com/latest/install
chmod +x install
sudo ./install auto

3-3 CodeDeploy用のIAMロールを作成する

CodeDeployに以下のIAMロールのポリシーで作成する。

AWSCodeDeployRole

3-4 CodeDeployアプリケーションを用意する

[アプリケーション名]には、CodeBuildで決めたアプリケーション名を入力してください。
[コンピューティングプラットフォーム]は、EC2。

デプロイグループの作成
[デプロイグループ名]に任意のものを入力。

[サービスロール]は、「3-3 CodeDeploy用のIAMロールを作成する」で作成したものを選択。

[デプロイタイプ]はインプレース。

[環境設定]はAmazon EC2 インスタンス。

[デプロイ設定]は、CodeDeployDefault.AllAtOne。

[ロードバランサー]も指定。

3-5 CodeBuildを開始する

CodeBuildから[Start build]

[Container] 2019/03/27 11:15:26 Waiting for agent ping
[Container] 2019/03/27 11:15:29 Waiting for DOWNLOAD_SOURCE
[Container] 2019/03/27 11:15:33 Phase is DOWNLOAD_SOURCE
[Container] 2019/03/27 11:15:33 CODEBUILD_SRC_DIR=/codebuild/output/src359827589/src/git-codecommit.ap-northeast-1.amazonaws.com/v1/repos/demo-codcommit
[Container] 2019/03/27 11:15:33 YAML location is /codebuild/output/src359827589/src/git-codecommit.ap-northeast-1.amazonaws.com/v1/repos/demo-codcommit/buildspec.yml
[Container] 2019/03/27 11:15:33 Processing environment variables
[Container] 2019/03/27 11:15:33 Moving to directory /codebuild/output/src359827589/src/git-codecommit.ap-northeast-1.amazonaws.com/v1/repos/demo-codcommit
[Container] 2019/03/27 11:15:33 Registering with agent
[Container] 2019/03/27 11:15:33 Phases found in YAML: 1
[Container] 2019/03/27 11:15:33 BUILD: 1 commands
[Container] 2019/03/27 11:15:33 Phase complete: DOWNLOAD_SOURCE Success: true
[Container] 2019/03/27 11:15:33 Phase context status code: Message:
[Container] 2019/03/27 11:15:33 Entering phase INSTALL
[Container] 2019/03/27 11:15:33 Phase complete: INSTALL Success: true
[Container] 2019/03/27 11:15:33 Phase context status code: Message:
[Container] 2019/03/27 11:15:34 Entering phase PRE_BUILD
[Container] 2019/03/27 11:15:34 Phase complete: PRE_BUILD Success: true
[Container] 2019/03/27 11:15:34 Phase context status code: Message:
[Container] 2019/03/27 11:15:34 Entering phase BUILD
[Container] 2019/03/27 11:15:34 Running command aws deploy push --region ap-northeast-1 --application-name leomaro --s3-location s3://leomaro-codebuild/sample.zip --source src
To deploy with this revision, run:
aws deploy create-deployment --application-name leomaro --s3-location bucket=leomaro-codebuild,key=sample.zip,bundleType=zip,eTag=cc07369e1d36342a99f827d40358d26f,version=q_0JhOdGpyuCg5B1lsavI4Avd5lqnaFa --deployment-group-name <deployment-group-name> --deployment-config-name <deployment-config-name> --description <description>
 [Container] 2019/03/27 11:15:40 Phase complete: BUILD Success: true
[Container] 2019/03/27 11:15:40 Phase context status code: Message:
[Container] 2019/03/27 11:15:40 Entering phase POST_BUILD
[Container] 2019/03/27 11:15:40 Phase complete: POST_BUILD Success: true
[Container] 2019/03/27 11:15:40 Phase context status code: Message:
[Container] 2019/03/27 11:15:40 Expanding base directory path: src
[Container] 2019/03/27 11:15:40 Assembling file list
[Container] 2019/03/27 11:15:40 Expanding src
[Container] 2019/03/27 11:15:40 Expanding artifact file paths for base directory src
[Container] 2019/03/27 11:15:40 Assembling file list
[Container] 2019/03/27 11:15:40 Expanding **/*
[Container] 2019/03/27 11:15:40 Found 5 file(s)
[Container] 2019/03/27 11:15:40 Updating artifact name as sample.zip
[Container] 2019/03/27 11:15:40 Phase complete: UPLOAD_ARTIFACTS Success: true
[Container] 2019/03/27 11:15:40 Phase context status code: Message:

CodeDeployのRevisionに作成されていることがわかります。

3-6 デプロイする

作成されたRevisionを指定してデプロイしていきます。

[デプロイ]から[デプロイの作成]

[デプロイグループ]は「3-4 CodeDeployアプリケーションを用意する」で作成されたものを指定。
[リビジョンの場所]で「3-5 CodeBuildを開始する」で作成されたものを指定。

これでデプロイは完成です。

4.CodePipeline

継続的デリバリーをサポートするサービス
Codecommit/CodeBuild/CodeDeployの流れをパイプラインとして定義することで、ソースコードがコミットされたらデプロイまで自動化

4-1 パイプラインを作成する

Step 1：パイプラインの設定を選択する
[パイプライン名]には任意の名前を入力。
[Service role]はNew service roleでここで新しく作成します。
[アーティファクトストア]はカスタムロケーションでS3バケットを指定します。

Step 2：ソースステージを追加する
[ソースプロバイダー]はAWS Codecommitにし、「1.CodeCommit」で作成したものを指定していきます。

Step 3：ビルドステージを追加する
[プロバイダーを構築する]はAWS CodeBuildにし、「2.CodeBuild」で作成したものを指定していきます。

Step 4：デプロイステージを追加する
[デプロイプロバイダー]をAWS CodeDeployにし、「3.CodeDeploy」で作成したものを指定していきます。

Step 5：レビュー
「パイプラインを作成する」

Pipeline作成時と、CodecommitのPush時に動作します。
なので、ここでは何も変わらないので次で動作を確認してみる。

4-2 CodecommitでPushし動作を確認する

ファイルを作成してPushする。

git add -A
git commit -m "fix."
git push origin master

コンソール上から動作しているか確認してみましょう。

AWS Code シリーズ