今年のAWS RE:INVENTは盛り沢山でしたね。今回は、そのうちの１つ、CodeBuildを試してみようと思います。基本的にはGetting Startedに従って進めていきます。

1. ビルドのOutputを格納するS3バケットを作る

ビルドのOutputを格納するため、codebuild-demo-project-outputという名前でS3のバケットを作成する。

2. コードを書く

早速Goのコードを書く。今回は、codebuildというディレクトリを作成し、シンプルにSum関数を１つだけ持つコードを作った。

codebuild.go

package codebuild

// Sum adds two numbers.
func Sum(a, b int) int {
	return a + b
}

3. ビルドスペックを書く

ビルドスペックは、ビルドコマンドと関連する設定が記述されたファイルになる。YAMLで記述され、AWS CodeBuildでのビルドに利用される。

以下のようなbuildspec.ymlというファイルを作成し、プロジェクト直下に保存する。

buildspec.yml

version: 0.1

environment_variables:
  plaintext:
    MY_ENV: "codebuild"

phases:
  install:
    commands:
      - echo Nothing to do in the install phase...
  pre_build:
    commands:
      - echo Nothing to do in the pre_build phase...
  build:
    commands:
      - echo Build started on `date`
      - go build codebuild.go
  post_build:
    commands:
      - echo Build completed on `date`
artifacts:
  type: zip
  files:
    - codebuild

それぞれの項目は以下の通りである。詳しくはこちら。

|項目|必須？|説明|
|:--|:--|:--|:--|
|version|必須|ビルドスペックのバージョン。現在最も新しいのが0.1
|environment_variables|任意|環境変数
|phases|必須|install, pre_build, build, post_buildの4つの段階それぞれで実行するコマンドを列挙する。それぞれの段階の記述は任意となるため、4段階すべてを記入する必要はない。
|artifacts|必須|CodeBuildがビルドのOutputを出力するための情報。typeは現在zipのみが対応。filesにはビルド環境でのビルドの生成物の場所を指定する。

ビルドスペックはプロジェクトのリポジトリに含める以外にも、ビルドプロジェクトを作成する際に宣言することができる。

4. プロジェクトをgithubにプッシュする

github上でcodebuild-demo-projectというリポジトリを作成し、以下のようにプロジェクトをプッシュする。リポジトリは自分のものを指定する。

git init
git add .
git commit -m "First commit"
git remote add origin git@github.com:Iwark/codebuild-demo-project.git
git push -u origin master

5. ビルドプロジェクトの作成

コンソールまたはAWS CLIを用いてビルドプロジェクトを作成する。今回はコンソールから作成する。

東京リージョンではまだ使えないので、オレゴンを選択する。

Project名はcodebuild-demo-projectにする。
RepositoryはGithubを選択し、先ほど作成したリポジトリを接続する。
RuntimeはGolangを選択する。
Versionは1.7.3を選択する。
ArtifactsはAmazon S3を選択する。
Bucketはcodebuild-demo-project-outputを選択。

あとはそのままの状態でContinue、Save and Buildする。

6. ビルドの開始

Start buildをすると、ビルドが開始される。

あとがき

とりあえずビルドまでは簡単にできました。

Go1.7なのにvendoringが効いていないのか、vendor内にあるパッケージがnot foundになるので困ってます。またちゃんと調べてみようと思います。