jenkins Cookbook 作成体験
Cookbook
...
をつくろう
Cookbook の生成
| Section |
|---|
| Column |
|---|
| まずは、Chef のソースコードである Recipe を格納するための Cookbook をつくります。 | コード ブロック |
|---|
$ cd workspace
$ chef generate cookboook jenkins |
|
| Column |
|---|
| Section |
|---|
| | Column |
|---|
`chef` は ChefDK のコマンドです。
ここでは 'jenkins' という名前の Cookbook を `chef` コマンドで生成しています。 Cookbook は Chef のソースコードを取りまとめた単位です。
Cookbook の中には実際のソースコード（Recipe）が入ります。 |
|
|
|
...
Eclipse
...
にインポート
| Section |
|---|
| Column |
|---|
| Cookbook を Eclipse プロジェクトとしてインポートしましょう。 まずは、Eclipse プロジェクトを生成します。 | コード ブロック |
|---|
$ cd jenkins
$ gen-eclipse |
Eclipse を起動して、生成したプロジェクトをインポートします。 | Section |
|---|
| Column |
|---|
1. 
アプリケーション -> プログラミング -> Eclipse
|
| Column |
|---|
2. 
OK
|
|
| Section |
|---|
| Column |
|---|
3. 
File -> Import...
|
| Column |
|---|
4. 
General -> Existing Projects into Workspace
|
|
| Section |
|---|
| Column |
|---|
5. 
Browse -> 「jenkins」ディレクトリを選択 -> OK -> Finish
|
|
|
| Column |
|---|
| Section |
|---|
| | Column |
|---|
`gen-eclipse` は Eclipse プロジェクトを生成するシェルスクリプトです。 |
|
|
|
Recipe を書こう
default Recipe
...
を書く
| Section |
|---|
| Column |
|---|
| Cookbook のメイン Recipe をつくります。 | コード ブロック |
|---|
| language | ruby |
|---|
| title | jenkins/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"
source 'http://pkg.jenkins-ci.org/redhat/jenkins-1.568-1.1.noarch.rpm'
action :create_if_missing
end
# Jenkins をインストール
yum_pakcage "#{Chef::Config[:file_cache_path]}/jenkins-1.568-1.1.noarch.rpm"
# Jenkins サービスを自動起動
service 'jenkins' do
action [:start, :enable]
end |
|
| Column |
|---|
| Section |
|---|
| | 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 の概要とドキュメントのリンク |
|---|
| |
|
|
|
|
Kitchen で試してみよう
Kitchen
...
インスタンスを定義
| Section |
|---|
| Column |
|---|
| 作成した 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 |
|
| Column |
|---|
| Section |
|---|
| | Column |
|---|
Kitchen は Vagrant や EC2、Docker Engine などでインスタンスを起動して Cookbook の動作をチェックするためのツールです。 .kitchen.yml には Kitchen で起動するインスタンスの設定を定義します。 driver:高速・軽量な Docker Engine を使うように指定します。 provisioner:Chef Zero によるプロビジョニングを行うように指定します。 Docker Engine のコンテナのベース Image として centos:centos6 を使用するように指定します。
また、Jenkins の起動確認のために 8080 ポートをフォワーディングするように指定ます。 suites:jenkins Cookbook を収束するように指定します。 |
|
|
|
...
プロビジョニングの実施
| Section |
|---|
| Column |
|---|
| Kitchen インスタンスを起動し、Cookbook を転送してプロビジョニングを行います。 | コード ブロック |
|---|
$ kitchen converge |
|
| Column |
|---|
| Section |
|---|
| | Column |
|---|
`kitchen converge` コマンドを実行すると、.kitchen.yml の定義に従って Kitchen インスタンスが生成され、プロビジョニングが行われます。 | ヒント |
|---|
|
Kitchen インスタンスへの ログイン
※ パスワードは 'kitchen'
Kitchen インスタンスの破棄 | コード ブロック |
|---|
$ kitchen destroy |
|
|
|
|
|
Jenkins にアクセスしてみよう
Web ブラウザで確認
.kitchen.yml の設定により、Kitchen インスタンスの 8080 ポートがホストマシンの 8080 ポートにフォワーディングされています。
ホストマシンの Web ブラウザで「http://localhost:8080」とアクセスしてみてください。
...