CodeBuild の buildspec.yml のバージョン 0.2 がリリースされていました

藤本真司

2017.05.24

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

こんにちは、藤本です。

現地時間 5/9 に Forum ページで CodeBuild の buildspec.yml のバージョン 0.2 がリリースされた旨が公開されていました。

Announcement: Introducing buildspec v0.2

変更内容

変更内容は Forum ページに記載がある通りです。

環境変数の指定方法

環境変数の設定キーがenvironment_variablesからenvに、plaintextがvariablesに変わりました。

0.2 の記法

buildspec.yml

env:
  variables:
    KEY1: VALUE1
    KEY2: VALUE2

0.1 の記法

buildspec.yml

environment_variables:
  plaintext:
    KEY1: VALUE1
    KEY2: VALUE2

スッキリしましたね。

なお、バージョン 0.2 ではenvironment_variablesの記述は非推奨となっています。既存のbuildspec.ymlのバージョンを 0.2 へ変更する際は、環境変数の記法を忘れずに変更しましょう。

同一シェルによる実行

0.1 まではコマンド一つ一つが異なるシェルで実行されていたようです。カレントディレクトリがコマンド毎に元に戻されたり、設定した環境変数がコマンド毎にリセットされる状況でした。バージョン 0.2 を利用することで同一シェルでコマンドが実行されるため、カレントディレクトリ、環境変数が保持されるようになりました。

例えば、下記のコマンドはカレントディレクトリのパスを表示して、親階層へ移動して、カレントディレクトリのパスを表示します。手元のターミナルで試していただければ分かりますが、pwdの結果は異なります。ただ今までの CodeBuild では同じ結果が返ってきました。

buildspec.yml

phases:
  build:
    commands:
      - pwd
      - cd ..
      - pwd

以前、私がハマり、下記エントリに記載したものが解消されていました。

Elastic Beanstalk のカスタムプラットフォームを継続的デリバリする

バージョン 0.2 の利用方法

現在、buildspec.ymlはバージョン 0.1、0.2 のどちらでも使えます。今まで使っていたものが使えなくなるということは今現在はありません。バージョン 0.2 を利用したい場合、buildspec.ymlのversionに0.2を指定するだけです。

buildspec.yml

version: 0.2

試してみた

それでは新旧のバージョンで動作を比較してみましょう。

バージョン 0.1

まずはバージョン 0.1 だとそもそもどういう記述と動作か確認しておきます。

buildspec.yml

buildspec.yml

version: 0.1

environment_variables:
  plaintext:
    KEY: VALUE

phases:
  build:
    commands:
      - pwd
      - cd .. && pwd
      - pwd
      - echo $KEY
      - KEY=CHANGE
      - echo $KEY

ソースコードリポジトリへのプッシュ

$ git commit -am "buildspec.yml test v0.1"
[master e11be3c] buildspec.yml test v0.1
1 file changed, 15 insertions(+), 23 deletions(-)
rewrite buildspec.yml (95%)

$ git push origin master
Counting objects: 3, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 411 bytes | 0 bytes/s, done.
Total 3 (delta 1), reused 0 (delta 0)
To ssh://git-codecommit.us-west-2.amazonaws.com/v1/repos/NodePlatform_AmazonLinux
3afe8bb..e11be3c master -> master

ビルドの実行

$ aws codebuild start-build --project-name buildtest --region us-west-2

"id": "buildtest:9aa4f35d-074f-445d-a43f-b906a242c9c6",

動作確認

Build のログを CloudWatch Logs から確認します。

$ aws logs get-log-events --log-group-name /aws/codebuild/buildtest --log-stream-name 9aa4f35d-074f-445d-a43f-b906a242c9c6 --region us-west-2

{
"ingestionTime": 1495589921653,
"timestamp": 1495589921000,
"message": "[Container] 2017/05/24 01:38:40 Running command pwd\n"
},
{
"ingestionTime": 1495589921653,
"timestamp": 1495589921000,
"message": "/tmp/src634227524/src\n"
},
{
"ingestionTime": 1495589921653,
"timestamp": 1495589921000,
"message": "\n"
},
{
"ingestionTime": 1495589921653,
"timestamp": 1495589921000,
"message": "[Container] 2017/05/24 01:38:40 Running command cd .. && pwd\n"
},
{
"ingestionTime": 1495589921653,
"timestamp": 1495589921000,
"message": "/tmp/src634227524\n"
},
{
"ingestionTime": 1495589921653,
"timestamp": 1495589921000,
"message": "\n"
},
{
"ingestionTime": 1495589921653,
"timestamp": 1495589921000,
"message": "[Container] 2017/05/24 01:38:40 Running command pwd\n"
},
{
"ingestionTime": 1495589921653,
"timestamp": 1495589921000,
"message": "/tmp/src634227524/src\n"
},
{
"ingestionTime": 1495589921653,
"timestamp": 1495589921000,
"message": "\n"
},
{
"ingestionTime": 1495589921653,
"timestamp": 1495589921000,
"message": "[Container] 2017/05/24 01:38:40 Running command echo $KEY\n"
},
{
"ingestionTime": 1495589921653,
"timestamp": 1495589921000,
"message": "VALUE\n"
},
{
"ingestionTime": 1495589921653,
"timestamp": 1495589921000,
"message": "\n"
},
{
"ingestionTime": 1495589921653,
"timestamp": 1495589921000,
"message": "[Container] 2017/05/24 01:38:40 Running command KEY=CHANGE\n"
},
{
"ingestionTime": 1495589921653,
"timestamp": 1495589921000,
"message": "\n"
},
{
"ingestionTime": 1495589921653,
"timestamp": 1495589921000,
"message": "[Container] 2017/05/24 01:38:40 Running command echo $KEY\n"
},
{
"ingestionTime": 1495589921653,
"timestamp": 1495589921000,
"message": "VALUE\n"
},

カレントディレクトリも、環境変数も、コマンド単位でリセットされていることが分かります。

バージョン 0.2

続いて、バージョン 0.2 の記述と動作を確認します。

buildspec.yml

version: 0.2

env:
  variables:
    KEY: VALUE

phases:
  build:
    commands:
      - pwd
      - cd .. && pwd
      - pwd
      - echo $KEY
      - KEY=CHANGE
      - echo $KEY

ソースコードリポジトリへのプッシュ

$ git commit -am "buildspec.yml test v0.2"
[master 01b4d45] buildspec.yml test v0.2
1 file changed, 3 insertions(+), 3 deletions(-)
$ git push origin master
Counting objects: 3, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 338 bytes | 0 bytes/s, done.
Total 3 (delta 2), reused 0 (delta 0)
To ssh://git-codecommit.us-west-2.amazonaws.com/v1/repos/NodePlatform_AmazonLinux
e11be3c..01b4d45 master -> master

ビルドを実行します。

$ aws codebuild start-build --project-name buildtest --region us-west-2

"id": "buildtest:baaffef8-1d9f-434e-8796-9d901c0c5405",

ログから実行結果を確認します。

$ aws logs get-log-events --log-group-name /aws/codebuild/buildtest --log-stream-name baaffef8-1d9f-434e-8796-9d901c0c5405 --region us-west-2

{
"ingestionTime": 1495590812026,
"timestamp": 1495590812000,
"message": "[Container] 2017/05/24 01:53:30 Running command pwd\n"
},
{
"ingestionTime": 1495590812026,
"timestamp": 1495590812000,
"message": "/tmp/src996175544/src\n"
},
{
"ingestionTime": 1495590812026,
"timestamp": 1495590812000,
"message": "\n"
},
{
"ingestionTime": 1495590812026,
"timestamp": 1495590812000,
"message": "[Container] 2017/05/24 01:53:30 Running command cd .. && pwd\n"
},
{
"ingestionTime": 1495590812026,
"timestamp": 1495590812000,
"message": "/tmp/src996175544\n"
},
{
"ingestionTime": 1495590812026,
"timestamp": 1495590812000,
"message": "\n"
},
{
"ingestionTime": 1495590812026,
"timestamp": 1495590812000,
"message": "[Container] 2017/05/24 01:53:30 Running command pwd\n"
},
{
"ingestionTime": 1495590812026,
"timestamp": 1495590812000,
"message": "/tmp/src996175544\n"
},
{
"ingestionTime": 1495590812026,
"timestamp": 1495590812000,
"message": "\n"
},
{
"ingestionTime": 1495590812026,
"timestamp": 1495590812000,
"message": "[Container] 2017/05/24 01:53:30 Running command echo $KEY\n"
},
{
"ingestionTime": 1495590812026,
"timestamp": 1495590812000,
"message": "VALUE\n"
},
{
"ingestionTime": 1495590812026,
"timestamp": 1495590812000,
"message": "\n"
},
{
"ingestionTime": 1495590812026,
"timestamp": 1495590812000,
"message": "[Container] 2017/05/24 01:53:30 Running command KEY=CHANGE\n"
},
{
"ingestionTime": 1495590812026,
"timestamp": 1495590812000,
"message": "\n"
},
{
"ingestionTime": 1495590812026,
"timestamp": 1495590812000,
"message": "[Container] 2017/05/24 01:53:30 Running command echo $KEY\n"
},
{
"ingestionTime": 1495590812026,
"timestamp": 1495590812000,
"message": "CHANGE\n"
},

バージョン 0.2 ではカレントディレクトリも、環境変数も保持されていることが分かります。

まとめ

いかがでしたでしょうか？私自身、ハマった経験もあり、その時は異なるシェルが利用されているとは思っていなかったため、CodeBuild はブラックボックスで怖いな、と思っていましたが、スッキリしました。コマンド単位でカレントディレクトリを移動して、コマンド実行したり、環境変数もコマンド単位で設定可能なのでワークアラウンドがあったので、大きなアップデートではないですが、シンプルに設定ファイルを書けるようになったのは嬉しいですね。

CodeBuild の buildspec.yml のバージョン 0.2 がリリースされていました

変更内容

環境変数の指定方法

0.2 の記法

0.1 の記法

同一シェルによる実行

バージョン 0.2 の利用方法

試してみた

バージョン 0.1

buildspec.yml

ソースコードリポジトリへのプッシュ

ビルドの実行

動作確認

バージョン 0.2

ソースコードリポジトリへのプッシュ

まとめ

イベント

EVENT【4/23リモート】クラスメソッドのフリーランスエンジニア会社説明会〜AWS / システムアーキテクト案件特集〜を開催します

EVENT【5/28（火）】AWSを最大活用するための1dayカンファレンス

EVENT【5/17（金）】認証機能の開発工数削減をデモで体験！次世代認証基盤サービス『Auth0 by Okta』導入実践ウェビナー

EVENT【5/14（火）】アノテーションの中途向けオンライン会社説明会を開催します

EVENT【5/23（木）】ユースケースに学ぶAWS運用のノウハウ～可視化から統制まで～

EVENT【5/16（木）】Snowflakeを触ってみよう！初めての方向けハンズオンセミナー

EVENT【5/10（金）名古屋】クラスメソッドグループの会社説明会を開催します！

EVENT【4/25（木）リモート】Google Cloudに携わるエンジニアのキャリア～クラスメソッド会社説明会～

EVENT【4/30（火）リモート】クラスメソッドの会社説明会を開催します

EVENT【5/9（木）】組織的なクラウド統制はじめの一歩

CodeBuild の buildspec.yml のバージョン 0.2 がリリースされていました

変更内容

環境変数の指定方法

0.2 の記法

0.1 の記法

同一シェルによる実行

バージョン 0.2 の利用方法

試してみた

バージョン 0.1

buildspec.yml

ソースコードリポジトリへのプッシュ

ビルドの実行

動作確認

バージョン 0.2

ソースコードリポジトリへのプッシュ

まとめ

イベント

EVENT【4/23リモート】クラスメソッドのフリーランスエンジニア会社説明会 〜AWS / システムアーキテクト案件特集〜 を開催します

EVENT【5/28（火）】AWSを最大活用するための1dayカンファレンス

EVENT【5/17（金）】認証機能の開発工数削減をデモで体験！次世代認証基盤サービス『Auth0 by Okta』導入実践ウェビナー

EVENT【5/14（火）】アノテーションの中途向けオンライン会社説明会を開催します

EVENT【5/23（木）】ユースケースに学ぶAWS運用のノウハウ～可視化から統制まで～

EVENT【5/16（木）】Snowflakeを触ってみよう！初めての方向けハンズオンセミナー

EVENT【5/10（金） 名古屋】クラスメソッドグループの会社説明会を開催します！

EVENT【4/25（木）リモート】Google Cloudに携わるエンジニアのキャリア～クラスメソッド会社説明会～

EVENT【4/30（火）リモート】クラスメソッドの会社説明会を開催します

EVENT【5/9（木）】組織的なクラウド統制 はじめの一歩

関連記事

Codepipelineで別アカウントにあるCodeCommitを使用してCI/CD設定をしてみた

[アップデート] AWS CodeBuild でもソースに GitLab (SaaS版 & セルフマネージド版) がサポートされました

[アップデート] AWS CodeBuild の Lambda コンピューティング環境でもカスタムイメージを使えるようになり、マネージド型イメージに含まれていないツールも使いやすくなりました

[アップデート] AWS CodeBuild のリザーブドキャパシティを使ってみました

EVENT【4/23リモート】クラスメソッドのフリーランスエンジニア会社説明会〜AWS / システムアーキテクト案件特集〜を開催します

EVENT【5/10（金）名古屋】クラスメソッドグループの会社説明会を開催します！

EVENT【5/9（木）】組織的なクラウド統制はじめの一歩