目的に沿ったDocumentation as Codeをいかにして実現していくか / PHPerKaigi 2021

by Ken’ichiro Oyama

Slide 1

Slide 1 text

খࢁ݈Ұ࿠(.01FQBCP *OD 1)1FS,BJHJ ໨తʹԊͬͨ %PDVNFOUBUJPOBT$PEFΛ ͍͔ʹ࣮ͯ͠ݱ͍͔ͯ͘͠

Slide 2

Slide 2 text

ϓϦϯγύϧΤϯδχΞ খࢁ݈Ұ࿠!L-P8 (.0ϖύϘϗεςΟϯάࣄۀ෦ϗεςΟϯάάϧʔϓ43&νʔϜ IUUQTHJUIVCDPNL-P8

Slide 3

Slide 3 text

Slide 4

Slide 4 text

No content

Slide 5

Slide 5 text

ຊൃදʹ͓͚Δ lυΩϡϝϯτzͱ͸

Slide 6

Slide 6 text

։ൃ։࢝·ͰͷΦʔόʔϔου

Slide 7

Slide 7 text

։ൃ։࢝·ͰͷΦʔόʔϔου w ։ൃऀ͕ɺ஌ࣝθϩͷঢ়ଶ͔ΒγεςϜΛཧղ͠։ൃΛ։࢝͢Δ·Ͱͷ࣌ؒ΍ίε τΛɺຊൃදͰ͸ʮ։ൃ։࢝·ͰͷΦʔόʔϔουʯͱݺͿʢʮΦϯϘʔσΟϯά ͷίετʯͱ͍ͬͨํ͕Ұൠత͔΋ʣ w ։ൃऀ͕γεςϜΛཧղ͍ͨ͠ͱ͖ w ։ൃऀ͕৽ͨʹγεςϜ։ൃʹࢀՃͨ͠ͱ͖ w ΋͘͠͸։ൃऀ͕ࣗ෼ͷ୲౰Ҏ֎ͷߏ੒ཁૉ΍ػೳΛཧղ͍ͨ͠ͱ͖ w γεςϜͰར༻͍ͯ͠Δٕज़ελοΫʹे෼ͳ஌ݟ͕͋ͬͨͱͯ͠΋ɺ࣮͸։ൃ։ ࢝·Ͱʹ͸खؒͱ͕͔͔࣌ؒΔ

Slide 8

Slide 8 text

։ൃ։࢝·ͰͷΦʔόʔϔου w ৽ن։ൃͷ৔߹ɺ࣮ࡍʹ։ൃΛ։࢝ ͢Δ·Ͱʹࠨਤʹ͋ΔΑ͏ͳෳ਺ͷ ϨΠϠʔʹ͍ͭͯݕ౼Λ͢Δ w ๨ΕΒΕ͕͕ͪͩɺ్த͔Β։ൃʹ +0*/͢Δ৔߹΋ɺ৽ن։ൃ࣌ͱಉ͡ ਺ͷϨΠϠʔͷཧղ͕ඞཁʹͳΔ w ҧ͏ͷ͸ʮ͢Ͱʹ͋Δ΋ͷΛཧղ ͢Δඞཁ͕͋Δʯͱ͍͏͜ͱ͚ͩ IUUQTTQFBLFSEFDLDPNLMPXQIQFSLBJHJʹमਖ਼ΛՃ͑ͨ΋ͷ ͲͷΑ͏ͳαʔϏε͔ ͲͷΑ͏ͳΞʔΩςΫνϟ͔ ͲͷΑ͏ʹσʔλΛอ࣋͢Δ͔ ʢʹͲͷΑ͏ͳςʔϒϧઃܭ͔ʣ ͲͷΑ͏ͳ։ൃ؀ڥ͔ ʢຊ൪؀ڥɾ։ൃ؀ڥʣ ͲͷΑ͏ͳίʔυ͔ ։ൃ αʔϏεཧղϨΠϠʔ ΞʔΩςΫνϟཧղϨΠϠʔ σʔλετΞཧղϨΠϠʔ ։ൃ؀ڥཧղϨΠϠʔ ίʔυཧղϨΠϠʔ

Slide 9

Slide 9 text

։ൃ։࢝·ͰͷΦʔόʔϔουͷ࡟ݮ w ʮ։ൃ։࢝·ͰͷΦʔόʔϔουʯʹ͍ͭͯ͸1)1FS,BJHJʹͯൃද w ຊൃද͸ͦͷଓ͖ͱ͍͑Δ IUUQTTQFBLFSEFDLDPNLMPXQIQFSLBJHJ

Slide 10

Slide 10 text

։ൃऀ͕γεςϜΛཧղ͢Δ

Slide 11

Slide 11 text

γεςϜҎ֎ʹԿ΋ͳ͍ঢ়ଶ w ৽͍͠։ൃऀ͸γεςϜΛݟͯཧղΛ͢Δඞཁ͕͋Δ w ։ൃ։࢝·ͰͷΦʔόʔϔου͕େ͖͍ঢ়ଶ

Slide 12

Slide 12 text

υΩϡϝϯτͰཧղΛॿ͚Δ w γεςϜͷཧղΛॿ͚ΔͨΊυΩϡϝϯτΛॻ͘ w ৽͍͠։ൃऀ͸υΩϡϝϯτΛ௨ͯ͡γεςϜͷཧղΛਐΊΔ͜ͱ͕Ͱ͖Δ

Slide 13

Slide 13 text

ຊൃදʹ͓͚ΔzυΩϡϝϯτ w υΩϡϝϯτΛӡ༻͢Δ໨త ˠ։ൃ։࢝·ͰͷΦʔόʔϔουΛ࡟ݮ͢ΔͨΊ w࡟ݮ͢ΔͨΊʹ͸γεςϜͷཧղΛॿ͚Δ͜ͱ͕Ͱ͖ͳ͍ͱ͍͚ͳ͍ w υΩϡϝϯτ͸͍ͭଘࡏ͢Δ΂͖͔ ˠཧղͯ͠΋Β͍͍ͨγεςϜ͕ଘࡏ͍ͯ͠Δͱ͖ wܧଓతʹؒҧ͍ͷͳ͍े෼ͳυΩϡϝϯτ͕ଘࡏ͠ଓ͚Δඞཁ͕͋Δ w˞৽ن։ൃલͷʢઃܭͳͲͷʣυΩϡϝϯτ͸ຊൃදͷείʔϓ͔Β֎͢ ʮܧଓతʹʯʮγεςϜͷཧղΛॿ͚ΔʯυΩϡϝϯτ͕ඞཁ

Slide 14

Slide 14 text

ܧଓతυΩϡϝϯςʔγϣϯ

Slide 15

Slide 15 text

γεςϜͱυΩϡϝϯτͷဃ཭

Slide 16

Slide 16 text

γεςϜͱυΩϡϝϯτͷဃ཭ w γεςϜͱυΩϡϝϯτͱͷؒʹ಺༰ͷဃ཭͕ൃੜ͍ͯ͠Δ৔߹͕͋Δ w ʮॻ͍ͯ͋Δ͜ͱ͕ؒҧ͍ͬͯΔʯঢ়ଶʢ৔߹ʹΑͬͯ͸ʮॻ͍ͯ͋Δ͜ͱ͕଍Γͳ͍ʯ΋ʣ w ߃ৗతʹ಺༰ʹ͕ࠩग़͍ͯΔঢ়ଶ w ߋ৽λΠϛϯά͕ͣΕΔ͜ͱͰγεςϜͱυΩϡϝϯτͷ಺༰ʹ͕ࠩग़͍ͯΔঢ়ଶ

Slide 17

Slide 17 text

γεςϜͱυΩϡϝϯτͷဃ཭͕͋Δͱ w γεςϜͱͷဃ཭͕͋ΔυΩϡϝϯτͰγεςϜΛཧղ͢ΔͱɺؒҧͬͨཧղͰ։ൃʹ ೖͬͯ͠·͏ w ࣮͸ؔ࿈͕૿͍͑ͯͯؾܰʹ੾Γ཭ͤͳ͘ͳ͍ͬͯͨΠϯελϯε w ࣮͸ߟྀ͠ͳ͍ͱ͍͚ͳ͍͜ͱ͕มΘ͍ܾͬͯͨࡁػೳ w ࣮͸૿͍͑ͯͨόον w ։ൃऀ͕ͦͷဃ཭ʹؾͮ͘ͷ͕஗͚Ε͹஗͍΄Ͳ։ൃʹ͓͚ΔϚΠφε͕େ͖͘ͳΔ w γεςϜཧղͷ΍Γͳ͓͠🔥 w ίʔυͷॻ͖௚͠🔥🔥 w ؒҧͬͨཧղͷ··ϦϦʔεɺޙʹো֐🔥🔥🔥🔥🔥🔥

Slide 18

Slide 18 text

γεςϜͱυΩϡϝϯτͷؔ܎ w υΩϡϝϯτʹ͸ର৅ͷγεςϜʹ͍ͭͯॻ͔Ε͍ͯΔ w ˠγεςϜͱυΩϡϝϯτͷ֤ཁૉʹ͸ରԠؔ܎͕͋Δ w ˠγεςϜΛߏ੒͢ΔཁૉΛݩͱ͢Δू߹4ͱυΩϡϝϯτΛߏ੒͢ΔཁૉΛݩͱ͢ Δू߹%͕͋Δͱ͖ɺू߹%ͷ֤ݩ͸ඞͣू߹4ͷ͍ͣΕ͔ͷݩͱରԠ͢Δ % 4

Slide 19

Slide 19 text

γεςϜͱυΩϡϝϯτͷؔ܎ w ʮγεςϜͱυΩϡϝϯτͷဃ཭͕େ͖͘ͳΔʯͱ͸ҎԼͷঢ়ଶʹ͋Δݩͷ਺͕େ͖͘ͳΔ͜ͱ w ू߹%ͷ͋Δݩ͕ू߹4ͷݩҎ֎ͷཁૉͱରԠ͍ͯ͠Δʹؒҧ͍͕ॻ͔Ε͍ͯΔ w ू߹4ͷ͋ΔݩʹରԠ͚ͭΒΕΔू߹%ͷݩ͕ଘࡏ͠ͳ͍ʹυΩϡϝϯτ͕ෆ଍ ˞ରԠ͢Δݩ͕ଘࡏ͠ͳ͍͜ͱ͕ඞͣ͠΋ѱ͍Θ͚Ͱ͸ͳ͘ɺͦͷ਺͕࣌ؒͷܦաͱͱ΋ʹ਺͕େ͖͘ͳΔ͜ͱ͕໰୊ % 4

Slide 20

Slide 20 text

γεςϜͱυΩϡϝϯτͷဃ཭Λখ͘͢͞Δʹ͸ γεςϜͱυΩϡϝϯτͷဃ཭Λখ͘͢͞ΔͨΊʹ͸ɺ·ͣɺγεςϜͱυΩϡϝϯ τͷဃ཭Λ൑அͰ͖Δ࢓૊Έ͕ඞཁ wγεςϜͱυΩϡϝϯτͷରԠؔ܎Λද͢Ұछͷؔ਺͕ඞཁ ͦͯ͠ɺဃ཭͕͋ΔظؒΛͰ͖Δ͚ͩখ͘͢͞ΔͨΊʹ wܧଓతʹ wͰ͖Δ͚ͩγεςϜͷߋ৽ʹ͍ۙλΠϛϯάͰ υΩϡϝϯτΛγεςϜʹ߹Θͤͯߋ৽͠ଓ͚Δ͜ͱ͕ඞཁ

Slide 21

Slide 21 text

%PDVNFOUBUJPOBT$PEF

Slide 22

Slide 22 text

%PDVNFOUBUJPOBT$PEF %PDTBT$PEF SFGFSTUPBQIJMPTPQIZUIBUZPV TIPVMECFXSJUJOHEPDVNFOUBUJPOXJUIUIFTBNFUPPMTBTDPEF *TTVF5SBDLFST 7FSTJPO$POUSPM (JU 1MBJO5FYU.BSLVQ .BSLEPXO SF4USVDUVSFE5FYU "TDJJEPD $PEF3FWJFXT "VUPNBUFE5FTUT 5IJTNFBOTGPMMPXJOHUIFTBNFXPSLqPXTBTEFWFMPQNFOUUFBNT BOE CFJOHJOUFHSBUFEJOUIFQSPEVDUUFBN*UFOBCMFTBDVMUVSFXIFSFXSJUFST BOEEFWFMPQFSTCPUIGFFMPXOFSTIJQPGEPDVNFOUBUJPO BOEXPSL UPHFUIFSUPNBLFJUBTHPPEBTQPTTJCMF IUUQTXXXXSJUFUIFEPDTPSHHVJEFEPDTBTDPEFɹΑΓൈਮɹ

Slide 23

Slide 23 text

%PDVNFOUBUJPOBT$PEF w γεςϜͷ։ൃͷۙ͘ʹυΩϡϝϯτ࡞੒ͷ࢓૊ΈΛஔ͘͜ͱͰɺ։ൃαΠΫϧͷ தʹυΩϡϝϯτ࡞੒Λ౷߹͠ɺγεςϜͱυΩϡϝϯτͷဃ཭Λখ͘͞͠Α͏ͱ ͍ͯ͠Δ͜ͱ͕Θ͔Δ w ͨͩɺจԽతͳ࢓૊ΈͰ͋ͬͯɺγεςϜͱυΩϡϝϯτͷରԠؔ܎Λදؔ͢਺ ͸ͳ͍ɻ w ·ͣɺ͜ͷʮ%PDVNFOUBUJPOBT$PEFʯ͔Β΋͏গ͠ʮγεςϜͱυΩϡϝϯτ ͷରԠؔ܎ʹண໨ͯ͠ဃ཭Λͳ͘͢ʯ͜ͱʹ౿ΈࠐΜͩΞϓϩʔνʹ͍ͭͯߟ͑ͯ ͍͘

Slide 24

Slide 24 text

ϞσϧԽ ొ৔͢Δཁૉͱͯͭ͠ ։ൃऀ γεςϜʜ։ൃऀ͕։ൃ΍ઃఆΛ͢Δର৅ɻίʔυɺΞϓϦέʔγϣϯɺσʔλ ϕʔεɺΠϯϑϥͳͲɻγεςϜࣗମ͸ߏ଄Խ͞Ε͍ͯΔʢ΋ͷΛର৅ͱ͢Δʣ υΩϡϝϯτ ߏ଄Խσʔλʜʮ:".-ʯ΍ʮϓϩάϥϜίʔυͷ"45ʯͳͲɻ ٯʹɺʮγεςϜʹର͢Δ։ൃऀͷཧղɾΠϝʔδʯ͸ෆఆܗͰ։ൃऀͦΕͧΕ ͕಄ͷதͰ͍࣋ͬͯΔ͚ͩͳͷͰߏ଄Խ͸͞Ε͍ͯΔͱ͸ݴ͑ͳ͍ ιϑτ΢ΣΞʜԿ͔͠ΒͷॲཧΛߦ͏ϓϩάϥϜɻߏ଄ԽσʔλΛೖग़ྗͱ͠ ΍͍͢ͱ͍͏ಛ௃Λ࣋ͭ

Slide 25

Slide 25 text

ʮͨͩυΩϡϝϯτΛॻ͘ʯ w ʮͨͩυΩϡϝϯτΛॻ͘ʯͱ w γεςϜ͕ߋ৽͞Εͨͱ͖ʹɺυΩϡϝϯτͷͲ͜Λߋ৽͢Ε͹ྑ͍ͷ͔͕Θ͔Γ ʹ͍͘ ˠγεςϜͱυΩϡϝϯτͷରԠؔ܎Λදؔ͢਺͕ͳ͍

Slide 26

Slide 26 text

γεςϜͱυΩϡϝϯτͷဃ཭Λͳ͘͢Ξϓϩʔν

Slide 27

Slide 27 text

γεςϜ͔Βߏ଄ԽσʔλΛநग़ͯ͠ υΩϡϝϯτੜ੒Λ͢Δ

Slide 28

Slide 28 text

γεςϜ͔Βߏ଄ԽσʔλΛநग़͢Δ w +BWBEPDɺHPEPDɺ1)1%PDFUD w γεςϜ͔ΒυΩϡϝϯτΛੜ੒͢Δ͜ ͱͰɺγεςϜͱυΩϡϝϯτͷဃ཭Λ ͳͦ͘͏ͱ͍ͯ͠Δ υΩϡϝϯτ ߏ଄Խσʔλ γεςϜ

Slide 29

Slide 29 text

ຊൃදʹ͓͚ΔʮΞϊςʔγϣϯʯ wຊൃදʹ͓͚ΔʮΞϊςʔγϣϯʯͱ͸ɺʮγεςϜʹର͢Δ։ൃऀͷཧղɾΠϝʔ δΛߏ଄Խσʔλʹϝλ৘ใͱͯ͠௥Ճ͢Δʯͱ͍͏ҙຯ w 1)1%PDͳͲͰ͸ɺίϝϯτΛιʔείʔυʹ wιʔείʔυͷʮߏ଄ʹԊͬͨܗͰʯ w͔ͭʮܾΊΒΕͨϑΥʔϚοτʹैͬͯʯ ௥Ճ͢Δ͜ͱͰɺॳΊͯ࠷ऴతͳυΩϡϝϯτʹ൓ө͞ΕΔˠΞϊςʔγϣϯ ্هҎ֎ͷίϝϯτ͸υΩϡϝϯτ͔Β͸ແࢹ͞ΕΔˠΞϊςʔγϣϯͰ͸ͳ͍

Slide 30

Slide 30 text

γεςϜ͔Βߏ଄ԽσʔλΛநग़͢Δ w ߏ଄ԽσʔλʢιʔείʔυʣʹܾΊΒ ΕͨϑΥʔϚοτͰʢυοΫίϝϯτ ΛʣΞϊςʔγϣϯ͍ͯ͠Δ͚ͩͳͷͰ ߏ଄Խσʔλͷཁૉ਺΍υΩϡϝϯτ΍ γεςϜͱͷରԠؔ܎͸ͦͷ·· υΩϡϝϯτ ߏ଄Խσʔλ γεςϜ

Slide 31

Slide 31 text

ߏ଄Խσʔλ͔ΒγεςϜͱυΩϡϝϯτͷ ྆ํΛੜ੒͢Δ

Slide 32

Slide 32 text

ߏ଄Խσʔλ͔ΒγεςϜͱυΩϡϝϯτͷ྆ํΛੜ੒͢Δ w 0QFO"1* w ੜ੒ݩσʔλΛͭʹ͢Δ͜ͱͰγες ϜͱυΩϡϝϯτͷဃ཭Λͳͦ͘͏ͱ͠ ͍ͯΔ υΩϡϝϯτ ߏ଄Խσʔλ γεςϜ

Slide 33

Slide 33 text

ͭͷΞϓϩʔνͷڞ௨఺ w ͭͷྫͷڞ௨఺ͱͯ͠ɺγεςϜͱυΩϡϝϯτͷؒʹߏ଄ԽσʔλΛհͨؔ͠ ࿈Λ͍࣋ͬͯΔ͜ͱ͕Θ͔Δɻ w γεςϜͱυΩϡϝϯτͷରԠؔ܎Λදؔ͢਺Λ͍࣋ͬͯΔͱ͍͏͜ͱʹͳΔ

Slide 34

Slide 34 text

*OGSBTUSVDUVSFBT$PEF w ྫ͑͹ɺ5FSSBGPSNΛಉ༷ͷϞσϧͰද͢ɻͱɺࣗͣͱυΩϡϝϯςʔγϣϯͷ࢓ ૊ΈΛೖΕΔ΂͖Օॴ͕Θ͔Δ

Slide 35

Slide 35 text

*OGSBTUSVDUVSFBT$PEF%PDVNFOUBUJPO w ͦͯ͠طʹ͜ͷϞσϧΛ࣮ݱͨ͠υΩϡϝϯςʔγϣϯπʔϧ͸͋Δ w IUUQTHJUIVCDPNUFSSBGPSNEPDTUFSSBGPSNEPDT

Slide 36

Slide 36 text

(.0ϖύϘʹ͓͚Δ ܧଓతυΩϡϝϯςʔγϣϯ

Slide 37

Slide 37 text

σʔλϕʔεεΩʔϚͷ υΩϡϝϯςʔγϣϯ

Slide 38

Slide 38 text

Slide 39

Slide 39 text

UCMT w $*ϑϨϯυϦͳσʔλϕʔευΩϡϝϯτੜ੒πʔϧ w IUUQTHJUIVCDPNL-P8UCMT w 1PTUHSF42- .Z42-ͳͲͷ3%#.4͚ͩͰͳ͘ɺ #JH2VFSZ΍"NB[PO%ZOBNP%# $MPVE4QBOOFS ͱ͍ͬͨσʔλιʔεʹ΋ରԠ w υΩϡϝϯτΛॆ࣮ͤ͞Δػೳͱͯ͠ϝλσʔλΛ Ξϊςʔγϣϯ͢Δ͜ͱ͕Մೳ w ςʔϒϧɺΧϥϜͳͲͷίϝϯτ෇༩͚ͩͰͳ͘ λάɺϦϨʔγϣϯͳͲ

Slide 40

Slide 40 text

UCMT w ैདྷ͸σʔλϕʔεͱυΩϡϝϯτ͸ผ Ͱ؅ཧ w $*্Ͱςετ༻σʔλϕʔε͔Β௚઀ ςʔϒϧఆٛΛߏ଄Խσʔλͱͯ͠ந ग़ɻͦΕʹ௥ՃͰςʔϒϧίϝϯτ΍Χ ϥϜίϝϯτΛΞϊςʔγϣϯ͠ɺυ ΩϡϝϯτΛੜ੒

Slide 41

Slide 41 text

ίϚϯυͷ υΩϡϝϯςʔγϣϯ

Slide 42

Slide 42 text

GSHN

Slide 43

Slide 43 text

GSHN w ϝλͳεχϖοτϚωʔδϟ w IUUQTHJUIVCDPNL-P8GSHN w ϝλʜ"MGSFE΍QFUͳͲɺଞͷεχϖο τϚωʔδϟͷϑΝΠϧܗࣜΛΠϯϙʔ τΤΫεϙʔτͰ͖Δ w QFDP΍G[GͳͲͱ࿈ܞͯ͠୯ମͷίϚϯ υิ׬πʔϧͱͯ͠ಈ͔͢͜ͱ΋Մೳ

Slide 44

Slide 44 text

GSHN wʮଞͷεχϖοτϚωʔδϟͷϑΝΠϧܗࣜʹΤΫεϙʔτͰ͖Δʯ ʮ։ൃऀ͸ࣗ෼ͷ޷͖ͳεχϖοτϚωʔδϟΛ࢖͏͜ͱ͕Ͱ͖Δʯ w νʔϜͰڞ༗͍ͨ͠ศརίϚϯυΛ·ͱΊΔํ๏ͱͯ͠ʮͨͩͷศརίϚϯυू ϖʔδʯΛ࡞ΔΑΓ΋ศརʢΈΜͳ࢖͍͍ͨεχϖοτϚωʔδϟ͸ҧ͏ʣ

Slide 45

Slide 45 text

GSHNʹΑΔεχϖοτͷϥΠϑαΠΫϧ GSHNܗࣜͷεχϖοτϑΝΠϧΛอଘ͢ΔεχϖοτϦϙδτϦΛ࡞੒ εχϖοτϦϙδτϦ͔ΒεχϖοτϑΟΠϧΛऔಘʢෳ਺ϦϙδτϦਪ঑ʣ ޷͖ͳεχϖοτϚωʔδϟͷεχϖοτϑΝΠϧܗࣜʹ·ͱΊͯΤΫεϙʔτ εχϖοτϦϙδτϦͷߋ৽ΛશͯऔಘˠΛ࣮ߦ frgm repo add https://github.com/k1LoW/my-snippets.git frgm repo add https://github.com/org/team-snippets.git … frgm export --to ~/Library/Application Support/Alfred/Alfred.alfredpreferences/snippets \ --format Alfred frgm repo pull

Slide 46

Slide 46 text

GSHNʹΑΔυΩϡϝϯςʔγϣϯ w ͞ΒʹɺGSHN͸ίϚϯυͷυΩϡϝϯτ ͷੜ੒͕Մೳ w GSHNͷϑΝΠϧܗࣜʹ͸EFTD΍ MBCFMTͳͲɺίϚϯυʹΞϊςʔγϣϯ Λ෇༩͓ͯ͘͠৔ॴ͕͋Δ frgm export --to /path/to --format md

Slide 47

Slide 47 text

GSHNʹΑΔυΩϡϝϯςʔγϣϯ w νʔϜ΍ݸਓɺαʔϏε༻ͷεχϖοτ ϦϙδτϦΛ࡞੒ͯ͠εχϖοτΛ௥Ճ ͍ͯ͘͠ w ಉ࣌ʹ$*ͰυΩϡϝϯτΛࣗಈੜ੒ w ʮߏ଄Խσʔλ͔ΒεχϖοτͱυΩϡ ϝϯτͷ྆ํΛੜ੒͢ΔʯͷͰίϚϯυ ͱυΩϡϝϯτͷဃ཭͕ͳ͍

Slide 48

Slide 48 text

ܧଓతυΩϡϝϯςʔγϣϯ w ʮܧଓతʹɺؒҧ͍ͷͳ͍े෼ͳυΩϡϝϯτΛଘࡏ͠ଓ͚ͤ͞Δʯͱ͸ʮγε ςϜ͕มԽͯ͠΋γεςϜͱυΩϡϝϯτͷဃ཭Λେ͖͘͠ͳ͍ʯͱ͍͏͜ͱ w ͦͷͨΊʹ͸ɺγεςϜͱυΩϡϝϯτੜ੒Λؔ࿈ͤ͞ɺγεςϜͷมԽ͕υ Ωϡϝϯτʹ൓ө͞ΕΔ࢓૊ΈΛ࣋ͭ͜ͱ͕๬·͍͠ w ·ͨɺγεςϜࣗମ͕ߏ଄ԽσʔλͰ͋Δ͜ͱʹண໨্͠هͷ࢓૊ΈΛιϑτ ΢ΣΞʹΑΓࣗಈԽɺ͞Βʹ$*ͷ࢓૊ΈʹࡌͤΔ͜ͱͰɺγεςϜͱυΩϡϝϯ τͷဃ཭ΛݶΓͳ͘খ͘͞อͭ͜ͱ͕ՄೳʹͳΔ

Slide 49

Slide 49 text

γεςϜͷཧղΛॿ͚Δ υΩϡϝϯςʔγϣϯ

Slide 50

Slide 50 text

ࣗ෼ͷܦݧ͔Βߟ͑ΔγεςϜͷཧղͷྲྀΕ w γεςϜશମͷΠϯϑϥߏ੒ਤ΍Ϋϥεਤ΍ςʔϒϧઃܭॻΛ౉͞Εͯɺ͔ͦ͜Β શମΛཧղͯ͠։ൃ։࢝Λ͢Δͷ͸࣮͸೉͍͠ w ҰํͰɺʮ։ൃऀ͕։ൃΛ։࢝͢ΔʹԿ͔͠Βमਖ਼΍τϥϒϧγϡʔτΛ։࢝͢ ΔʯͨΊʹඞཁͳγεςϜͷཧղ͸ʮશମͰ͸ͳ͍ʯͱ͍͏ͷ΋ࣄ࣮ w ͋ΔҰఆن໛Ҏ্ͷγεςϜͷશମͷཧղ͸ɺػೳ୯ҐͩͬͨΓը໘୯ҐͩͬͨΓ ϩʔϧ୯ҐͩͬͨΓɺʮطଘͷ։ൃऀʹΑͬͯάϧʔϐϯά͞Εͯఏڙ͞Εͨʯγ εςϜͷҰ෦෼ͷ৘ใͷཧղΛੵΈॏͶͨ݁ՌͰ͋Δ͜ͱ͕ܦݧଇͱͯ͋͠Δ Έͳ͞Μ͸Ͳ͏Ͱ͠ΐ͏͔ʁ

Slide 51

Slide 51 text

υΩϡϝϯτʹىͦ͜͏ͱ͍ͯ͠Δ΋ͷϓϩδΣΫτ΍։ൃγεςϜͷશମ ૾͸ɺ۩ମతʹܗ͕͋Δ΋ͷͰ͸ͳ͘ɺͦΕͧΕͷ಄ͷதʹෆఆܗͳΠϝʔδͱ ͯ͠ଊ͑ΒΕ͍ͯΔͱࢥ͍·͢ɻ ෆఆܗͳΠϝʔδͷೝࣝΛ߹ΘͤΔͨΊʹࢲ͕ߟ͍͑ͯΔ͜ͱɺͦΕ͸ྠ੾Γʹ ͢Δ͜ͱͰ͢ɻ ྠ੾Γʹ͢Δͱ͖ʹ੾ͬͨ໘͕அ໘͕Ͱ͖ΔΘ͚Ͱ͕͢ɺ͜ͷஅ໘ΛੵΈॏͶͯ ͍͘ͱཱମͱͳΓɺશମ૾͕ݱΕ·͢ɻ ෆఆܗͳΠϝʔδΛڞ༗͢Δ͜ͱ͸೉͍͠ͱࢥ͍·͕͢ɺࣗ෼ͳΓʹஅ໘Λෳ਺ ࡞ΓɺͦΕΛੵΈॏͶ͍͚ͯ͹ࣗ෼ͳΓͷཱମΛཧղͯ͠΋Β͏͜ͱ͕Ͱ͖Δ͸ ͣͩͱߟ͑·͢ɻ ʮϚωδϝϯτۀΛ௨ͯ͡ߟ͑ͨɺϓϩδΣΫτશମ૾ͷೝࣝᴥᴪΛ๷͙ޡղ͞Εͳ͍υΩϡϝϯτ࡞੒ज़"/%1"%5FDI#MPHʯ IUUQTUFDIBOEQBEDPKQFOUSZΑΓൈਮɹ

Slide 52

Slide 52 text

Slide 53

Slide 53 text

ιϑτ΢ΣΞΞʔΩςΫνϟͷଟ͘ͷஶऀ͕ɺͨͬͨͭͷϞσϧΛ࢖ͬͯιϑτ ΢ΣΞΞʔΩςΫνϟΛهड़͢Δ͜ͱ͸શ͘ෆՄೳͩͱࢦఠ͍ͯ͠ΔɻͦͷΑ͏ͳ Ϟσϧ͸ɺཧղ͠ʹ্͍͘ɺΞʔΩςΫνϟͰ࠷΋ॏཁͳػೳΛ໌֬ʹಛఆͰ͖Δ ݟࠐΈ͸΄ͱΜͲͳ͍ɻʢதུʣ ϏϡʔʢWJFXʣͱ͸ɺҰਓҎ্ͷεςʔΫϗϧμ๊͕͍͍ͯΔͭ·ͨ͸ͦΕҎ্ ͷؔ৺ࣄʹɺΞʔΩςΫνϟ͕Ͳ͏ରԠ͢Δ͔Λࣔ͢ɺΞʔΩςΫνϟͷͭҎ্ͷ ߏ଄తଆ໘Λදݱͨ͠΋ͷͰ͋Δɻ ʮؔ৺ࣄʹ߹ΘͤͯΞʔΩςΫνϟΛͭҎ্ͷଆ໘ʢ੾ΓޱʣͰදݱ͢Δʯ ͜ͷߟ͑ํ͸ઃܭ͚ͩͰͳ͘υΩϡϝϯςʔγϣϯʹ΋౰ͯ͸ΊΔ͜ͱ͕Ͱ͖Δ χοΫɾϩβϯεΩ Φ΢Σϯɾ΢οζιϑτ΢ΣΞγεςϜΞʔΩςΫνϟߏஙͷݪཧୈ൛ +BQBOFTF&EJUJPO ΑΓൈਮɹ

Slide 54

Slide 54 text

γεςϜΛෳ਺ͷ੾ΓޱͰυΩϡϝϯτԽ͢Δ w γεςϜʹର͢Δؔ৺ࣄʹ߹ΘͤͯඞཁͳγεςϜͷཁૉ͚ͩΛ·ͱΊͯʮϏϡʔʯͱ͠ υΩϡϝϯτԽ͢ΔʢʮϢʔβ͔Βͷ)551ϦΫΤετʯʮϚΠΫϩαʔϏε୯ҐʯͳͲʣ w ؔ৺ࣄʜγεςϜΛཧղ͢Δ্Ͱҙຯͷ͋Δάϧʔϐϯά % 4 % %

Slide 55

Slide 55 text

(.0ϖύϘʹ͓͚Δ γεςϜͷཧղΛॿ͚ΔυΩϡϝϯςʔγϣϯ

Slide 56

Slide 56 text

OEJBH

Slide 57

Slide 57 text

OEJBH --- name: 3-Tier Architecture docPath: ../output Views: - name: overview layers: ["consul", "vip_group"] - name: http-lb layers: ["vip_group"] labels: ["http"] nodes: - name: lb-* components: - nginx?icon=lb-l7 clusters: - 'consul:dc1' - 'vip_group:lb' - name: app-* components: - nginx?icon=proxy - Rails?icon=cube4 clusters: - 'consul:dc1' - name: db-* components: - PostgreSQL?icon=db clusters: - 'consul:dc1' networks: - labels: - http route:

Slide 58

Slide 58 text

OEJBH w IUUQTHJUIVCDPNL-P8OEJBH w ʮΤψσΟΞάʯʮΤψμΠΞάʯͲͪΒͰ΋ ndiag doc -c ndiag.yml w ੜ੒͞ΕΔυΩϡϝϯτ͸(JU)VCʹίϛοτͯ͠8FC্͔ΒӾཡ͞ΕΔ͜ͱ૝ఆ w ओʹΠϯϑϥͷϋΠϨϕϧΞʔΩςΫνϟͷυΩϡϝϯτΛੜ੒͢Δ໨తͰ։ൃ w :".-͔Βʮߏ੒ਤΛੜ੒͢ΔʯͰ΋ʮυΩϡϝϯτΛੜ੒͢ΔʯͰ΋ͳ͘ ʮෳ਺ͷ੾ΓޱͰʯʮߏ੒ਤΛؚΉʯʮυΩϡϝϯτͷ਽ܗΛ࡞Δʯ ͱ͍͏ಛ௃Λ࣋ͭ

Slide 59

Slide 59 text

ʮෳ਺ͷ੾ΓޱͰʯ w ୯७ʹෳ਺ͷυΩϡϝϯτΛ࡞੒ͯ͠͠·͏ͱɺγεςϜͱυΩϡϝϯτͱͷରԠ ؔ܎͕ؔ਺ͰදݱͰ͖ͣɺγεςϜͱυΩϡϝϯτͷဃ཭͕ൃੜ͢Δ w ͦͷͨΊɺOEJBHͰ͸ҎԼͷΞϓϩʔνͰγεςϜͱυΩϡϝϯτͷߏ଄Խσʔλ Λհͨؔ͠܎ੑ͕੾Εͳ͍Α͏ʹ͍ͯ͠Δ w γεςϜΛදݱ͢Δͭͷߏ଄Խσʔλ͔Β੾ΓޱͷҟͳΔෳ਺ͷߏ଄ԽσʔλΛ ϧʔϧʹԊͬͯੜ੒͠ɺͦΕΒ͔ΒͦΕͧΕਤͱυΩϡϝϯτΛੜ੒͢Δ w ߏ଄ԽσʔλͱγεςϜͱΛൺֱݕূͰ͖Δ࢓૊ΈΛఏڙ͢Δ

Slide 60

Slide 60 text

OEJBHͷϞσϧ

Slide 61

Slide 61 text

ʮߏ੒ਤΛؚΉʯ w ΠϯϑϥͷΞʔΩςΫνϟΛཧղ͢ΔͨΊͷ υΩϡϝϯτΛੜ੒͢Δʹ౰ͨͬͯਤ͸ॏཁ ͳཁૉɻੜ੒͞ΕΔਤͷݟ΍͢͞΋ॏཁ w ͦͷͨΊOEJBH͸ਤʹ࢖༻Ͱ͖ΔΞΠίϯ΋ ͍Ζ͍Ζબ୒Ͱ͖Δ w ૊ΈࠐΈΞΠίϯϑϨʔϜϫʔΫ w ೚ҙͷը૾ʢQOHTWHʣ w ,T"84($1)BTIJDPSQ͕ఏڙ͍ͯ͠ ΔΞΠίϯηοτΛऔಘ͢ΔίϚϯυ

Slide 62

Slide 62 text

ʮυΩϡϝϯτͷ਽ܗΛ࡞Δʯ w υΩϡϝϯτͷੜ੒ݩ͸ߏ଄ԽσʔλͰ͋Δ΄͏͕γεςϜͱͷဃ཭Λখ͘͞͠΍ ͘͢Ͱ͖Δͱ͍͏ͷ͸ຊൃදͰड़΂ͨͱ͓Γɻ w OEJBH΋Πϯϑϥͷ֤ཁૉͷઆ໌จষ௥Ճ͸ʮΞϊςʔγϣϯʯͷܗͰ࣮ݱɻ w ͭ·ΓOEJBH͸ߏ଄Խσʔλ͔ΒυΩϡϝϯτΛੜ੒͢Δ w ͔͠͠ɺઆ໌จষ͸ςʔϒϧίϝϯτͱ͸ҟͳΓ௕จʹͳΔ͜ͱ͕༧૝͞ΕͨͷͰ ҎԼͷํࣜΛ࠾༻ ·ͣOEJBHଆͰઆ໌จষهड़ઐ༻ͷϑΝΠϧΛॴఆͷҐஔʹੜ੒ ։ൃऀ͸ͦͷઐ༻ϑΝΠϧʹઆ໌จষΛهड़ OEJBH͸υΩϡϝϯτੜ੒࣌ʹઐ༻ϑΝΠϧͷ಺༰ΛऔΓࠐΉ

Slide 63

Slide 63 text

υΩϡϝϯτͷΧόϨοδ w UCMT΋OEJBH΋υΩϡϝϯτ͸ʮ݀ຒΊʯͷঢ়ଶʹ·Ͱ͍͚͍࣋ͬͯͯΔ w υΩϡϝϯτͷΧόϨοδܭଌ͕ՄೳˠͦΕͧΕΧόϨοδܭଌػೳΛ࣋ͭ ndiag coverage Elements Coverage All Elements 21% (53/252) Views 66.7% (2/3) Nodes 100% (36/36) Components 15.4% (18/117) Relations 0% (0/67) Layers 100% (7/7) Labels 28.6% (6/21)

Slide 64

Slide 64 text

(.0ϖύϘʹ͓͚ΔOEJBHಋೖঢ়گ w ϖύϘ͕ӡ༻͍ͯ͠Δෳ਺ͷαʔϏεͷ͏ͪͷҰ෦ͰΞʔΩςΫνϟυΩϡϝϯτ Λ࡞੒͢Δͷʹར༻ w ͔ͦ͜Β༷ʑͳϑΟʔυόοΫΛ΋Βͬͯػೳ௥ՃΛ͍ͯ͠Δ w ࣾ಺Ͱ͸࣌ؒఔ౓ͷϋϯζΦϯΛ։࠵࣮͠ࡍʹಈ͔ͯ͠΋Βͬͯཧղͯ͠΋Βͬ ͍ͯΔ

Slide 65

Slide 65 text

γεςϜͷཧղΛॿ͚ΔυΩϡϝϯςʔγϣϯ w γεςϜશମΛදͭ͢ͷυΩϡϝϯτͰγεςϜΛཧղ͢Δͷ͸೉͍͠ w γεςϜશମΛද͢ͷͰ͸ͳ͘ɺγεςϜͷཧղʹҙຯͷ͋ΔάϧʔϐϯάΛͯ͠ ͦΕͧΕυΩϡϝϯτԽ͢Δ w ͦΕͧΕͷυΩϡϝϯτ͸γεςϜͱͷରԠؔ܎ΛଛͳΘͳ͍࢓૊ΈͰ࡞੒͢Δ w ্هΞϓϩʔνͷҰ࣮૷ͱͯ͠OEJBHΛ঺հ w ։ൃऀ͸ͦΕͧΕͷυΩϡϝϯτΛ௨ͯ͡γεςϜ΁ͷཧղΛੵΈॏͶΔ͜ͱͰ ࠷ऴతʹγεςϜશମͷཧղʹͭͳ͛Δ

Slide 66

Slide 66 text

ΞϓϦέʔγϣϯίʔυͷ υΩϡϝϯςʔγϣϯߏ૝

Slide 67

Slide 67 text

ΞϓϦέʔγϣϯίʔυͷυΩϡϝϯςʔγϣϯ w ͋͘·ͰΞΠσΞʢ͍ͦͯۙ͠͠΋ͷ΋͢Ͱʹ͋Δʣ w 1)1%PD͸ʮܧଓతυΩϡϝϯςʔγϣϯʯ͸࣮ݱͰ͖͍ͯΔ͕ɺຊൃදʹ͓͚Δʮγ εςϜͷཧղΛॿ͚ΔʯΞϓϩʔνΛͱ͍ͬͯΔͱ͸ݴ͑ͳ͍ w γεςϜͷཧղΛॿ͚ΔγεςϜͷཧղʹҙຯͷ͋Δෳ਺ͷ੾ΓޱͰͷάϧʔϐϯά w ͱ͜ΖͰզʑ͸ΞϓϦέʔγϣϯͷཧղΛͲͷΑ͏ͳ୯ҐͰੵΈॏͶ͍͔ͯ͘ 㲈ػೳ୯Ґ΍"1*ͷΤϯυϙΠϯτ୯Ґ ΞϓϦέʔγϣϯ΋γεςϜͷཧղʹҙຯͷ͋Δάϧʔϐϯά͕͞ΕͨυΩϡϝϯτ Λܧଓతʹੜ੒Ͱ͖Ε͹γεςϜͷཧղΛॿ͚ΔͷͰ͸ͳ͍͔ͱ͍͏ΞΠσΞ

Slide 68

Slide 68 text

ίʔυΞϊςʔγϣϯͱ ΞϓϦέʔγϣϯ࣮ߦ࣌ͷτϨʔγϯά৘ใΛ׆༻ͨ͠ ΞʔΩςΫνϟυΩϡϝϯςʔγϣϯ

Slide 69

Slide 69 text

ΞΠσΞ w ΞϓϦέʔγϣϯίʔυͷ͋ΔϝιουʹʮελʔτʯΛࣔ͢ίʔυΞϊςʔ γϣϯΛ௥Ճʢ΋͘͠͸ઐ༻ͷςετέʔεΛ༻ҙʣ w ΞϓϦέʔγϣϯΛ࣮ߦͯ͠ελʔτͷϝιου͔ΒͷελοΫτϨʔε৘ใΛ औಘ w ελοΫτϨʔε৘ใ͔ΒҰ෦ෆඞཁͳ৘ใΛআ͍ͨҰ࿈ͷॲཧͷྲྀΕʹઆ໌จ ষΛ௥Ճ͢Δ͜ͱͰͭͷυΩϡϝϯτͱ͢ΔɻҰ࿈ͷྲྀΕʹग़ͯ͘Δϝιουͷ ίʔυΞϊςʔγϣϯͷ৘ใʢ1)1%PDͷ৘ใʣ΋߹Θͤͯදࣔ

Slide 70

Slide 70 text

ϝϦοτ w ΞϓϦέʔγϣϯʹ͓͚Δؔ৺ࣄ୯ҐͷυΩϡϝϯτΛ࣮ࡍͷίʔυͱରԠͤ͞ ͯ࡞੒Ͱ͖Δ w ίʔυͱͷ͕ࠩੜͨ͡৔߹ʹ$*ͳͲΛ௨ͯ͡ݕ஌Մೳ w υΩϡϝϯτͷΧόϨοδ΋ܭଌՄೳ w ୯ମͰ͸શମΛ၆ᛌͰ͖ͳ͍1)1%PDͷΑ͏ͳίʔυΞϊςʔγϣϯ৘ใͱɺͦ ͷ··ͩͱಡΈʹ͍͘ελοΫτϨʔε৘ใΛ߹ΘͤΔͱ͍͏ɺطଘͷٕज़Ͱऔ ಘͰ͖Δ৘ใΛ࢖ͬͯΞϓϦέʔγϣϯΛཧղΛॿ͚ΔυΩϡϝϯτΛੜ੒Ͱ͖ Δ

Slide 71

Slide 71 text

Ϟσϧ

Slide 72

Slide 72 text

࣮૷ͷΞΠσΞ w ϓϩάϥϛϯάݴޠʹґଘ͠ͳ͍࣮૷ʹ͍ͨ͠ w ʮίʔυΞϊςʔγϣϯͷτϨʔεʯʮΞϓϦέʔγϣϯ࣮ߦͷτϨʔεʯ͸ݴޠ ґଘͰ࡞੒͠ɺͦΕΒͷग़ྗ͚ͩ౷Ұͯ͠ɺʮτϨʔε৘ใ͔ΒͷυΩϡϝϯτ ੜ੒ʯ͸൚༻ੑΛ͍࣋ͨͤͨ w ۩ମతͳ࣮૷͸ྫ͑͹ɺ1)1Ͱ͋Ε͹ w ίʔυΞϊςʔγϣϯͷτϨʔεˠ1)1%PDͷػೳͰ࣮ݱͰ͖ͦ͏ w ΞϓϦέʔγϣϯ࣮ߦͷτϨʔεˠελʔτ͔ΒͷEFCVH@USBDF ͚ͩΛύʔ ε͢ΔπʔϧͰे෼͔΋

Slide 73

Slide 73 text

·ͱΊ

Slide 74

Slide 74 text

·ͱΊ w ։ൃ։࢝·ͰͷΦʔόʔϔουΛ࡟ݮ͢ΔυΩϡϝϯτΛӡ༻͍ͯͨ͘͠Ίʹ͸ ʮ%PDVNFOUBUJPOBT$PEFʯΛجຊͱ͠ͳ͕Β΋ɺʮܧଓతʹʯӡ༻Ͱ͖Δ࢓૊Έɺ ʮγεςϜͷཧղΛॿ͚Δʯ࢓૊Έ͕ඞཁͩͱ͍͏͜ͱΛओுͨ͠ w ܧଓతυΩϡϝϯςʔγϣϯͷͨΊʹ͸γεςϜͱυΩϡϝϯτͷဃ཭Λ൑ఆ͠খ͞ ͘͢Δ࢓૊Έ͕ඞཁͰ͋Δ͜ͱΛ঺հͨ͠ɻ w γεςϜͷཧղΛॿ͚ΔυΩϡϝϯτͷͭͷํ๏ͱͯ͠ʮγεςϜશମΛද͢ͷͰ͸ ͳ͘ɺγεςϜͷཧղʹҙຯͷ͋ΔάϧʔϐϯάΛͯͦ͠ΕͧΕυΩϡϝϯτԽ͢ ΔɻͦΕͧΕͷཧղΛॏͶΔ͜ͱͰγεςϜશମͷཧղʹͭͳ͛Δʯͱ͍͏ํ๏Λ঺ հͨ͠ɻ w ʮܧଓతυΩϡϝϯςʔγϣϯʯͱʮγεςϜͷཧղΛॿ͚ΔυΩϡϝϯςʔγϣ ϯʯΛཱ྆ͯ͠ॳΊͯ։ൃ։࢝·ͰͷΦʔόʔϔουΛ࡟ݮͰ͖Δ

Slide 75

Slide 75 text

5IBOLZPV ࠷৽ͷ࠾༻৘ใΛνΣοΫˠ !QC@SFDSVJU