Chef Howto with Vagrant + Berkshelf 2013-04-26 Xtone Ltd. ピザ会 Aki / @nekoruri

1. Chef Howto
with Vagrant + Berkshelf
2013-04-26
Xtone Ltd. ピザ会
Aki / @nekoruri

2. おさらい
• Chef
– 設定ファイルに書いたとおりにサーバ内を整備
– 新規環境でも既存環境でも結果は同じ
– これで設定ファイルを差分管理できるね！
• 原則
– もうサーバ上で直接作業をしない
• パッケージの追加・更新
• 設定ファイルの変更

3. 今日のゴール
• 誰でもChefで環境整備ができる
– 新規の案件で、Capistrano走らせるところまで
– Unicornは触らない（Capistranoから操作）

4. Chefに欠かせない便利ツール
• Vagrant
– VirtualBox等を良い感じに操作してくれるツール
– Chefを統合して操作できる
– http://www.vagrantup.com/ からダウンロード
• Berkshelf
– BundlerのChef版
– Berksfileに書いたcookbookをGitHubから取得

5. おおまかな流れ
1. Chefレポジトリの新規構築
2. CookbookをBerkshelfで取得
3. 共通の設定を記述
4. 個別の設定を記述
5. Vagrantで作成したサーバに適用
6. 本番サーバに適用

6. 1. Chefレポジトリの新規構築
空のChefレポジトリを作成
Gitレポジトリとして初期化
chefとberkshelfを導入
% knife solo init myrepo
% cd myrepo
% cat <<EOF > .gitignore
/vendor/bundle/
/vendor/cookbooks/
/.bundle/
/bin/
/.vagrant/
EOF
% git init
% git add .
% git commit -m 'initialized chef repository'
% bundle init
% cat <<EOF > Gemfile
source 'https://rubygems.org'
gem 'knife-solo'
gem 'berkshelf'
EOF
% bundle install --path vendor/bundle --binstubs
% git add Gemfile Gemfile.lock
% git commit -m 'installed knife-solo, berkshelf'

7. 2. CookbookをBerkshelfで取得
利用するcookbookを取得
chef-soloの設定ファイルに
vendor/cookbooksを追加
% cat <<EOF > Berksfile
site :opscode
cookbook 'apt'
cookbook 'chef-solo-search', git: 'git://github.com/edelight/chef-solo-search.git'
cookbook 'users'
cookbook 'sudo'
cookbook 'nginx'
cookbook 'logrotate', git: 'git://github.com/drewrothstein/logrotate.git'
cookbook 'nginx_vhost', git: 'git://github.com/nekoruri/cookbook-nginx_vhost.git'
EOF
% bin/berks install --path vendor/cookbooks
% git add Berksfile Berksfile.lock
% git commit -m 'Import apt/users/sudo cookbooks'
% cat <<EOF > solo.rb
file_cache_path "/tmp/chef-solo"
data_bag_path "/tmp/chef-solo/data_bags"
encrypted_data_bag_secret "/tmp/chef-solo/data_bag_key"
cookbook_path [ "/tmp/chef-solo/site-cookbooks",
"/tmp/chef-solo/vendor/cookbooks" ]
role_path "/tmp/chef-solo/roles"
EOF

8. 3. 共通の設定を記述
base cookbookを作成
管理者ユーザ情報を追加
% bin/knife cookbook create base -o site-cookbooks
% cat <<EOF >> site-cookbooks/base/metadata.rb
depends 'apt'
depends 'users'
depends 'sudo'
EOF
% cat <<EOF >> site-cookbooks/base/recipes/default.rb
include_recipe 'apt'
include_recipe 'users::sysadmins'
node.override['authorization']['sudo']['passwordless'] = true
include_recipe 'sudo'
EOF
% mkdir data_bags/users
% cat <<EOF > data_bags/users/miku.json
{
"id": "miku",
"uid": "10000",
"comment": "HATSUNE Miku",
"ssh_keys": [
"ssh-rsa AAAA(省略)= miku@client.example.local"
],
"groups": [ "sysadmin" ],
"shell": "/usr/bin/zsh"
}
EOF
監視設定等を含む
社内共通のbaseを準備中

9. 4. 個別の設定を記述
ウェブサイトの設定を
mysite cookbookとして作成
デプロイ用ユーザの情報を設定
% bin/knife cookbook create mysite -o site-cookbooks
% cat <<EOF >> site-cookbooks/mysite/recipes/default.rb
users_manage 'app' do
group_id 10001
action :create
end
include_recipe 'nginx'
nginx_vhost 'static.example.jp'
nginx_vhost 'rails.example.jp' do
unicorn true
end
EOF
% cat <<EOF > data_bags/users/app.json
{
"id": "app",
"ssh_keys": [
"ssh-rsa AAAA(省略) = usera@a.example.jp",
"ssh-rsa AAAA(省略) = userb@b.example.jp"
],
"groups": [ "app" ],
"shell": "/usr/bin/zsh"
}
EOF

10. 4. 個別の設定を記述
baseとmysiteを呼ぶRoleを作成
ここまでの設定をcommit
nginxの
設定ファイルを作成
% vim site-cookbooks/mysite/templates/default/static.example.jp.erb
% vim site-cookbooks/mysite/templates/default/rails.example.jp.erb
% cat <<EOF > roles/web.rb
name "web"
description "Web Server"
run_list(
"recipe[base]",
"recipe[mysite]"
)
EOF
% git add .
% git commit -m 'mysite configuration'

11. 5. Vagrantで作成したサーバに適用
サーバ準備
Vagrantの設定
（Vagrant.configure block）
Role "Web"を適用
vagrantユーザにsudo許可
サーバを起動してChefの設定を適用
サーバ起動後にChefの設定を再適用
% vagrant init precise32 http://files.vagrantup.com/precise32.box
% vi Vagrantfile
config.vm.provision :chef_solo do |chef|
chef.cookbooks_path = ["vendor/cookbooks", "site-cookbooks"]
chef.roles_path = 'roles'
chef.data_bags_path = 'data_bags'
chef.add_role('web')
chef.json = {
"authorization" => {
"sudo" => {
"users" => [ "vagrant" ]
}
}
}
end
% git add Vagrantfile
% git commit 'Initialized vagrant'
% vagrant up
% vagrant provision

12. 6. 本番サーバに適用
• 前回紹介した手順と同じ
% knife solo prepare root@192.0.2.100
% vi nodes/192.0.2.100.json
% knife solo cook root@192.0.2.100