構成管理ツールのItamaeとインフラ自動テストツールのServerspecについての入門資料です。

1. Itamae – Serverspec入門
http://serverspec.org
http://itamae.kitchen

2. Agenda
 Serverspecの部
◦ serverspecとは
◦ serverspecの仕組み
 serverspec-init
 Rakefileと
spec_helper.rb
 テストの実行
◦ テストコード
 簡単なテストコード
 リソースタイプ
 describe
 Itamaeの部
◦ Itamaeとは
◦ レシピ
 簡単なレシピ
 リソースタイプ
 よく使うrubyの文法
◦ Itamaeの実行
 デモ

3. 自己紹介
 名前
◦ bbrfkr(ビビリフクロウ)
 所属
◦ TIS株式会社 IT基盤技術推進部所属
 ミッション
◦ インフラの構築・運用保守の自動化推進
◦ Ansible、Serverspecを用いた、自動化フ
レームワークの開発

4. Itamaeの部
http://itamae.kitchen

5. Itamaeとは
 構成管理ツールの一つ
 サーバの「あるべき状態」を記述し、
その状態に収束させる
 競合製品にAnsible、Chefなど
 クックパッド社の荒井良太さんを中心
に開発
http://itamae.kitchen

6. Itamaeとは
 他の構成管理ツールとの比較
Itamae Ansible Chef
エージェントの
必要性
不要 不要 必要
レシピ/
プレイブックの
記述言語
Ruby
(DSL)
YAML Ruby
(DSL)
既存モジュール
/リソースの数
少ない
(15個)
非常に多い
(806個)
多い
(66個)

7. レシピ
 簡単なレシピ
◦ dockerパッケージをインストール
◦ dockerサービスの起動、自動起動設定
package "docker" do
action :install
end
service "docker" do
action [:enable, :start]
end

8. レシピ
 リソースタイプ
◦ Itamaeが用意している、設定対象および
その設定モジュール群
package "docker" do
action :install
end
「package」がリソースタイプ

9. レシピ
 packageリソース
◦ パッケージのインストール、アンインス
トール
package "docker" do
action :install
end
 serviceリソース
◦ サービスの起動/停止、自動起動設定
service "docker" do
action [:enable, :start]
end

10. レシピ
 fileリソース
◦ ファイルの配置/削除、権限/所有者設定
◦ ファイルの内容変更
file "/foo" do
action :edit
block do |content|
content.gsub!("world", "Itamae")
end
end

11. レシピ
 executeリソース
◦ 任意のコマンド実行
execute "touch /path/to/file" do
not_if "test -e /path/to/file"
end
※run_commandメソッド
◦ 任意のコマンドを実行。その結果をレシ
ピ内の分岐条件などに使える
result = run_command("test -e /path/to/file", error: false)
if result.exit_status != 0
execute "touch /path/to/file"
end

12. レシピ
 よく使うrubyの文法
◦ if文
 条件分岐に利用。
 アップデートがあったときのみ、
「yum update -y」を叩いたりとか
cmd = "sudo yum update --assumeno | grep "No packages""
update_flag = run_command(cmd, error: false).exit_status
if update_flag != 0
execute "yum update -y"
end

13. レシピ
 よく使うrubyの文法
◦ eachメソッド
 繰り返しに利用
 複数のパッケージをインストールするときに
packages = ["openstack-nova-api", "openstack-nova-conductor",
"openstack-nova-console", "openstack-nova-novncproxy",
"openstack-nova-scheduler"]
packages.each do |pkg|
package pkg do
action :install
end
end

14. レシピ
 よく使うrubyの文法
◦ ヒアドキュメント
 長い文字列を定義するときに便利
 長いコマンドを見やすく定義できる
cmd = <<-"EOS"
cd /etc/swift &&
swift-ring-builder account.builder
add --region 1 --zone 1 --ip 192.168.0.10 --port 6002
--device sdb --weight 100
EOS
execute cmd

15. Itamaeの実行
 「itamae ssh」コマンドで実行
◦ -h：対象ホストを指定
◦ -u：接続ユーザを指定
◦ -p：接続ポートを指定
$ itamae ssh -h 192.168.0.10 -u root -p 22 cookbook.rb

16. Serverspecの部
http://serverspec.org

17. Serverspecとは
 インフラの自動テストツール
 対象サーバにSSHで接続し、テスト用
コマンドを叩く
 サーバの内部状態を確認できる
◦ ホワイトボックステスト
 エージェントレス
 開発者は「宮下 剛輔」さん
http://serverspec.org

18. Serverspecの仕組み
 serverspec-init
◦ serverspecの実行に必要な一式のディレ
クトリ構造を作ってくれるコマンド
◦ 実行すると以下のような構造ができる
.
|-- Rakefile
`-- spec
|-- 192.168.0.1
| `-- sample_spec.rb
`-- spec_helper.rb
(rake)タスクを定義するファイル
テストコードの実装を助けるモ
ジュール
httpdのインストール状況を試験す
るサンプルコード

19. Serverspecの仕組み
 Rakefile
◦ rakeタスクを定義するファイル
◦ serverspecによるテスト実行の実態は、
rakeタスクの実行
◦ デフォルトでは、「spec/<ホスト名>」
ディレクトリ内のテストコードを<ホスト
名>に対して実行するようにrakeタスクが
定義されている

20. Serverspecの仕組み
 spec_helper.rb
◦ テストコードの実装を助けるモジュール
◦ テストコードが奇麗になるように、必要
なモジュールを先にロードする
◦ 対象サーバへの接続方法もこのファイル
で定義
◆Check!!◆
Rakefileとspec_helper.rbのカスタマイズで
Serverspecの挙動は如何様にも変えられる

21. Serverspecの仕組み
 テストの実行
◦ テストの実行はRakefileがある場所で以下
のコマンドを実行するだけ
$ rake spec

22. テストコード
 簡単なテストコード
◦ 以下を確認
 「httpd」パッケージがインストールされてい
ること
require 'spec_helper'
describe ("check httpd is installed") do
describe package("httpd") do
it { should be_installed }
end
end

23. テストコード
 リソースタイプ
◦ Serverspecが用意した、テスト対象、
およびテストモジュール群
describe package("httpd") do
it { should be_installed }
end
「package」がリソースタイプ

24. テストコード
 packageリソース
◦ パッケージに対するテストモジュールを
持っている
 インストール確認
 インストールバージョン確認
describe package("httpd") do
it { should be_installed }
end

25. テストコード
 serviceリソース
◦ サービスに対するテストモジュールを
持っている
 起動確認
 自動起動設定確認
describe service("httpd") do
it { should be_enabled }
end

26. テストコード
 fileリソース
◦ ファイルやディレクトリに対するテスト
モジュールを持っている
 存在確認
 ファイルの内容確認
 権限確認
 所有者確認
describe file("/var/www/html/index.html") do
it { should exist }
end

27. テストコード
 describe
◦ テストのグループを作るのに使う
◦ 実際のテストはdescribeブロックの中の
it、its文
describe ("check httpd service is enabled and running")
describe service("httpd") do
it { should be_running }
it { should be_enabled }
end
end

28. デモ
http://serverspec.org
http://itamae.kitchen

29. コントロールマシン Webサーバ
デモ内容
テーマ：HTTPSサイトの構築
• 環境
設定
・
テスト
http://serverspec.org
http://itamae.kitchen
Apache
mod_ssl

30. デモ内容
テーマ：HTTPSサイトの構築
[Itamae]
•パッケージのインストール
•httpd
•mod_ssl
•秘密鍵の作成
•自己署名証明書の作成
•設定ファイルの修正
•index.htmlの配置
•サービスの起動
•サービスの自動起動設定
[Serverspec]
•インストールチェック
•httpd
•mod_ssl
•秘密鍵の存在確認
•自己署名証明書の存在確認
•設定ファイルの内容確認
•index.htmlの存在確認
•サービスの起動確認
•サービスの自動起動設定確認
Itamae/Serverspecで自動化するところ