ページ ツリー

比較バージョン

キー

  • この行は追加されました。
  • この行は削除されました。
  • 書式設定が変更されました。

...

Section
Column
width720px

Cookbook 開発の流れ

ひとつの Cookbook を完成させるには、次のような手順を辿ることになります。

Drawio
diagramName開発の流れ.drawio
revision1
 

Column
Section
bordertrue
Column

Cookbook 作成

まずは Cookbook を作成します。

Recipe 編集

テキストエディタや IDE で Recipe を編集します。

Kitchen でプロビジョニング

Kitchen でテスト用インスタンスを立てて、プロビジョニングを行います。
ここでプロビジョニングが成功すれば、Cookbook の完成です。
失敗した場合は、Recipe を編集しなおします。 

...

Section
Column
width720px

Cookbook のメイン Recipe をつくります。 

内容は、Jenkins をインストールするものです。

コード ブロック
languageruby
titlejenkins/recipes/default.rb
# OpenJDK をインストール(Jenkins の実行に必要なため)
yum_package 'java-1.7.0-openjdk'

# Jenkins の rpm をダウンロード
remote_file "#{Chef::Config[:file_cache_path]}/jenkins-1.568-1.1.noarch.rpm" do
  source 'http://pkg.jenkins-ci.org/redhat/jenkins-1.568-1.1.noarch.rpm'
  action :create_if_missing
end

# Jenkins をインストール
yum_pakcagepackage "#{Chef::Config[:file_cache_path]}/jenkins-1.568-1.1.noarch.rpm"
 
# Jenkins サービスを自動起動
service 'jenkins' do
  action [:start, :enable]
end
Column
Section
bordertrue
Column

 Recipe にはサーバーのあるべき状態を Resource として定義します。

ここでいう yum_package や remote_file、service などが Resource の定義です。

基本的な Resource 定義の書式は次のようになっています。

コード ブロック
<ResourceType> "ResourceName" do
  <Attribute> "hoge"
  <Attribute> "fuga"
  action <Action>
end

Resource がどのような Attribute や Action を持つかは ResourceType により様々です。
Chef のドキュメントを参照するとよいでしょう。

ヒント
title今回登場する ResourceType の概要とドキュメントのリンク
ResourceType概要ドキュメント
yum_packageパッケージのインストールhttp://docs.getchef.com/resource_yum.html
remote_fileWeb 上のファイルをダウンロードhttp://docs.getchef.com/resource_remote_file.html
serviceサービスの制御http://docs.getchef.com/resource_service.html

...

Section
Column
width720px

作成した Cookbook を試すための実行環境(Kitchen インスタンス)を定義します。

コード ブロック
---
driver:
  name: docker
 
provisioner:
  name: chef_zero
 
platforms:
  - name: centos
    driver_config:
      image: centos:centos6
      forward: 8080:8080
 
suites:
  - name: default
    run_list:
      - jenkins
注意

YAML 形式のファイルはインデントにタブを使えないので注意してください。 

Column
Section
bordertrue
Column

KitchenVagrant や EC2、Docker Engine などでインスタンスを起動して Cookbook の動作をチェックするためのツールです。

.kitchen.yml には Kitchen で起動するインスタンスの設定を定義します。

driver:

高速・軽量な Docker Engine を使うように指定します。

provisioner:

Chef Zero によるプロビジョニングを行うように指定します。

platforms:

Docker Engine のコンテナのベース Image として centos:centos6 を使用するように指定します。
また、Jenkins の起動確認のために 8080 ポートをフォワーディングするように指定ます。ポートをフォワーディングするように指定します。

suites:

jenkins Cookbook を収束するように指定します。

...

Section
Column
width720px

 Kitchen インスタンスを起動し、Cookbook を転送してプロビジョニングを行います。

コード ブロック
$ kitchen converge
Column
Section
bordertrue
Column

`kitchen converge` コマンドを実行すると、.kitchen.yml の定義に従って Kitchen インスタンスが生成され、プロビジョニングが行われます。

 

Drawio
diagramNamekitchen.drawio
size500
revision1

ヒント
titlekitchen のその他のコマンド


Kitchen インスタンスへの ログイン

コード ブロック
$ kitchen login

※ パスワードは 'kitchen'


Kitchen インスタンスの破棄

コード ブロック
$ kitchen destroy

...