この記事は RECRUIT MARKETING PARTNERS Advent Calendar 2015 の投稿記事です。

こんにちは、2015年新卒インフラエンジニアの河合です。アドベントカレンダー2015の3日目を担当します。現在の担当プロダクトは英語/英単語サプリです。そういえば10月末に英語サプリのiOS版がリリースされました。

• 英語サプリ

英語サプリリリースに伴い、インフラ業務としては

• Terraformの運用の話
• Amazon EC2 Container Serviceで構築した話

などと色々なネタがあるのですが、本日はDockerを用いたJenkinsの運用をしてみた話をします。

Jenkinsと数ヶ月ほど戯れてみて…

Jenkins辛い運用パターン

担当プロダクトにおけるJenkinsの主な利用シーンは

• CI
• デプロイスクリプトジョブ
• cron batch

などがあるのですが、デプロイに限って言えば以下が該当します。

• Web deploy => gulpコマンドが必須
• ECS Container deploy => 独自コマンドはGoで動いている

とはいえ、初期状態だとそれぞれを動かすためのインストール作業が終わっていないために、シェルの実行の部分でgulpとかgo runとか書いてしまうとcommand not foundといったエラーが出てしまいます。そのため、以下のような作業が必要になります。

担当プロダクトはnode.js, Golang, javaなどなど様々な要素が組み合わさっていることで成り立っているプロダクトです。やっぱりインストール作業は面倒なものですが、誰がメンテするんだよ状態(お前だよ)となりかねません。

問題点を整理すると…

• Jenkinsのホストに入ってインストールする作業が面倒¹⁾Chef等で構築されている場合は除く
• インストールしたあとのメンテ作業が面倒

の2つがあると思います。

英語・英単語サプリファミリーチームにおけるJenkins運用ルール

JenkinsインスタンスにはJenkins以外何もインストールせず、ジョブの設定はDockerだけで完結するようにする

上記を原則とする運用ルールで進めました。

すると、〈1つのJenkins-Job = 1つのDocker-Imageで完結〉するために面倒なインストール作業をすることなく、全てdocker runだけで済むということになります。

具体例

こうすると先ほどの具体例として挙げた『GulpタスクをJenkins上で動かすためにnpm周りの環境をセッティングするぞ！』は、以下のようになるかと思います。

Before

1. sshでJenkinsのインスタンスに入る
2. EPELリポジトリの追加
3. sudo yum install npm(バージョン把握)
4. npm install -g gulp typescript bower dtsm
5. Jenkinsのジョブの設定でシェルを書く

といったものになると思うのですが、これは次のようにすることが出来ます。

After

1. Dockerfileを記載(以下にコード記載)
2. docker push
3. Jenkinsのジョブの設定でdocker pullとdocker runを書く

という流れになります。

FROM node:0.12.5
USER root
RUN npm install -g gulp typescript bower dtsm
ADD upload.sh /scripts/upload
RUN chmod +x /scripts/upload #アップロード作業

必要な項目がDockefileとしてコードで明文化されていることはすごくいいですね。

Jenkins + Docker Tips

Jenkins + Dockerで培ったちょっとしたTipsを以下に紹介します。

git clone後はvオプションでマウントするようにする

ワークスペース上にgit cloneしてきた後にそのコードをテスト/デプロイに使いたいときは普通にあると思うのですが、そこはDockerのvオプションを使って、ワークスペース上のコードをDockerコンテナ内にマウントできるようにします。

環境変数を上手く使う

Jenkins上で設定した環境変数を上手く使うためには、eオプションで環境変数をDockerコンテナに渡してあげることで柔軟に対応できるようにしたりします。

バージョン管理はDockerのimageタグで

Terraformのバージョンは良くも悪くもアップデートが激しいため、「Terraform plan用ジョブ」はどのTerraformバージョンなのかを明示的にしています。

#!/bin/bash
echo "branch is $branch"
# タグでどのバージョンか指定
terraform_registry="registry.dev.eitangosapuri.jp/terraform:0_6_4" #タグで指定
# image取得
docker pull $terraform_registry #取得
# 環境変数セッティング
ENVS="ACCESS_KEY SECRET_KEY REGION"
for env in $ENVS
do
  ENV_OPTIONS="${ENV_OPTIONS} -e ${env}=`printenv $env`"
done
# docker run
docker run $ENV_OPTIONS -v /etc/jenkins/jenkins_home/jobs/$JOB_NAME/workspace/:/$JOB_NAME -w /$JOB_NAME $terraform_registry \
sh -c "cd dev && rake plan"

ちょっと具体例が悪かったかもしれないのですが、rubyのバージョンなどジョブの設定でどのバージョンを動かしているのかを、dockerのimageタグを明示的に書くようにしています。

結論

この運用方法にしてからJenkinsのホストに入って何かをインストールするという作業が一切なくなりました。1 Jenkinsビルドジョブ = 1Docker-Imageなので、メンテはJenkins上にあるDockerに関することぐらいで済みます。

シェルの実行のところでdocker runで済むものさえ作ってくれるのであれば、インフラエンジニア以外もみんなガシガシJenkinsいじってほしいです(願望)。

Jenkins属人化ダメゼッタイ。