Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
Hand Crafted Artisinal Chef Resources
Search
someara
February 02, 2016
Technology
0
560
Hand Crafted Artisinal Chef Resources
Configuration Management Camp
Ghent Belgium
February 2016
someara
February 02, 2016
Tweet
Share
More Decks by someara
See All by someara
Docker Docker Docker Chef
someara
0
450
Configuration Management Camp 2015
someara
1
540
Cookbook Reusability
someara
0
650
TDI with ChefDK 0.0.1
someara
2
720
Configuration Management 101 @ Scale12x
someara
2
850
Configuration Management 101
someara
3
740
Introduction to Chef - Scale 10x
someara
2
420
Introduction to Chef - NYLUG Jan 2012
someara
2
270
Introduction to Chef - LISA11
someara
10
6.1k
Other Decks in Technology
See All in Technology
Rubyの国のPerlMonger
anatofuz
3
730
Perlアプリケーションで トレースを実装するまでの 工夫と苦労話
masayoshi
1
410
Agent Development Kitで始める生成 AI エージェント実践開発
danishi
0
120
「Roblox」の開発環境とその効率化 ~DAU9700万人超の巨大プラットフォームの開発 事始め~
keitatanji
0
110
LIFF CLIとngrokを使ったLIFF/LINEミニアプリのお手軽実機確認
diggymo
0
230
Claude CodeでKiroの仕様駆動開発を実現させるには...
gotalab555
3
900
【CEDEC2025】『ウマ娘 プリティーダービー』における映像制作のさらなる高品質化へ!~ 豊富な素材出力と制作フローの改善を実現するツールについて~
cygames
PRO
0
230
AI人生苦節10年で会得したAIがやること_人間がやること.pdf
shibuiwilliam
1
270
마라톤 끝의 단거리 스퍼트: 2025년의 AI
inureyes
PRO
1
690
猫でもわかるQ_CLI(CDK開発編)+ちょっとだけKiro
kentapapa
0
3.4k
【CEDEC2025】現場を理解して実現!ゲーム開発を効率化するWebサービスの開発と、利用促進のための継続的な改善
cygames
PRO
0
720
モバイルゲームの開発を支える基盤の歩み ~再現性のある開発ラインを量産する秘訣~
qualiarts
0
1.1k
Featured
See All Featured
Performance Is Good for Brains [We Love Speed 2024]
tammyeverts
10
1k
The World Runs on Bad Software
bkeepers
PRO
70
11k
JavaScript: Past, Present, and Future - NDC Porto 2020
reverentgeek
50
5.5k
Rebuilding a faster, lazier Slack
samanthasiow
83
9.1k
Thoughts on Productivity
jonyablonski
69
4.8k
I Don’t Have Time: Getting Over the Fear to Launch Your Podcast
jcasabona
33
2.4k
RailsConf & Balkan Ruby 2019: The Past, Present, and Future of Rails at GitHub
eileencodes
139
34k
Why You Should Never Use an ORM
jnunemaker
PRO
58
9.5k
The Success of Rails: Ensuring Growth for the Next 100 Years
eileencodes
46
7.5k
Why Our Code Smells
bkeepers
PRO
337
57k
Helping Users Find Their Own Way: Creating Modern Search Experiences
danielanewman
29
2.8k
Embracing the Ebb and Flow
colly
86
4.8k
Transcript
Hand Crafted Artisanal Chef Resources
Config Management Camp Ghent, Belgium February 2016
Sean OMeara
[email protected]
@someara
whoami
Part 1
Writing library cookbooks An opinionated workflow Step by step
Step 1 - Disregard dogma “Unit tests first” is a
dirty lie https://flic.kr/p/aTSiXF
Step 2 - Make things up Then work backwards https://flic.kr/p/dXkQ5s
Contrived examples are the best examples
None
Place this off to the side, we will come back
for it later.
Step 3 - Create a cookbook By hand. Be a
wizard. https://flic.kr/p/3mMW6e
mkdir -p ~/src/custom-resources-tutorial cd ~/src/custom-resources-tutorial emacs metadata.rb
None
Step 4 - Embed a test cookbook. By hand. Be
a wizard. Again. https://flic.kr/p/ai36NG
mkdir -p test/cookbooks/my_file_test cd test/cookbooks/my_file_test echo “test cookbook” > README.md
mkdir recipes touch recipes/default.rb emacs metadata.rb
None
Step 5 - Tell Berkshelf about it https://flic.kr/p/k5jmja
cd ~/src/custom-resources-tutorial emacs Berksfile
None
Step 6 - Configure Test Kitchen https://flic.kr/p/r38F5c
emacs .kitchen.yml
None
kitchen test ; echo $?
Step 7 - Save game https://flic.kr/p/6ZJ4G7
cd ~/src/custom-resources-tutorial cp ~/src/chef-cookbooks/docker/.gitignore . cp ~/src/chef-cookbooks/docker/.rubocop.yml .
rubocop -a git init git add . git commit -a
-m 'v0.0.1 - cookbook skeleton' git tag v0.0.1
Step 8 - Use resource in test recipe https://flic.kr/p/8MuUAX
emacs test/cookbooks/my_file_test/recipes/ default.rb
None
kitchen converge ; echo $?
Step 9 - Implement resource https://flic.kr/p/bkVKRb
cd ~/src/custom-resources-tutorial mkdir libraries emacs libraries/my_file.rb
None
kitchen converge ; echo $? kitchen converge ; echo $?
Step 10 - Test for behavior https://i.ytimg.com/vi/1y8Rqvz-Jcg/ maxresdefault.jpgz
mkdir -p test/integration/my_file/inspec emacs -p test/integration/my_file/inspec/ run_spec.rb
None
kitchen verify ; echo $?
Step 11 - Add specs and commit https://flic.kr/p/rrgfZh
cd ~/src/custom-resources-tutorial mkdir spec emacs spec/spec_helper.rb
None
emacs spec/my_file_spec.rb
None
rubocop -a rspec ; echo $? git add . git
commit -a -m “v0.1.0 - my_file resource” git tag v0.1.0
stove 0.1.0
Step 12 - Iterate indefinitely https://flic.kr/p/8Ny8Jt
Congratulations, you have now written one software.
You must now maintain it forever.
muahaha.
None
Part 2
Custom Resources Tips and Tricks
Be explicit https://flic.kr/p/pz1JAo
None
None
None
None
Converge twice during development Use markers for “negative” actions https://flic.kr/p/pqwd5U
None
None
Tests let you refactor with confidence https://flic.kr/p/4WnjM4
None
STAR WIPE
None
Pure Ruby resources https://flic.kr/p/5km2fM
Pure Ruby resources utilize - The Ruby Standard Library -
Chef helper libs (mixlib-shellout) - Ruby gems
None
It might make sense to vendor gems
load_current_value - Runs at converge time - Just before the
action body - Loads desired state values
None
converge_if_changed - Runs if any desired_state: true property differs from
user input - desired_state: false avoids comparison
None
coerce transforms values - Called when property is set -
Called when property is read - Use this to raise errors on bad input
The docker_container resource uses coercion heavily https://github.com/chef-cookbooks/ docker/blob/master/libraries/ docker_container.rb
lazy defaults - Delays evaluation until used - Useful for
calculated values
None
Composite resources https://flic.kr/p/fm58oo
Composite resources - Reuse Chef resources - Actions look like
recipes - Do not use load_current_value
etcd_installation_binary :create
httpd_config_rhel :create
Avoid leaky abstractions https://flic.kr/p/7d1kDc
Resources should be minimalist
Early versions might be simple
None
They rarely stay that way
Iterate and add more features Break down into smaller resources
Use naming semantics to describe strategy
etcd_installation_binary etcd_installation_docker etcd_installation_package etcd_service_manager_docker etcd_service_manager_execute etcd_service_manager_systemd etcd_service_manager_sysvinit etcd_service_manager_upstart
Recycle patterns as they emerge
docker_installation_binary docker_installation_package docker_installation_script docker_service_manager_execute docker_service_manager_systemd docker_service_manager_sysvinit docker_service_manager_upstart
Chef selects defaults with the provider resolution system
…
…
Compose resources Most specific to least specific
None
Enjoy
fin