Opscode chef はまだまだ OSS の初期段階で、パワーユーザの時代であるらしい。hack, patch, push 的な感じっぽい。十分に使い物になるレベルにはあるし、使えばたくさん良いことがある。なのでお作法に則って、 Let's enjoy!!!

メモ

information

自分で漁ること

Chef Wiki
@tily さんの日本語訳
Opscode Mailing Lists
Opscode github
Opscode Open Source Ticket Tracking

あとは、公開されている cookbook で何とかなるわけでは無く、それを参考にして自分でバンバン書くのが吉

cookbook に汎用性を持たせようとする動きはあるらしいが、現状では無理っぽい。というか、使うことによってベストプラクティスを模索している段階かも。

Foodcritic - A lint tool for your Opscode Chef cookbooks
Etsy's foodcritic rules

ここで定義されているスタイルに合わせる。(最近 FC001 が違うという議論もあって面白い ;)

Opscode Community Summit 2 Session Documentation

コミュニティサミットのドキュメントいろいろ参考になるかも。

導入

Server

Hosted Chef Server の Free 版で 5 node まで使えるので、これで勉強する。

Hosted Chef

Workstation

Workstation は事実上 gem で手管理のほうが関連するツール(knife-ec2やFoodcritic)を考えるといいかも

Workstation Setup for Debian and Ubuntu

しかも ruby 1.9.2 以上のほうがよさげ

Next Generation Ubuntu Ruby Packages

sudo apt-add-repository ppa:brightbox/ruby-ng
sudo aptitude update
sudo aptitude install ruby ruby-dev libopenssl-ruby rdoc ri irb build-essential wget ssl-cert curl
sudo gem install chef --no-ri --no-rdoc
sudo gem install knife-ec2 --no-ri --no-rdoc
sudo gem install foodcritic --no-ri --no-rdoc
sudo aptitude -y install git-core

Node

最近は omnibus install を推奨らしい

Omnibus Installation

sudo true && curl -L https://www.opscode.com/chef/install.sh | sudo bash

upgrade も ↑ で OK

sudo true && curl -L https://www.opscode.com/chef/install.sh | sudo bash -s -- -v 10.12.0

とかバージョン指定も可能。(今は 10.16.2)

(2015/06/25 追記: 最近は curl | sudo bash はさすがにマズイという風潮が... なので公式サイトの表面からは消えてるようです。[1])

my recipes

普段やっている設定を cookbook にまとめ中

nxhack / chef My recipes (opscode chef cookbooks) : Bootstrap - Configuration - Orchestration

★ 料理のコツ ★

一度だけ処理するとか、纏めて処理するとかは、action :nothing と notifies をうまく組み合わせると出来る

cookbook_file とか template とか file で create_if_missing の組み合わせと、さっきの action :nothing と notifies でいろいろ出来そう

cookbook_file と template は出来た対象ファイルの内容をチェックして、同じなら処理しないという挙動になる。また file は content の組み合わせでは、 backup は取ってくれるが、内容のチェックはしてくれないようだ。

execute, script, ruby_block とかの Resource に付ける名前は、同じ名前(重なる名前)は付けてはいけない

secure_password を使う場合は、cookbook openssl を upload して recipe['openssl'] を run_list に追加する事

knife-ec2

knife.rb

# EC2:
knife[:aws_access_key_id]     = "---"
knife[:aws_secret_access_key] = "---"
knife[:flavor]                = "t1.micro"
knife[:image]                 = "ami-c7b202ae"
knife[:aws_ssh_key_id]        = "EC2_Key_Pairs_Name"

ssh-agent

eval `ssh-agent`
ssh-add ~/.ssh/ssh_key.pem

(残っている ssh-agent への attach)

export SSH_AGENT_PID=`pgrep ssh-agent`
export SSH_AUTH_SOCK=`ls /tmp/ssh-*/agent.*`

knife ec2 server create -N node01.egrep.jp -x ubuntu

knife ec2 server create -N node01.egrep.jp -x ubuntu -r "role[node01],role[ec2-common]" -Z us-east-1d

knife ec2 server create -N node01.egrep.jp -x ubuntu -r "role[node01],role[ec2-common]" -Z us-east-1d --bootstrap-version 10.12.0

Custom Knife Bootstrap Script distro で指定するのもあり。(今は、OmniBus Installer を使った標準のままの chef-full.erb でやるようがよさげ)

knife ec2 server create -N node01.egrep.jp -x ubuntu -d ubuntu10.04-omnibus-ec2

knife ec2 server create -N node01.egrep.jp -x ubuntu -r "role[node01],role[ec2-common]" -d ubuntu10.04-omnibus-ec2 -Z us-east-1d

node name を指定して起動したインスタンスを停止する際に、chef-server に自動登録した node と client も同時に消したい場合

knife ec2 server delete i-xxxxxxxx -N node01.egrep.jp -P

knife bootstrap

すでに稼働しているインスタンスに opscode のリポジトリから chef client を node 名を指定してインストールする。

knife bootstrap IPADDRESS -N node01.egrep.jp -i ~/.ssh/ssh_key.pem -x ubuntu --sudo -d chef-full

Custom Knife Bootstrap Script

Bootstrap => Configuration => Orchestration の区別をして考える事が大事

knife role

knife role from file ec2-common.json

knife role show ec2-common -F json

(-Fj 使わない)

knife node

knife node run_list add node01.egrep.jp 'role[node01],role[ec2-common]'

knife search

knife search node '*:*' -a lsb.codename

chef-client

run_list を指定して起動する場合

chef-client -o 'role[node01],role[ec2-common]'

Recipe

node object

Common Automatic Attributes

knife-essentials

Knife Essentials

これは便利なので入れる方がよいそうです。

knife diff | fgrep diff

berkshelf

Berkshelf - Manage a Cookbook or an Application's Cookbook dependencies

便利っぽい

spiceweasel

Spiceweasel