Kitchen を使う準備

Kitchen とは

Vagrant、EC2、Docker Engine など、任意のインスタンスを立てて、その中で Cookbook の動作を試行できるツールです。
http://kitchen.ci/ 

 

今回は高速・軽量な Docker Engine のインスタンスで Cookbook の動作チェックをしていきます。

Docker Engine は Linux でのコンテナ型の仮想化を提供するツールです。

ハイパーバイザ型がマシンそのものをエミュレートするのに対し、コンテナ型の仮想化ではホストマシンのカーネル上に独立したユーザー空間を構築するのにとどまります。

ハイパーバーザ型と比較すると、コンテナ型の仮想化はホストのもつリソースをほぼそのまま扱えるため、より軽量・高速に仮想化を実現できます。

また、Docker Engine ではコンテナの差分管理が可能です。
たとえば、いちど CentOS をインストールしたコンテナをつくってしまえば、CentOS + apache や CentOS + MySQL などのコンテナを構築するときに毎回 CentOS をインストールする必要はありません。

Kitchen で Docker Engine を利用するには、kitchen-docker のインストールが必要です。
ChefDK を利用している場合は、次のコマンドでインストールできます。（開発環境にはインストール済みです） 

chef gem install kitchen-docker

 

.kitchen.yml の編集

Kitchen でインスタンスを立てて Recipe を実行するには、.kitchen.yml を編集します。

driver:
  name: docker

provisioner:
  name: chef_solo

platforms:
  - name: centos-6.4
    driver_config:
      image: centos:centos6
      forward: 8080

suites:
  - name: default
    run_list:
      - recipe[tar::default]
      - recipe[java::default]
      - recipe[jenkins::default]
    attributes:
      java:
        install_flavor: oracle
        jdk_version: 7
        java_home: /usr/java/default
        oracle:
          accept_oracle_download_terms: true

driver

標準では vagrant ですが、開発サイクルを早くまわすために、より軽量・高速な docker を使用します。

driver_config

kitchen-docker の設定を書きます。

image

ベースとする docker image の名前を指定します。
利用できる image 名は Dockerfile の FROM 句 で指定できるものと同じです。

forward

ホストマシンにフォワーディングするポート番号を指定します。
この例では jenkins が使用する 8080 ポートがホストマシンから見えるように指定しています。

run_list

実行する Recipe を指定します。
この例では自作した jenkins Cookbook の Recipe を指定しています。

ただ、Jenkins の動作には Java が必要ですので、Opscode Community の java Cookbook、tar Cookbook（java Cookbook の動作に必要） も指定しています。
※ 外部の Cookbook を使用するには後述する Berksfile の編集が必要です。

attributes

Recipe にわたす Attribute （Recipe に対するパラメータのようなもの）を指定します。
今回は java Cookbook の Attribute を指定しています。

 

Berkshelf とは

 

Berksfile の編集

プロビジョニング時に必要な外部の Cookbook は、このファイルをもとに berkshelf によって解決されます。Opscode Community の Cookbook であれば、次のように名前を指定するだけでOKです。

source "https://api.berkshelf.com"

cookbook ‘tar'
cookbook 'java'
metadata

※ Opscode Community 以外の依存

 

Kitchen インスタンスの起動とプロビジョニング

では、作成した Cookbook を Kitchen のインスタンスへプロビジョニングしてみましょう。

$ kitchen setup

プロビジョニングが成功したら、Kitchen インスタンスにログインしてみてください。

[vagrant] $ kitchen login
kitchen@localhost’s password: kitchen

[kitchen] $ sudo service jenkins status
jenkins (pid 17656) を実行中...

[kitchen] $ exit

ログインできたら、jenkins サービスが実行されているか確認してみましょう。
/etc/sysconfig/jenkins の内容も確認してみてください。

うまくいっていない場合は、Cookbook を修正し、次のコマンドでプロビジョニングをやり直します。

$ kitchen converge

以前プロビジョニング結果が原因でプロビジョニングがうまくいかない場合は、次のコマンドで Kitchen インスタンスを破棄してから、再度プロビジョニングを実行します。

$ kitchen destroy
$ kitchen setup

※ kitchen の主なサブコマンド

 

# インスタンスの生成
kitchen create

# Chef-Solo のインストールと初回のプロビジョニング
kitchen setup

# プロビジョニング
kitchen converge

# Serverspec の実行
kitchen verify

# ssh ログイン
kitchen login

# インスタンスの破棄
kitchen destroy

 

Web ブラウザで Jenkins にアクセス

docker コマンドでコンテナのポートを確認します。

$ docker ps
CONTAINER ID  PORTS
e35e89ea252a    0.0.0.0:49153->22/tcp, 0.0.0.0:49154->8080/tcp

コンテナの 8080 ポートがホストの 49154 にフォワーディングされていることが確認できます。
Firefox などの Web ブラウザで http://localhost:49154/ にアクセスしてみてください。
Jenkins の画面が表示されていれば成功です。