自動化大好きエンジニアLT会　第二回登壇資料

1. ansible_specでテストをする話
自動化大好きエンジニアLT会 第2回

2. ■自己紹介
 [名前]: 上畑圭史（うえはたけいじ)
 [Twitter]: いじけまん(@ijikeman)
 [職業]:株式会社ラクスのインフラエンジニア
 [趣味1]: 自作キーボード大好き
アクリル板(4mm)にキーの穴(60個)を手であけた自キー(自作
キーボード界隈)ではちょっとした有名人
 [趣味2]: ピアノ歴2ヵ月(コロナを契機に)
セパレートキーボード使っている効果？か
以外と両手が動いてびっくりしてますw
2

3. ■ansible_specとは
※serverspecはDSL風な簡易な記述でサーバの状態を検証することができます。
# httpdポートの確認を検証
describe port(‘80’) do
it { should be_listening }
end
1. Ansibleのディレクトリ構造に合わせて、テストファイル(spec)が設
置できる。
2. “Ansibleのインベントリファイルとプレイブックを使用して”
serverspecが実行できる。
# httpdパッケージのインストールを検証
describe package(‘httpd’) do
it { should be_installed }
end

4. 1. Ansibleのディレクトリ構造に合わせ
て、テストファイル(spec)が設置できる。
└ roles/
└ [role_name]/
└ handlers/
└ files/
└ tasks/
└ templates/
└ spec/*_spec.rb
└ vars/
ロール単位でspecファイルを設置できる為、テストファイルの位置わか
りやすい

5. 2. Ansibleのインベントリファイルとプレ
イブックを使用してserverspecが実行でき
る。
# httpdサービスの起動と有効化を検証
describe port(property[‘HTTPD_CONFIG’][‘PORT’]) do
it { should be_listening }
end
group_varsやhost_vars等varsに記載されているパラメータを
propertyとして記述ができる。
複数のホストを構成管理したAnsibleにおいて、ホスト毎のテストを書く
必要がなくなる。
# group_vars/centos7-server.yml
HTTPD_CONFIG:
PORT: ‘8080’
# group_vars/centos8-server.yml
HTTPD_CONFIG
PORT: ‘10080’

6. Run serverspec for ansiblespec_test-centos7
Port "8080" is expected to be listening
Finished in 1.56 seconds (files took 1.19 seconds to load)
1 example, 0 failures
Run serverspec for ansiblespec_test-centos8
Port "10080" is expected to be listening
Finished in 1.62 seconds (files took 0.84468 seconds to load)
1 example, 0 failures
■デモ①

7. ■ansible_specで読み込まれるvars
リモートサーバに
アプリをアップロード
アプリを展開
PATH 備考
group_vars/all.yml
group_vars/[group_name].yml
group_vars/[group_name]/all.yml [group_name].ymlより優先され
[group_name].ymlは読み込まれない
host_vars/[hostname].yml
host_vars/[hostname]/all.yml [hostname].ymlより優先され
[hostname].ymlは読み込まれない
roles/[role]/default/main.yml
roles/[role]/vars/main.yml
playbook内のvars

8. ■Ansible Best Practice(Alternative
Directory Layout)のディレクトリ構造
└ inventories/
└ production/
└ group_vars/
└ host_vars/
└ roles/
└ [role_name]
└ playbook.yml

9. ■Ansible Best Practice(Alternative
Directory Layout)のディレクトリ構造
└ inventories/
└ production/
└ group_vars/
└ host_vars/
└ roles/
└ [role_name]
└ playbook.yml
対象外なんです…

10. ■ansible_spec改良①
ということで修正依頼中

11. ■ansible_spec改良②
１つのAnsibleコードで、複数種のサーバを管理した場合に全てのホスト共通のテ
ストであれば、実装しやすい。
・同じホストグループだが特定のホストだけ別のテストを実行したいといった場
合(例: Webサーバ群の内、WebサーバBは追加でテストを実施)
・ansible_spec改良①でインベントリ配下のvarsを使って可変テストが書けると、
ホスト単位やホストグループ単位のテストを書きたくなる
➡ 現状ではroles/[role_name]/spec/*_spec.rbを全部読み込んで実行する。
解決方法として
・spec内で対象ホストを分岐して処理を書く
・専用のテストroleを作って指定
といったことをしなければならない。
11

12. ■ansible_spec改良②
そこで以下のような実装に変更してみました。
12
└ roles/ [role_name]/spec/
└ all_spec.rb ... このroleを指定した場合のテスト
└ group_name1/
└ all_spec.rb ... group_name1グループのホストのテスト
└ hostname1_spec.rb ... group_name1のhostname1のテスト
└ hostname2_spec.rb ... group_name1のhostname2のテスト
└ group_name2/
└ all_spec.rb ... group_name2グループのホストのテスト
└ hostname3_spec.rb ... group_name2のhostname3のテスト

13. 各テストコマンド毎にどのテストが実行されるかを表にしてみました。
■ansible_spec改良②
13
N
O
テストコマンド テスト対象 実行されるテスト
① rake spec:group_name1:hostname1 hostname1 [role_name]/spec/all_spec.rb
[role_name]/spec/group_name1/all_spec.rb
[role_name]/spec/group_name1/hostname1_spec.rb
② rake spec:group_name1:hostname2 hostname2 [role_name]/spec/all_spec.rb
[role_name]/spec/group_name1/all_spec.rb
[role_name]/spec/group_name1/hostname2_spec.rb
③ rake spec:group_name1 hostname1
hostname2
①
②
④ rake spec:group_name2:hostname3 hostname3 [role_name]/spec/all_spec.rb
[role_name]/spec/group_name1/all_spec.rb
[role_name]/spec/group_name1/hostname3_spec.rb
⑤ rake spec:group_name2 hostname3 ④
⑥ rake spec:all hostname1
hostname2
hostname3
①
②
④

14. ■Demo
ansible_spec改修②で改修したプログ
ラムに関してはQiita(ijikeman)に記事
をあげさせていただきます。
最終的に本家に取り込まれるに様に働
きかけをしていこうと思います。