serverspec と対象 OS についての覚え書き
2013-05-05 現在、serverspec の Auto Detect が対応しているのは以下の OS。
- RedHat
- Amazon Linux 含む
- Debian
- Gentoo
- Solaris
- Oracle Solaris 11.1 でテスト
これらは lib/serverspec/backend/exec.rb の check_os で以下のように判別されている。
def check_os
if run_command('ls /etc/redhat-release')[:exit_status] == 0
'RedHat'
elsif run_command('ls /etc/system-release')[:exit_status] == 0
'RedHat' # Amazon Linux
elsif run_command('ls /etc/debian_version')[:exit_status] == 0
'Debian'
elsif run_command('ls /etc/gentoo-release')[:exit_status] == 0
'Gentoo'
elsif run_command('uname -s')[:stdout] =~ /SunOS/i
'Solaris'
end
end
テスト対象の OS の Auto Detect ができない場合、 ここに対象 OS を判別するコードを追加しましょう。
対象の OS が RedHat/Debian/Gentoo/Solaris 系であり、 それぞれの command で正しくテストできるなら、 それらの OS を指定します。
対象の OS が RedHat/Debian/Gentoo/Solaris 系でない場合、 次の『テスト対象が RedHat/Debian/Gentoo/Solaris 系ではない』を参照してください。
テスト対象 OS が RedHat/Debian/Gentoo/Solaris 系ではない場合、 lib/serverspec/commands/（OS 名）.rb に その OS 用の command を定義する必要がでてきます。
command の定義は、OS やディストリビューションに依存しないものは lib/serverspec/commands/base.rb に定義し、 OS やディストリビューションに依存するものは lib/serverspec/commands/（OS・ディストリビューション名）.rb に base.rb を継承した上で定義します。
（現在、SELinux や Linux の kernel parameter など Linux に依存するものも base.rb に定義されていますが、これらは linux.rb にわける方向で @ftnk が作業予定です。）
FreeBSD に対応させる想定で、OS の追加方法を見ていきます。
追加するファイルは
- lib/serverspec/commands/freebsd.rb
- FreeBSD 固有の command を定義するファイル
- lib/serverspec/helper/freebsd.rb
- spec/freebsd/commands_spec.rb
- 生成される command のテスト
- base.rb および freebsd.rb に定義されている command を網羅する必要があります
- spec/freebsd/matchers_spec.rb
- matcher のテスト
- base.rb および freebsd.rb に定義されている command を網羅する必要があります
の 4 つになります。
それぞれに書く内容は他の OS・ディストリビューションを参照すればわかるかと思います。
また、lib/serverspec/commands/freebsd.rb を読み込むために、 lib/serverspec.rb を編集し、以下を追記する必要があります。
require 'serverspec/commands/freebsd'
lib/serverspec/helper/freebsd.rb を読み込むため、 lib/serverspec/helper.rb に
require 'serverspec/helper/freebsd'
を追記し、lib/serverspec.rb に
c.include(Serverspec::Helper::FreeBSD, :os => :freebsd)
を追記します。