ドキュメントの重要性と、それを公開する意味 /20160902

2016年9月2日開催のすだちくん勉強会での発表資料です。

詳細: https://www.opslab.jp/publish/20160902-sudachi.html

(運用設計ラボ合同会社 波田野裕一)

Transcript

1. Operation Lab ӡ༻ઃܭϥϘ υΩϡϝϯτͷॏཁੑͱɺͦΕΛެ։͢Δҙຯ 1 ӡ༻ઃܭϥϘ߹ಉձࣾ
   
   
   γχΞΞʔΩςΫτ
   ೾ా໺
   ༟Ұ  TU
   ͩͪ͘͢Μ
2. Operation Lab ӡ༻ઃܭϥϘ υΩϡϝϯτॻ͍ͯ·͔͢
3. Operation Lab ӡ༻ઃܭϥϘ ࣄྫ
   ະདྷͷࣗ෼͸ଞਓ աڈΛ๨Εڈͬͨࣗ෼͔Β΋
   ʮۀ຿͕ଘࡏ͠ͳ͍ʯʹ౳͍͠ ະདྷͷࣗ෼ʹཧղͯ͠΋Β͏ʹ΋
   ʮۀ຿ͷ٬؍Խʯ͕ඞཁ ٬؍Խ
   
   ٬ ະདྷͷࣗ෼ࣗ਎ ͕؍ͯΘ͔ΔΑ͏ʹ͢Δ ಛʹ୅ޙ൒͔Βݦஶ
4. ࣄྫ
   4ۀքք۾Ͱฉ͍ͨʮ͋Δ͋Δʯ Operation Lab ӡ༻ઃܭϥϘ ελʔτΞοϓͷ$50 ڀۃͷΦϨΦϨγεςϜΛ௥͍ٻΊͯ ൒೥͢ΔͱʮίϨδϟφΠײʯʹ՗·Εͯ ɺɺɺ࢟Λফ͢ Β͍͠ ɺɺɺ υΩϡϝϯτ͸ SZ Ϋϥ΢υ࣌୅ͷ໺ྑαʔϏε
   ஍ࠈײϋϯύφΠ ٬؍Խ
   
   ٬ Ҿ͖ܧ͙ਓ ͕؍ͯΘ͔ΔΑ͏ʹ͢Δ
5. Operation Lab ӡ༻ઃܭϥϘ ͦ΋ͦ΋υΩϡϝϯτͱ͸Կ͔
6. ਓ͸ͳͥυΩϡϝϯτΛॻ͘ͷ͔ Operation Lab ӡ༻ઃܭϥϘ ‣ ෆಛఆଟ਺ͱͷڞ༗ ‣ ΦϐχΦϯ/δϟʔφϦζϜ ‣ ීวͳΔ΋ͷ΁ ࣌Λ௒͑ ۭؒΛ௒͑ ۭ࣌Λ௒͑Δ ‣ ະདྷͷࣗ෼΁ͷڞ༗ ‣ උ๨ɺաڈͷূ੻ ‣ ஌ࣝɺܦݧͷ੔ཧɺ֎෦Խ(ϊʔτ) ‣ ߦҝͷఆܕԽ (खॱॻɺνΣοΫϦετ) ‣ ෳ਺ਓͰͷڞ༗ ‣ උ๨ɺաڈͷূ੻ ‣ ೝࣝͷڞ༗ɺ֬ೝ ‣ ஌ࣝͷసૹ ‣ ఆܕԽ (ઃܭɺ࣮૷ɺӡ༻)
7. ਓ͸ͳͥυΩϡϝϯτΛॻ͘ͷ͔ Operation Lab ӡ༻ઃܭϥϘ ਓ͸ۭ࣌Λ௒͑ΔͨΊʹ υΩϡϝϯτΛॻ͘ ੈք࠷ݹͷυΩϡϝϯτ͸ɺ5300೥લͷϝιϙλϛΞͷ೶࡞ۀɺ຀சจॻ 5300೥લͷϝιϙλϛλͷ࢓ࣄ͕ 21ੈلͷ೔ຊͰ΋࠶ݱͰ͖Δ (ͨͿΜ)
8. ਓ͸ͳͥυΩϡϝϯτΛॻ͘ͷ͔
   ྨܕ Operation Lab ӡ༻ઃܭϥϘ ୤ଐਓԽ ٬؍Խ ੔ཧ ه࿥ ٬؍Խ ੔ཧ ه࿥ ٬؍Խ ୤ଐਓԽ ه࿥ ੔ཧ ٬؍Խ ୤ଐਓԽ ‣ ෆಛఆଟ਺ͱͷڞ༗ ‣ ΦϐχΦϯ/δϟʔφϦζϜ ‣ ීวͳΔ΋ͷ΁ ‣ ະདྷͷࣗ෼΁ͷڞ༗ ‣ උ๨ɺաڈͷূ੻ ‣ ஌ࣝɺܦݧͷ੔ཧɺ֎෦Խ(ϊʔτ) ‣ ߦҝͷఆܕԽ (खॱॻɺνΣοΫϦετ) ‣ ෳ਺ਓͰͷڞ༗ ‣ උ๨ɺաڈͷূ੻ ‣ ೝࣝͷڞ༗ɺ֬ೝ ‣ ஌ࣝͷసૹ ‣ ఆܕԽ (ઃܭɺ࣮૷ɺӡ༻)
9. υΩϡϝϯτ͕࣮ݱ͢Δ΋ͷ Operation Lab ӡ༻ઃܭϥϘ ୤ଐਓԽ ٬؍Խ ੔ཧ υΩϡϝϯτ ͷຊ࣭తͳجૅػೳ͸ʮه࿥ʯ͢Δ͜ͱ ه࿥ ʮॻ͘ʯͱ͍͏࡞ۀʹΑΓʮ੔ཧʯ͞Ε͍ͯ͘ ʮ༗ܗͷ੒Ռ෺ʯͱͳΔ͜ͱͰʮ٬؍Խʯ͞Ε͍ͯ͘ ࣌ͱۭؒΛ௒͑ͯ஌ݧ͕ڞ༗͞Ε͍ͯ͘ Ϩϕϧ1 Ϩϕϧ2 Ϩϕϧ3 Ϩϕϧ4
10. ݁࿦
    ͦ΋ͦ΋υΩϡϝϯτͱ͸Կ͔ Operation Lab ӡ༻ઃܭϥϘ ۀ຿ʹؔ࿈ͯ͠ɺ ࣗ෼΍ଞऀʹڞ༗͢Δ໨తͰɺ ॻ͔ΕΔจॻɺͷ͜ͱ
11. Operation Lab ӡ༻ઃܭϥϘ υΩϡϝϯτ͸ͳͥඞཁ͔
12. Operation Lab ӡ༻ઃܭϥϘ ࣄྫ
    ΞϯυΩϡϝϯτ͕΋ͨΒ͢΋ͷ ಛʹ୅ޙ൒͔Βݦஶ ۀ຿่յ څ༩ݮ αʔϏε่յ աڈΛ๨Εڈͬͨࣗ෼͔Β΋
    ʮۀ຿͕ଘࡏ͠ͳ͍ʯʹ౳͍͠
13. ࣄྫ
    ΞϯυΩϡϝϯτ͕΋ͨΒ͢΋ͷ Operation Lab ӡ༻ઃܭϥϘ αʔϏε่յ αʔϏε่յ ձ่ࣾյ ڀۃͷΦϨΦϨγεςϜΛ௥͍ٻΊͯ ൒೥͢ΔͱʮίϨδϟφΠײʯʹ՗·Εͯ ɺɺɺ࢟Λফ͢ɺɺɺ υΩϡϝϯτ͸ SZ څ༩ফ໓
14. ·ͱΊ
    ΞϯυΩϡϝϯτ͕΋ͨΒ͢΋ͷ Operation Lab ӡ༻ઃܭϥϘ ʮ๩ͦ͠͏ʹ͍ͯ͠Δ͚ͲɺԿ΍͍ͬͯΔͷ͔Θ͔Βͳ͍ʯ ͱݴΘΕͯ͠·͏ɻ υΩϡϝϯτͷͳ͍ۀ຿͸ɺ٬؍తʹ͸
    ʮଘࡏ͠ͳ͍ʯʹ౳͍͠ ۀ຿่յ څ༩ݮ αʔϏε่յ ձ่ࣾյ څ༩ফ໓
15. ݁࿦
    υΩϡϝϯτ͸ͳͥඞཁ͔ Operation Lab ӡ༻ઃܭϥϘ ୤ଐਓԽͷͨΊʹඞཁ ٬؍ԽͷͨΊʹඞཁ ੔ཧͷͨΊʹඞཁ ʮࣗ෼ୡͷ΍͍ͬͯΔ͜ͱΛ஌Δ&վળ͢ΔͨΊʹʯ ʮࣗ෼ୡͷ΍͍ͬͯΔ͜ͱͷઆ໌&(ࣗݾɾଞऀ)ධՁͷͨΊʹʯ ʮࣗ෼ୡͷ΍͍ͬͯΔ͜ͱͷ҆ఆԽ&ӬଓԽͷͨΊʹʯ
16. Operation Lab ӡ༻ઃܭϥϘ υΩϡϝϯτ͸ͳͥॏཁ͔
    ࣄྫ
17. υΩϡϝϯτ͸ ιʔείʔυͰ͍͍ΑͶ େࢂࣄͷ༧ஹ ྫ 
    ͱ͋Δ੠ Operation Lab ӡ༻ઃܭϥϘ μϝ θολΠ μϝ
18. ࣄۀ΍ۀ຿ʹ͸8)͕ඞཁ Operation Lab ӡ༻ઃܭϥϘ when where who what how ͍ͭ (࣌ؒ) Ͳ͜Ͱ (ۭؒ) ୭͕ (ओޠɾओମ) ԿΛ (໨తޠɾ٬ମ) Ͳ͏͢Δ (ಈ࡞) ۀ຿΍ΞϓϦ ιʔείʔυ why ͳͥ (ࠜຊతͳҙਤ) ςετίʔυ ൈ͚མͪΔ
19. υΩϡϝϯτ͕͋Ε͹ϓϩμΫτ͸࠶ݱͰ͖Δ Operation Lab ӡ༻ઃܭϥϘ when where who what how ιʔείʔυ why ςετίʔυ υΩϡϝϯτ ίʔυ΁ͷม׵ CodePipeline Dockerfile AWS CLI CodeCommit ElasticBeanstalk ҙਤΘ͔Δ ࠶ݱੑ & Ӭଓੑ ۀ຿΍ΞϓϦ
20. ιʔείʔυ͔͠ແ͚Ε͹ϓϩμΫτ͸ Operation Lab ӡ༻ઃܭϥϘ when where who what how ιʔείʔυ why υΩϡϝϯτ ίʔυ΁ͷม׵ CodePipeline Dockerfile AWS CLI CodeCommit AMI ࣦͳΘΕΔӬଓੑ ࢖͍ํ͸? ҙਤ͸? ۀ຿΍ΞϓϦ
21. ιʔείʔυ͔͠ແ͚Ε͹ϓϩμΫτ͸ Operation Lab ӡ༻ઃܭϥϘ ιʔείʔυ ࣦͳΘΕΔӬଓੑ ఻આͷιϦϡʔγϣϯΞʔΩςΫτ Ͱ΋͓ख্͛ (ੲͷ৬৔) when where who what how why υΩϡϝϯτ ۀ຿΍ΞϓϦ
22. Operation Lab ӡ༻ઃܭϥϘ ࢀߟ
    ࣗಈԽ͸ʮ໨తʯͰ͸ͳ͍ ࣗಈԽ͸ʮυΩϡϝϯτԽͷ݁ՌʯͰ͋ͬͯʮ໨తʯͰ͸ͳ͍ɻ ʮࣗ෼ୡͷ΍͍ͬͯΔ͜ͱͷ҆ఆԽӬଓԽͷͨΊʹʯ ໨త
    ୤ଐਓԽ खஈ
    ࣗಈԽ ʮυΩϡϝϯτԽ͞Εͨۀ຿ͷҰ෦ʯΛࣗಈԽ͢Δɻ ໨తͱखஈ͕ͻͬ͘Γ͔͑Δ͜ͱ͸ɺΑ͋͘Δ͜ͱ • ʮࣗಈԽ͞Εͨۀ຿ʯͷอक͕ଐਓԽ͢Δɻ
    • ʮࣗಈԽ͞Εͨۀ຿ʯͷ࢓༷͕ෆ໌ͳͨΊɺมߋ͕Ͱ͖ͳ͍ɻ ஍ཕঢ়ଶ
    • ʮࣗಈԽ͞Εͨۀ຿ʯͰτϥϒϧ͕ൃੜ͢ΔͱɺϦΧόϦͰ͖ͳ͍ɻ खॱ͕Θ͔Βͳ͍ ʮࣗಈԽ͕໨తʯʹΑΔʮ͋Δ͋Δʯ 2014೥ͷൃදࢿྉΑΓ 8IZ͕ࣦͳΘΕͨӡ༻
23. Operation Lab ӡ༻ઃܭϥϘ આ໌׬ྃ υΩϡϝϯτͷॏཁੑͱɺͦΕΛެ։͢Δҙຯ ࣗ෼ୡͷ΍͍ͬͯΔ͜ͱͷ ҆ఆԽ&ӬଓԽͷͨΊ
24. Operation Lab ӡ༻ઃܭϥϘ υΩϡϝϯτͷॏཁੑͱɺͦΕΛެ։͢Δҙຯ ࣍
25. Operation Lab ӡ༻ઃܭϥϘ υΩϡϝϯτΛެ։͢Δҙຯ ࣄྫΛݟͯΈ·͠ΐ͏
26. Operation Lab ӡ༻ઃܭϥϘ ࣄྫ
    "84
    ֤छυΩϡϝϯτ 26 "84͸֎෦͔ΒݟΔݶΓ
    υΩϡϝϯτۦಈϏδωε AWSͷυΩϡϝϯττοϓϖʔδ αϙʔτ͕ڭ͑ͯ͘ΕΔ৘ใ͸΄ͱΜͲެ։ࡁ • ೖ໳ΨΠυ
    • ։ൃऀΨΠυ
    • "1*ϦϑΝϨϯε
    • (FUUJOH4UBSUFE
    • 8BML5ISPVHI
    • ϗϫΠτϖʔύʔ
    • ؂ࠪϨϙʔτ
    ཁ/%" ϢʔβͷϏδωεͱࣗ෼ୡͷϏδωε ྆ํͷ҆ఆԽ&ؔ܎ߏங&ӬଓԽͷͨΊ
27. Operation Lab ӡ༻ઃܭϥϘ ࣄྫ
    DMPVEQBDLϗϫΠτϖʔύʔ 27 ੵۃతʹ৘ใΛ։ࣔ͠ɺ
    αʔϏεͷಁ໌ੑΛߴΊΔ "84
    4VNNJU
    Ͱ
    ෦
    ׬ച ϢʔβͷϏδωεͱࣗ෼ୡͷϏδωε ྆ํͷ҆ఆԽ&ؔ܎ߏங&ӬଓԽͷͨΊ
28. Operation Lab ӡ༻ઃܭϥϘ DMPVEQBDL
    4FDVSJUZ
    8IJUF
    1BQFSΛྫʹ 28 ͓٬༷اۀͷ֤εςʔΫϗϧμʔΛҙࣝͨ͠ߏ੒ • DMPVEQBDLͱ͸
    • Ϋϥ΢υ࣌୅ͷγεςϜ։ൃͱγεςϜӡ༻
    • ࣄۀ֓ཁͱηΩϡϦςΟ΁ͷऔΓ૊Έ
    • DMPVEQBDLͷηΩϡϦςΟମ੍ϙϦγʔ
    • ఏڙϓϥϯͱηΩϡϦςΟϚωδϝϯτ
    • ηΩϡϦςΟΛߋʹߴΊΔͨΊͷΦϓγϣϯαʔϏε
    • ֤छΨΠυϥΠϯɺ࿈བྷ૭ޱ Ψόφϯε୲౰ऀ $50 γεςϜ୲౰ऀ ϢʔβͷϏδωεͷ҆ఆԽ&ӬଓԽͷͨΊʹ Կ͕Ͱ͖Δ͔Λࣔ͢͜ͱͰɺಋೖ୲౰ऀΛࢧԉ ࣄྫ
29. Operation Lab ӡ༻ઃܭϥϘ ϗϫΠτϖʔύʔΛͳͥ࡞Δͷ͔ 29 ࣄྫ
    DMPVEQBDL
    4FDVSJUZ
    8IJUF
    1BQFSΛྫʹ ͓٬༷ ϝϯόʔ ࣗΒͷ૝͍ʹؾ෇͘ ڞ௨ೝࣝ αʔϏε੹೚ऀ ڞ௨ೝࣝ • ͓٬༷ʹ఻͑Δ
    • ϝϯόʔʹ఻͑Δ
    • ࣗΒͷ૝͍ʹؾ෇͘ ڞ௨ೝࣝ
30. Operation Lab ӡ༻ઃܭϥϘ ϗϫΠτϖʔύʔʹΑΓಘΒΕΔ΋ͷ 30 ࣄྫ
    DMPVEQBDL
    4FDVSJUZ
    8IJUF
    1BQFSΛྫʹ • ֎෦ ͓٬༷ ͔Βͷظ଴ͷ໌֬Խɺඪ४Խ
    • ಺෦ ϝϯόʔ ΁ͷظ଴ͷ໌֬Խɺฏ४Խ
    • υΩϡϝϯτॏࢹͷ࢟੎Λϒϥϯυʹ൓ө ϢʔβͷϏδωεͱࣗ෼ୡͷϏδωε ྆ํͷ҆ఆԽ&ؔ܎ߏங&ӬଓԽͷ֮ޛΛࣔ͢
31. Operation Lab ӡ༻ઃܭϥϘ ࣄྫ
    .41ϏδωεΨΠυϥΠϯ
    Ծশ 31 ϢʔβͷϏδωεͱࣗ෼ୡͷϏδωε ྆ํͷ҆ఆԽ&ؔ܎ߏங&ӬଓԽͷͨΊ .41ࣄۀऀ͕ڞಉͯ͠
    ۀքͷະདྷΛ໛ࡧ
32. ݁࿦
    υΩϡϝϯτΛެ։͢Δҙຯ Operation Lab ӡ༻ઃܭϥϘ Ϗδωεͷ҆ఆԽ&ӬଓԽ ίϛϡχέʔγϣϯͷ҆ఆԽ&ӬଓԽ ৽͍ؔ͠܎ͷߏங ʮͦΜͳͷฉ͍ͯͳ͍Αʔʯͷճආ ૒ํϋοϐʔɻ8JO8JOͳύʔτφʔɻ ෆ҆ఆͳϏδωε͸૒ํʹͱͬͯෆ޾
33. Operation Lab ӡ༻ઃܭϥϘ ͓·͚
    ͜Ε͔ΒͷυΩϡϝϯςʔγϣϯ
34. Operation Lab ӡ༻ઃܭϥϘ ʮͦ͏͸ݴ͏΋ͷͷʯͱ͍͏੠ 34 ͓·͚ શͯਓ͕खͰॻ͘͜ͱ Λ૝ఆ͍ͯ͠·ͤΜ͔? υΩϡϝϯτॻ͕࣌ؒ͘
35. Operation Lab ӡ༻ઃܭϥϘ υΩϡϝϯτ࡞੒ 35 when where who what how γεςϜ͕هड़͢Δύʔπ why ਓ͕هड़͢Δύʔπ Doc ΠϯΫϧʔυ ͓·͚ ΠϯΫϧʔυΛલఏͱ͢Δ࣌୅΁ ࠶ར༻Λલఏ ݸผࣄ৘Λهड़
36. ΠϯΫϧʔυΛ׆༻͢ΔυΩϡϝϯςʔγϣϯ Operation Lab ӡ༻ઃܭϥϘ • $47σʔλΛΠϯΫϧʔυͯ͠ςʔϒϧදࣔ
    • ιʔείʔυΛΠϯΫϧʔυͯ͠ϋΠϥΠτදࣔ
    • ιʔείʔυͷಛఆൣғΛΠϯΫϧʔυͯ͠දࣔ
    • ஔ׵ͷఆٛͱద༻৔ॴͷهड़ΛΠϯΫϧʔυ
    • υΩϡϝϯτͷύʔπΛΠϯΫϧʔυ
    SF45SVDUVSFE
    5FYUܗࣜ ͓·͚ Ұ౓ॻ͍ͨυΩϡϝϯτͷ࠶ར༻΍γεςϜͷग़ྗ
    Λ׆͔ͨ͠൒ࣗಈυΩϡϝϯςʔγϣϯ ଟ࠼ͳΠϯΫϧʔυػೳ
37. Operation Lab ӡ༻ઃܭϥϘ ࣄྫ
    +"846(
    $-*ઐ໳ࢧ෦ 37 ENV FLOW RESULT API ίϚϯυ γφϦΦ ϋϯζΦϯखॱ γΣϧεΫϦϓτͰੜ੒ + ΧελϜ ਓ͕هड़ ΠϯΫϧʔυ ࡞Γஔ͖ͨ͠େྔͷυΩϡϝϯτϞδϡʔϧΛ ΠϯΫϧʔυͯ͠ɺ৽نυΩϡϝϯτΛ࡞੒ ཁૉਤ
    ճ։࠵த໿ճ෼ ͓·͚ 4QIJOYͷ׆༻ྫ ࢖͍ࣺͯखॱ
38. Operation Lab ӡ༻ઃܭϥϘ ࣄྫ
    "84
    $-*ϦϑΝϨϯε 4QIJOYͷ׆༻ྫ ͓·͚
39. Operation Lab ӡ༻ઃܭϥϘ ·ͱΊ
    υΩϡϝϯτ࡞੒ 39 ͓·͚ ΠϯΫϧʔυΛલఏͱ͢Δ࣌୅΁ MarkdownܗࣜΛखͰॻ͖·͔͢? SphinxͰreSTܗࣜΛΠϯΫϧʔυ͠·͔͢? ͍͢·ͤΜɺωλͰ͢ɻ(ࢗ͞ͳ͍Ͱ)
40. Operation Lab ӡ༻ઃܭϥϘ ·ͱΊ
41. ·ͱΊ
    υΩϡϝϯτͷॏཁੑͱɺͦΕΛެ։͢Δҙຯ Operation Lab ӡ༻ઃܭϥϘ Ϗδωε&ίϛϡχέʔγϣϯͷ҆ఆԽ&ӬଓԽͷ࣮ݱ ࣗ෼ୡͷ΍͍ͬͯΔ͜ͱͷ҆ఆԽ&ӬଓԽʹඞཁ υΩϡϝϯτͷॏཁੑ υΩϡϝϯτΛެ։͢Δҙຯ
42. Operation Lab ӡ༻ઃܭϥϘ 42 IUUQXXXPQFSBUJPOMBCDPKQ OperationLab ӡ༻ઃܭ