MItamae Hacking Guide

Transcript

1. MItamae Hacking Guide Roppongi.rb #2 @k0kubun

2. ࣗݾ঺հ

3. ࠓ೔࿩͢͜ͱ • 1. Itamaeͱ͸ • 2. Itamae Goͱ͸ • 3.

   MItamaeͷ͝঺հ

4. 1. Itamaeͱ͸

5. Itamaeͱ͸ • https://github.com/itamae-kitchen/itamae • ChefϥΠΫͳߏ੒؅ཧπʔϧ • αʔόʔͷߏ੒ΛRuby DSLͰهड़͢Δ

6. Itamae DSL package 'nginx' do action :install end service 'nginx'

   do action [:enable, :start] end

7. ItamaeΛ࢖͏ͱԿ͕خ͍͠ͷ͔ • Puppet, Ansibleͱҧ͍ઃఆϑΝΠϧ͕Ruby • มͳDSLͱ͔YAMLΑΓRubyΛಡΉɾॻ͘ํָ͕͍͠ • Chefʹൺ΂ͯγϯϓϧͳπʔϧͳͷͰอक͕͠΍͍͢ • Chefʹൺ΂ίʔυϕʔε͕খ͘͞ɺ͙͢ʹ࢓૊ΈΛ೺Ѳ

   Ͱ͖Δ • Berkshelfͷ͔ΘΓʹrubygemsΛ࢖͏

8. ΫοΫύουʹ͓͚ΔItamae • αʔόʔͷߏ੒؅ཧʹ࢖ΘΕ͍ͯΔ • ݹ͍΋ͷ͸Puppet͕ͩItamaeʹҠߦத • ৽͍͠αʔόʔ͸جຊతʹItamaeͰ؅ཧ͞Ε͍ͯΔ • ͨͩ͠AppαʔόʔͳͲঢ়ଶΛ࣋ͨͳ͍΋ͷ͸Docker •

   ։ൃऀͷϚγϯͷηοτΞοϓʹ࢖ΘΕΔʮ༧ఆʯ • RubyͰॻ͔Εͨ಺੡πʔϧ͔ΒItamaeϕʔεͷ΋ͷʹҠߦத

9. Itamaeͷӡ༻Ͱൃੜͨ͠՝୊ • Itamaeͷ࣮ߦͷͨΊʹrubyΛηοτΞοϓ͠ͳ͚Ε͹ͳͳ͍ • itamae ssh(sshܦ༝ͷద༻)͕஗͍ͷͰαʔόʔଆʹItamaeΛೖΕ࣮ͯߦ͢ Δ • ։ൃ؀ڥͷηοτΞοϓʹ͓͍ͯɺLinuxͩͱruby͕ೖͬͯͳ͍͜ͱ͕͋Δ •

   ItamaeͷͨΊ͚ͩʹrubyͷ؀ڥҰࣜΛύοέʔδϯά͢Δͷ͸໘౗ͩ͠ɺ͔ ͱ͍ͬͯී௨ʹ࢖͏rubyͷ؀ڥ΋Ԛͨ͘͠ͳ͍ • ύοέʔδ͸طʹ͋Δ΋ͷͷɺ࠷ॳ͔ΒγϯάϧόΠφϦͰ࡞ΒΕͨ Itamae͕͋Δͱखܰͦ͏

10. 2. Itamae Goͱ͸

11. Itamae Go • https://github.com/k0kubun/itamae-go • GolangͰγϯάϧόΠφϦItamaeΛ࡞ͬͨ

12. ࡞ͬͨಈػ

13. Itamae Goͷ࢓૊Έ • mrubyͷVMΛ mitchellh/go-mruby Ͱ૊ΈࠐΜͰ͍Δ • mrubyͷΦϒδΣΫτΛҾ਺ʹGoͷstructΛ࡞ΔGoͷؔ ਺Λmrubyͷϝιουͱͯ͠ఆٛͨ͠ΫϥεΛ࡞Γɺͦ ͷΫϥε্ͰItamaeϨγϐΛinstance_eval

    • ͜Ε͕ItamaeͷDSLʹͳΔ • ࡞ΒΕͨGoͷstructΛݟͯGoͷؔ਺ͰΦϖϨʔγϣϯ

14. Itamae Goͷϝϯςਏ͍ • GoͷίʔυͰRubyͷϝιουΛఆ͍ٛͯ͘͠ ͷ͕͔ͳΓ໘౗ • SpecinfraΛGoͰ࠶࣮૷͢Δͷେม • libmruby.aΛϦϯΫ͠ͳ͕ΒCGOόΠϯσΟϯ άͷΫϩείϯύΠϧ͢Δͷଟ෼ී௨ʹͰ͖Δ

    ͚Ͳ໘౗

15. go-mrubyͷ࣮༻ྫͱͯ͠͸໘ന͍͕… • ͦ΋ͦ΋GoΛ࢖͏ඞཁ͋Δͷ͔ʁ • ผʹGo͡Όͳ͍ͱ࢖͑ͳ͍ϥΠϒϥϦͱ͔ݴޠػೳΛ࢖ͬͯ ͳ͍ • mruby-cliͱ͍͏ɺRubyΛධՁͰ͖ΔγϯάϧόΠφϦΛ࡞Δผ ͷιϦϡʔγϣϯ͕͋ͬͨ •

    ͍ͯ͏͔ͿͬͪΌ͚ڈ೥ͷRubyConfͰ஌͚ͬͯͨͲPokemon Goʹ͔͚ͨํ͕ྲྀߦΔͱࢥ͍ͬͯͭ΍ͬͯ͠·ͬͨ

16. 3. MItamaeͷ͝঺հ

17. MItamae • https://github.com/k0kubun/mitamae • mruby-cliΛ࢖ͬͨItamaeͷpure mruby࣮૷ • ʮݟڅ͑ʯʁ • ΤϜ(mruby)ɾΠλϚΤͰ͢

18. mruby-cliͱ͸ • https://github.com/hone/mruby-cli • mrubyͰγϯάϧόΠφϦΛ࡞ΔͨΊͷϘΠϥʔϓϨʔτ • ίϚϯυϥΠϯҾ਺ΛmrubyͷArrayʹม׵͠ɺmrubyͰఆٛ͞Εͨ __main__ Λݺͼग़͢Cݴޠͷmainؔ਺ •

    ͜ͷ __main__ ͷ࣮૷͚ͩ͢Ε͹ྑ͍ͷͰɺRubyҎ֎Λॻ͔ͣʹࡁΉ • macOS, Windows޲͚ʹΫϩείϯύΠϧ͢ΔͨΊͷ؀ڥΛ࣋ͭ Dockerfile • ࣮ମ: https://github.com/hone/mruby-cli-docker

19. MItamae: ΅͕͔͘Μ͕͍͖͑ͨ͞ΐ͏ͷItamae • ruby΍gemʹґଘ͠ͳ͍ͨΊɺόΠφϦΛμ΢ϯϩʔυ͢Δ͚ͩͰଈ࣮ߦՄೳ • CRubyΛ࢖͏৔߹ͱҧͬͯίϯύΠϧࡁͳͷͰɺىಈ͕ߴ଎ • ιʔείʔυΛύʔεͯ͠YARV iseqʹίϯύΠϧ͢Δ·Ͱͷίετ͕ͳ͍ •

    2.5GHz Intel Core i7Ͱɺitamae: 499ms, mitamae: 23ms (21.7ഒ଎) • itamae sshΛαϙʔτ͍ͯ͠ͳ͍ͷͰɺSpecinfra(ඞͣԿΒ͔ͷίϚϯυΛ࢖͏) ͷ͔ΘΓʹී௨ʹCͷؔ਺Λ࢖͏͜ͱͰߴ଎Խ͕Մೳ • Ͳ͏ͤitamae ssh͸஗͍ͷͰɺαʔόʔ΁ͷItamaeͷॳճΠϯετʔϧͱ͔ʹ ͔͠࢖Θͳ͍͠ɺ΍Δʹͯ͠΋ผͷπʔϧʹͯ͠Αͦ͞͏

20. MItamaeͷεςʔλε • େମͷػೳ͸͋Δ • https://github.com/k0kubun/mitamae#supported-features • fileͷedit, host inventory, verify,

    subscribes(notifies͸͋Δ)͕ͳ͍ • remote_directory, http_request, local_ruby_block ͕ͳ͍ • Arch Linux, CentOS, Debian, Gentoo, macOS, UbuntuΛαϙʔτ • ItamaeຊՈͷ݁߹ςετ͕େମ௨Δ • Travis্ͰDockerίϯςφʹapplyͯ͠ServerspecͰςετͯ͠Δ

21. Itamae 2ʁ • ҿΈձͰryotarai͞Μ(Itamae࡞ऀ)͕itamae- mruby(MItamaeͷ౰࣌ͷ໊લ)ΛItamae 2ʹ͢Δͬͯ ݴͬͯͨ • ͱΓ͋͑ͣػೳ͕ἧͬͯར༻࣮੷΋૿͑Δඞཁ͕͋Γ ͦ͏

    • ͳͷͰɺ͓͢͢Ίͷ༻్ͱɺMItamaeͷ಺෦ઃܭ΍ ։ൃํ๏ʹ͍ͭͯઆ໌͠·͢

22. MItamaeͷ༻్

23. ๻ͷMItamaeͷ༻్ • dotfilesͷద༻ • https://github.com/k0kubun/dotfiles • ϨγϐΛࢀߟʹ͍ͨ͠ํ͸ https://github.com/k0kubun/ legacy-dotfiles ΋Ͳ͏ͧ

    • ࣗ୐Ͱ΋ձࣾͰ΋σεΫτοϓϚγϯʹLinuxΛ࢖͍ͬͯΔ͕ɺ ࠷ॳͷηοτΞοϓલʹrubyΛ͍ΕΔඞཁ͕ͳͯ͘ඍົʹॿ͔Δ • ىಈ଎͍͠ɺgem install / bundle install΋ෆཁͩ͠Կ͔ͱָ

24. ΫοΫύουͰͷར༻ঢ়گ • ։ൃ؀ڥͷηοτΞοϓπʔϧΛItamaeϕʔεͷ΋ͷʹҠߦதͰɺͦ͜ʹ MItamae͕࠾༻͞Ε͍ͯΔ • αʔόʔͷߏ੒؅ཧ޲͚ʹ͸·ͩ࢖ΘΕͯͳ͍ • ࣾ಺޲͚ͷपลπʔϧ͕Itamaeͱ݁߹͍ͯͯ͠Ҡߦ͕एׯେม • ͦ΋ͦ΋Itamaeͩͱ໘౗ͳͷ͸ύοέʔδϯά͕ͩɺࣾ಺Ͱ࢖͍ͬͯΔ

    αʔόʔ޲͚ʹ͸طʹύοέʔδ͕͋ΔͷͰͦΕ΄ͲϞνϕʔγϣϯ͕ͳ ͍ • Ͱ΋γϯάϧόΠφϦͰΫϦʔϯ͔ͭ଎͍ͷͰ͜Ε͔Βಋೖ͢Δํʹ͸͓ ͢͢Ί

25. Inside MItamae

26. MItamaeͷ಺෦࣮૷ • جຊతʹ͸mruby-cli࢖ͬͯΔ͚ͩ • Itamae෦෼͸εΫϥον • Specinfra෦෼͸΄΅ͦͷ··͖࣋ͬͯͨ • ΋ͪΖΜAuthorsͱLICENSEදهʹmizzy͞Μ ͕͍·͢

27. MItamaeͱItamaeͷ࣮૷ͷҧ͍ • resourceͱresourceΛద༻͢Δ੹຿͕෼཭͞Ε͍ͯͯɺresource ͸ͨͩͷϞσϧʹ͗͢ͳ͍ • ryotarai͞ΜͷΞΠσΞ • ๻ͷझຯ͕ೖ͍ͬͯΔ • ͳΔ΂͘method_missingΛආ͚ϕλॻ͖͢Δ(΋͏গ͠ݮΒͤ

    Δ͚Ͳ)ɺͳͲ • defineͨ͠resourceʹωετͨ͠resource಺Ͱparams͕࢖͑Δ

28. defineͨ͠resourceʹωετͨ͠ resource಺Ͱparams͕࢖͑Δ ???? # Itamae ͷ৔߹ define :ruby do version

    = params[:name] execute "..." do not_if "... #{version}" end end ruby '2.3.1'

29. defineͨ͠resourceʹωετͨ͠ resource಺Ͱparams͕࢖͑Δ ???? # MItamaeͷ৔߹ (Itamaeͩͱparams͕ࢀরෆೳ) define :ruby do execute

    "..." do not_if "... #{params[:name]}" end end ruby '2.3.1'

30. Hacking MItamae

31. cloneͯ͠ίϯύΠϧ࣮ͯ͠ߦ $ git clone https://github.com/k0kubun/mitamae $ cd mitamae $ rake

    compile $ mruby/build/host/bin/mitamae local recipe.rb

32. ςετͷ࣮ߦ # Ϣχοτςετͷ࣮ߦ $ rake test:mtest # DockerͱServerspecΛ࢖ͬͨςετ $ rake

    test:integration

33. ΫϩείϯύΠϧ # mitamae-buildσΟϨΫτϦʹ࡞ΒΕΔ $ rake release:build

34. ·ͱΊ • MItamae͸଎ͯ͘Πϯετʔϧ͕؆୯ͳͷͰ ࢖ͬͯཉ͍͠ • ։ൃ؀ڥ͸੔ͬͯΔͷͰMItamaeͷ։ൃʹࢀ Ճ͠Α͏!