Upgrade to Pro — share decks privately, control downloads, hide ads and more …

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

opelab
September 02, 2016

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

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

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

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

opelab

September 02, 2016
Tweet

More Decks by opelab

Other Decks in Business

Transcript

  1. ਓ͸ͳͥυΩϡϝϯτΛॻ͘ͷ͔ Operation Lab ӡ༻ઃܭϥϘ ‣ ෆಛఆଟ਺ͱͷڞ༗ ‣ ΦϐχΦϯ/δϟʔφϦζϜ ‣ ීวͳΔ΋ͷ΁

    ࣌Λ௒͑ ۭؒΛ௒͑ ۭ࣌Λ௒͑Δ ‣ ະདྷͷࣗ෼΁ͷڞ༗ ‣ උ๨ɺաڈͷূ੻ ‣ ஌ࣝɺܦݧͷ੔ཧɺ֎෦Խ(ϊʔτ) ‣ ߦҝͷఆܕԽ (खॱॻɺνΣοΫϦετ) ‣ ෳ਺ਓͰͷڞ༗ ‣ උ๨ɺաڈͷূ੻ ‣ ೝࣝͷڞ༗ɺ֬ೝ ‣ ஌ࣝͷసૹ ‣ ఆܕԽ (ઃܭɺ࣮૷ɺӡ༻)
  2. ਓ͸ͳͥυΩϡϝϯτΛॻ͘ͷ͔  ྨܕ Operation Lab ӡ༻ઃܭϥϘ ୤ଐਓԽ ٬؍Խ ੔ཧ ه࿥

    ٬؍Խ ੔ཧ ه࿥ ٬؍Խ ୤ଐਓԽ ه࿥ ੔ཧ ٬؍Խ ୤ଐਓԽ ‣ ෆಛఆଟ਺ͱͷڞ༗ ‣ ΦϐχΦϯ/δϟʔφϦζϜ ‣ ීวͳΔ΋ͷ΁ ‣ ະདྷͷࣗ෼΁ͷڞ༗ ‣ උ๨ɺաڈͷূ੻ ‣ ஌ࣝɺܦݧͷ੔ཧɺ֎෦Խ(ϊʔτ) ‣ ߦҝͷఆܕԽ (खॱॻɺνΣοΫϦετ) ‣ ෳ਺ਓͰͷڞ༗ ‣ උ๨ɺաڈͷূ੻ ‣ ೝࣝͷڞ༗ɺ֬ೝ ‣ ஌ࣝͷసૹ ‣ ఆܕԽ (ઃܭɺ࣮૷ɺӡ༻)
  3. υΩϡϝϯτ͕࣮ݱ͢Δ΋ͷ Operation Lab ӡ༻ઃܭϥϘ ୤ଐਓԽ ٬؍Խ ੔ཧ υΩϡϝϯτ ͷຊ࣭తͳجૅػೳ͸ʮه࿥ʯ͢Δ͜ͱ ه࿥

    ʮॻ͘ʯͱ͍͏࡞ۀʹΑΓʮ੔ཧʯ͞Ε͍ͯ͘ ʮ༗ܗͷ੒Ռ෺ʯͱͳΔ͜ͱͰʮ٬؍Խʯ͞Ε͍ͯ͘ ࣌ͱۭؒΛ௒͑ͯ஌ݧ͕ڞ༗͞Ε͍ͯ͘ Ϩϕϧ1 Ϩϕϧ2 Ϩϕϧ3 Ϩϕϧ4
  4. ࣄۀ΍ۀ຿ʹ͸8)͕ඞཁ Operation Lab ӡ༻ઃܭϥϘ when where who what how ͍ͭ

    (࣌ؒ) Ͳ͜Ͱ (ۭؒ) ୭͕ (ओޠɾओମ) ԿΛ (໨తޠɾ٬ମ) Ͳ͏͢Δ (ಈ࡞) ۀ຿΍ΞϓϦ ιʔείʔυ why ͳͥ (ࠜຊతͳҙਤ) ςετίʔυ ൈ͚མͪΔ
  5. υΩϡϝϯτ͕͋Ε͹ϓϩμΫτ͸࠶ݱͰ͖Δ Operation Lab ӡ༻ઃܭϥϘ when where who what how ιʔείʔυ

    why ςετίʔυ υΩϡϝϯτ ίʔυ΁ͷม׵ CodePipeline Dockerfile AWS CLI CodeCommit ElasticBeanstalk ҙਤΘ͔Δ ࠶ݱੑ & Ӭଓੑ ۀ຿΍ΞϓϦ
  6. ιʔείʔυ͔͠ແ͚Ε͹ϓϩμΫτ͸ Operation Lab ӡ༻ઃܭϥϘ when where who what how ιʔείʔυ

    why υΩϡϝϯτ ίʔυ΁ͷม׵ CodePipeline Dockerfile AWS CLI CodeCommit AMI ࣦͳΘΕΔӬଓੑ ࢖͍ํ͸? ҙਤ͸? ۀ຿΍ΞϓϦ
  7. Operation Lab ӡ༻ઃܭϥϘ ࢀߟࣗಈԽ͸ʮ໨తʯͰ͸ͳ͍ ࣗಈԽ͸ʮυΩϡϝϯτԽͷ݁ՌʯͰ͋ͬͯʮ໨తʯͰ͸ͳ͍ɻ ʮࣗ෼ୡͷ΍͍ͬͯΔ͜ͱͷ҆ఆԽӬଓԽͷͨΊʹʯ ໨త୤ଐਓԽ खஈࣗಈԽ ʮυΩϡϝϯτԽ͞Εͨۀ຿ͷҰ෦ʯΛࣗಈԽ͢Δɻ ໨తͱखஈ͕ͻͬ͘Γ͔͑Δ͜ͱ͸ɺΑ͋͘Δ͜ͱ

    • ʮࣗಈԽ͞Εͨۀ຿ʯͷอक͕ଐਓԽ͢Δɻ • ʮࣗಈԽ͞Εͨۀ຿ʯͷ࢓༷͕ෆ໌ͳͨΊɺมߋ͕Ͱ͖ͳ͍ɻ ஍ཕঢ়ଶ  • ʮࣗಈԽ͞Εͨۀ຿ʯͰτϥϒϧ͕ൃੜ͢ΔͱɺϦΧόϦͰ͖ͳ͍ɻ खॱ͕Θ͔Βͳ͍ ʮࣗಈԽ͕໨తʯʹΑΔʮ͋Δ͋Δʯ 2014೥ͷൃදࢿྉΑΓ 8IZ͕ࣦͳΘΕͨӡ༻
  8. Operation Lab ӡ༻ઃܭϥϘ ࣄྫ"84֤छυΩϡϝϯτ 26 "84͸֎෦͔ΒݟΔݶΓ υΩϡϝϯτۦಈϏδωε AWSͷυΩϡϝϯττοϓϖʔδ αϙʔτ͕ڭ͑ͯ͘ΕΔ৘ใ͸΄ͱΜͲެ։ࡁ •

    ೖ໳ΨΠυ • ։ൃऀΨΠυ • "1*ϦϑΝϨϯε • (FUUJOH4UBSUFE • 8BML5ISPVHI • ϗϫΠτϖʔύʔ • ؂ࠪϨϙʔτ ཁ/%" ϢʔβͷϏδωεͱࣗ෼ୡͷϏδωε ྆ํͷ҆ఆԽ&ؔ܎ߏங&ӬଓԽͷͨΊ
  9. Operation Lab ӡ༻ઃܭϥϘ DMPVEQBDL4FDVSJUZ8IJUF1BQFSΛྫʹ 28 ͓٬༷اۀͷ֤εςʔΫϗϧμʔΛҙࣝͨ͠ߏ੒ • DMPVEQBDLͱ͸ • Ϋϥ΢υ࣌୅ͷγεςϜ։ൃͱγεςϜӡ༻

    • ࣄۀ֓ཁͱηΩϡϦςΟ΁ͷऔΓ૊Έ • DMPVEQBDLͷηΩϡϦςΟମ੍ϙϦγʔ • ఏڙϓϥϯͱηΩϡϦςΟϚωδϝϯτ • ηΩϡϦςΟΛߋʹߴΊΔͨΊͷΦϓγϣϯαʔϏε • ֤छΨΠυϥΠϯɺ࿈བྷ૭ޱ Ψόφϯε୲౰ऀ $50 γεςϜ୲౰ऀ ϢʔβͷϏδωεͷ҆ఆԽ&ӬଓԽͷͨΊʹ Կ͕Ͱ͖Δ͔Λࣔ͢͜ͱͰɺಋೖ୲౰ऀΛࢧԉ ࣄྫ
  10. Operation Lab ӡ༻ઃܭϥϘ ϗϫΠτϖʔύʔΛͳͥ࡞Δͷ͔ 29 ࣄྫDMPVEQBDL4FDVSJUZ8IJUF1BQFSΛྫʹ ͓٬༷ ϝϯόʔ ࣗΒͷ૝͍ʹؾ෇͘ ڞ௨ೝࣝ

    αʔϏε੹೚ऀ ڞ௨ೝࣝ • ͓٬༷ʹ఻͑Δ • ϝϯόʔʹ఻͑Δ • ࣗΒͷ૝͍ʹؾ෇͘ ڞ௨ೝࣝ
  11. Operation Lab ӡ༻ઃܭϥϘ ϗϫΠτϖʔύʔʹΑΓಘΒΕΔ΋ͷ 30 ࣄྫDMPVEQBDL4FDVSJUZ8IJUF1BQFSΛྫʹ • ֎෦ ͓٬༷ ͔Βͷظ଴ͷ໌֬Խɺඪ४Խ

    • ಺෦ ϝϯόʔ ΁ͷظ଴ͷ໌֬Խɺฏ४Խ • υΩϡϝϯτॏࢹͷ࢟੎Λϒϥϯυʹ൓ө ϢʔβͷϏδωεͱࣗ෼ୡͷϏδωε ྆ํͷ҆ఆԽ&ؔ܎ߏங&ӬଓԽͷ֮ޛΛࣔ͢
  12. Operation Lab ӡ༻ઃܭϥϘ υΩϡϝϯτ࡞੒ 35 when where who what how

    γεςϜ͕هड़͢Δύʔπ why ਓ͕هड़͢Δύʔπ Doc ΠϯΫϧʔυ ͓·͚ ΠϯΫϧʔυΛલఏͱ͢Δ࣌୅΁ ࠶ར༻Λલఏ ݸผࣄ৘Λهड़
  13. ΠϯΫϧʔυΛ׆༻͢ΔυΩϡϝϯςʔγϣϯ Operation Lab ӡ༻ઃܭϥϘ • $47σʔλΛΠϯΫϧʔυͯ͠ςʔϒϧදࣔ • ιʔείʔυΛΠϯΫϧʔυͯ͠ϋΠϥΠτදࣔ • ιʔείʔυͷಛఆൣғΛΠϯΫϧʔυͯ͠දࣔ

    • ஔ׵ͷఆٛͱద༻৔ॴͷهड़ΛΠϯΫϧʔυ • υΩϡϝϯτͷύʔπΛΠϯΫϧʔυ SF45SVDUVSFE5FYUܗࣜ ͓·͚ Ұ౓ॻ͍ͨυΩϡϝϯτͷ࠶ར༻΍γεςϜͷग़ྗ Λ׆͔ͨ͠൒ࣗಈυΩϡϝϯςʔγϣϯ ଟ࠼ͳΠϯΫϧʔυػೳ
  14. Operation Lab ӡ༻ઃܭϥϘ ࣄྫ+"846($-*ઐ໳ࢧ෦ 37 ENV FLOW RESULT API ίϚϯυ

    γφϦΦ ϋϯζΦϯखॱ γΣϧεΫϦϓτͰੜ੒ + ΧελϜ ਓ͕هड़ ΠϯΫϧʔυ ࡞Γஔ͖ͨ͠େྔͷυΩϡϝϯτϞδϡʔϧΛ ΠϯΫϧʔυͯ͠ɺ৽نυΩϡϝϯτΛ࡞੒ ཁૉਤ  ճ։࠵த໿ճ෼ ͓·͚ 4QIJOYͷ׆༻ྫ ࢖͍ࣺͯखॱ