ふんわり使うPlantUML

PlantUML を使って、ふんわりと図を描くはなし。

PHPerKaigi 2023 (2023-03-24)
https://phperkaigi.jp/2023/

Transcript

1. !TV[VLJ ;ΜΘΓ࢖͏
   1MBOU6.- 1)1FS,BJHJ
   
2. ࿩͢͜ͱ w ʮ;ΜΘΓ࢖͏ʯͷఆٛ
   w 1MBOU6.-ͷ࢖͍ํɾֶͼํ
   w Θͨ͠ͷ࢖͍ํ
   w ͓·͚
3. ࿩͞ͳ͍͜ͱ w 6.-ͦͷ΋ͷʹ͍ͭͯͷৄࡉ
   w ଞͷπʔϧͱͷൺֱ
4. "CPVU
   NF
5. !TV[VLJ IUUQTUXJUUFSDPNTV[VLJ
   IUUQTHJUIVCDPNTV[VLJ
   IUUQTTQFBLFSEFDLDPNTV[VLJ
6. $VSSFOUMZ
   XPSLFE
   BU
   3"#0
   *OD IUUQTSBCPDBU
7. 1MBOU6.-Λʮ;ΜΘΓ࢖͏ʯ
8. w ςΩετͰهड़͠ɺਤΛඳͨ͘Ίͷπʔϧ
   w 6.-Λத৺ͱͨ͠ଟ࠼ͳਤΛαϙʔτ
   w ςΩετϑΝΠϧͳͷͰཤྺ؅ཧָ͕ 1MBOU6.-ͱ͸ IUUQTQMBOUVNMDPN
9. ౷ҰϞσϦϯάݴޠ lΦϒδΣΫτࢦ޲ͷΤοηϯεΛத৺ʹɺ ඪ४తͳਤͷॻ͖ํΛܾΊͯɺͭ·Βͳ͍ ޡղΛආ͚ΔΑ͏ʹͨ͠ͷ͕6.- ʢ6OJ fi FE
   .PEFMJOH
   -BOHVBHFʣͰ͢z
   
 ൈਮ
   ͪΐ͏ͥͭιϑτ΢ΣΞઃܭೖ໳
   ᴷᴷ
   1)1Ͱཧղ͢ΔΦϒδΣΫτࢦ޲ͷ׆༻ 6.-
10. ͭ·Βͳ͍ޡղͳ͘఻͑Δᶃ ਖ਼͍͠จষͰ
    දݱ͢Δ ͭ·Βͳ͍ޡղͳ͘఻͑Δ 👍
11. ͭ·Βͳ͍ޡղͳ͘఻͑Δᶄ ਖ਼͍͠จষͱ
    ਖ਼͍͠6.-Ͱ
    දݱ͢Δ ਖ਼͍͠จষͰ
    දݱ͢Δ ͭ·Βͳ͍ޡղͳ͘఻͑Δ ˠ 👍 💯
12. UML *NBHF
    DSFBUFE
    CZ
    4UBCMF
    %J ff VTJPO
    0OMJOF
    IUUQTTUBCMFEJ ff VTJPOXFCDPN
    
13. ͭ·Βͳ͍ޡղͳ͘఻͑Δᶅ ਖ਼͍͠จষͱ
    ਖ਼͍͠6.-Ͱ
    දݱ͢Δ ਖ਼͍͠จষͰ
    දݱ͢Δ ਖ਼͍͠จষͱ
    ਤͰ
    දݱ͢Δ ͭ·Βͳ͍ޡղͳ͘఻͑Δ ˠ ˠ 👍 💯 🎉
14. ·ͣ͸ਤͱͯ͠ඳ͘
15. 6.-ͱͯ͠ͷਖ਼͠͞͸
    ޙ͔Β෇͍ͯ͘Δ
16. ͜Ε͕ʮ;ΜΘΓ࢖͏ʯ
17. 1MBOU6.-ͷجຊॻࣜ
18. ॻࣜͷجຊ @startuml ཁૉAͷఆٛ
 ཁૉBͷఆٛ ཁૉAͱཁૉBͷؔ࿈ @enduml
19. γʔέϯεਤ @startuml participant Alice participant Bob Alice -> Bob @enduml
20. Ϋϥεਤ @startuml class Alice class Bob Alice -> Bob @enduml
21. Ϣʔεέʔεਤ @startuml usecase Alice usecase Bob Alice -> Bob @enduml
22. Ϣʔεέʔεਤ @startuml (Alice) -> (Bob) @enduml Ϣʔεέʔε͸ؙׅހͰғΜͰ࢖͍·͢
    ؙׅހͷର͸ପԁʹࣅ͍ͯΔ͔ΒͰ͢
    
 IUUQTQMBOUVNMDPNKBVTFDBTFEJBHSBN
23. ཁૉҎ্ͷؔ࿈ͷॻ͖ํ @startuml usecase Alice usecase Bob usecase Carol Alice -> Bob -> Carol @enduml ❌
24. ཁૉҎ্ͷؔ࿈Ͱ΋ཁૉͣͭॻ͘ @startuml usecase Alice usecase Bob usecase Carol Alice -> Bob Bob -> Carol @enduml ⭕
25. ͜ͷه๏Ҏ֎Ͱ
    ཁૉؒͷؔ࿈Λඳ͘ਤ΋͋Δ +40/ͱ͔:".-ͱ͔
    ϚΠϯυϚοϓͱ͔
26. 1MBOU6.-ͰਤΛඳը͢Δ
27. ίϚϯυϥΠϯͰϑΝΠϧΛม׵ $ java -jar plantuml.jar file.puml -t png %PXOMPBE
    GSPN
    QMBOUVNMDPN
    PS
    
    CSFX
    JOTUBMM
    QMBOUVNM
28. ެࣜαΠτͷ0OMJOF
    4FSWFSͰม׵ 0OMJOF
    4FSWFS
    ϝχϡʔ͔Β࢖͏
29. %PDLFS
    DPOUBJOFS
    QMBOUVNMTFSWFS $ docker run -d -p 8080:8080 \
 plantuml/plantuml-server http://localhost:8080/
30. ςΩετΤσΟλ΍*%&ͱͷ࿈ܞ
    ࿈ܞํ๏͸KBSϑΝΠϧͩͬͨΓ 0OMJOF
    4FSWFSʢ"1*
    4FSWFSʣͩ ͬͨΓ ΤσΟλ࿈ܞ https://plantuml.com/ja/running
31. 8FCαʔϏεΛ࢖͏ w 1MBOU6.-ରԠͷ8FCαʔϏεͷྫ
    w )BDL.%
    IUUQTIBDLNEJP
    w FTB
    IUUQTFTBJP
32. ʲ஫ҙʳ
    ଞਓ͕؅ཧ͍ͯ͠Δ0OMJOF
    4FSWFSʹ͸
    ൿີ৘ใΛهࡌ͠ͳ͍
33. QBUI
    Λσίʔυ͢Δͱɺ ݩͷίʔυʹͳΔ
34. ࠓ೔͜͜ͰαϯϓϧΛࢼ͚ͩ͢ͳΒ
    )BDL.%͕͓ख͔ܰ΋ ηοτΞοϓෆཁ 
 ϑϦʔϓϥϯ͋Γ
35. Θͨ͠ͷར༻๏
36. Θͨ͠ͷར༻๏ w ઃܭϑΣʔζͰͷ಄ͷ੔ཧ
    w ։ൃ࣌ͷιʔείʔυɾϦʔσΟϯά
    w ӡ༻υΩϡϝϯτͰͷิ଍આ໌
37. ઃܭϑΣʔζͰͷ࢖͍ํ w ΞʔΩςΫνϟͷ੔ཧ
    w σʔλߏ଄ͷ੔ཧ
    w γʔέϯεਤ͔Βڞ௨ॲཧΛ୳Δ
    w ίʔυΛॻ͍͔ͯΒؾ෇͘ͱख໭Γ͕ൃੜ͢Δ৔߹͕͋Δ
38. ΞʔΩςΫνϟਤͷྫᶃ @startuml (User) -> (API) (API) -> (DB) ' Queue (API) --> (Queue) (Queue) <-- (Subscriber) (Subscriber) -> (MTA) @enduml
39. ΞʔΩςΫνϟਤͷྫᶄ @startuml actor User queue Queue database DB (User) -> (API): POST /register (API) -> (DB): Save ' Queue (API) --> (Queue): Publish Message (Queue) <-- (Subscriber): Subscribe Message (Subscriber) -> (MTA): Email @enduml
40. ΞʔΩςΫνϟਤͷྫᶅ @startuml !include <awslib/AWSCommon> !include <awslib/AWSSimplified> !include <awslib/General/Users> !include <awslib/Database/Aurora> !include <awslib/ApplicationIntegration/SimpleQueueService> !include <awslib/BusinessApplications/SimpleEmailService> Users(User, "User", "tech") Aurora(DB, "DB", "tech") SimpleQueueService("Queue", "Queue", "tech") SimpleEmailService("MTA", "MTA", "tech") (User) -> (API): POST /register (API) -> (DB): Save ' Queue (API) --> (Queue): Publish Message (Queue) <-- (Subscriber): Subscribe Message (Subscriber) -> (MTA): Email @enduml
41. γʔέϯεਤͷྫᶃ @startuml User -> API: POST /save API -> API: Create Message API -> Queue: Publish Message API <-- Queue: OK User <-- API: OK == Subscriber Process == Queue <- Subscriber: Fetch Message Queue --> Subscriber: Message Subscriber -> DB: Save Subscriber <-- DB: OK @enduml
42. ;ΜΘΓ࢖͏ͱ͖ͷϙΠϯτ w ਤ͸ͻͱͭ͡Όͳͯ͘΋ྑ͍
    w ཻ౓Λม͑ͨෳ਺ͷਤ
    w શମ֓ཁͱॲཧৄࡉ
    w ʮԿ΋͔΋ਖ਼֬ʹඳ͔ͳΕ͹ʂʯΈ͍ͨͳ࢖໋ײ͸๨ΕΔ
    w ͍͕ͭΜ͹Γͨ͘ͳΔ͕ɺ͕Μ͹Βͳ͍
43. ιʔείʔυɾϦʔσΟϯάͰͷར༻ w ʮ೺Ѳ͖͠Ε͍ͯͳ͍ػೳͷमਖ਼ʯͳͲͷͱ͖ʹ࢖͏
    w ΤσΟλͷػೳͰॲཧͷࢀরݩΛ௥͍ͬͯ͘
    w ϝιου୯ҐͳͲͰϓϩοτ͠ɺؔ࿈෇͚͍ͯ͘
    w Ͳͷ෦෼ʹमਖ਼ΛՃ͑Δͷ͕Ұ൪εδ͕ྑͦ͞͏͔Λ୳Δ
44. ιʔείʔυɾϦʔσΟϯάͷྫ @startuml skinparam usecase<<DEPRECATED>> { backgroundColor #fcc } skinparam usecase<<RENEW>> { backgroundColor #cfc } ' command ܥ rectangle "terminate Command" as terminateCommand usecase "TerminationService::exec()" as terminateService ' admin ܥ rectangle "POST /admin/delete API" as adminDeleteApi usecase "Admin\DeleteService::delete()" as adminDeleteService ' ࡟আຊମ usecase "Deprecated\DeleteService::delete()" as deleteServiceDeprecated <<DEPRECATED>> usecase "DeleteService::delete()" as deleteService <<RENEW>> usecase "෇Ճ৘ใͷ࡟আॲཧ" as deleteInfo <<RENEW>> ' unregister ܥ rectangle "POST /unregister API" as unregisterApi usecase "UnregisterService::unregister()" as unregisterService ' command ܥ (terminateCommand) --> (terminateService) (terminateService) --> (deleteServiceDeprecated) ' admin ܥ (adminDeleteApi) --> (adminDeleteService) (adminDeleteService) --> (deleteServiceDeprecated) (deleteServiceDeprecated) --> (deleteService) ' unregister ܥ (unregisterApi) ---> (unregisterService) (unregisterService) --> (deleteService) ' RENEW (deleteService) --> (deleteInfo) @enduml
45. ;ΜΘΓ࢖͏ͱ͖ͷϙΠϯτ w શ෦Λඳ͜͏ͱ͕Μ͹Βͳ͍
    w ඳ͘ͷ͕໨తͰ͸ͳ͘ɺඳ͍ͨ݁ՌͰॲཧΛ೺Ѳ͢Δͷ͕໨త
    w ඞཁͳՕॴ͸
    QSJWBUF
    ϝιουͷॲཧͰ΋ϓϩοτ͢Δ
    w ࣗ෼Ͱ೺Ѳ͠΍͚͢Ε͹ɺଟগཻ౓͕ϒϨͯ΋ؾʹ͠ͳ͍
46. 1MBOU6.-ͷֶͼํ
47. w ඳ͚Δਤͷ಺༰͕໢ཏ͞Ε͍ͯΔ
    w ߏ଄ཱ͕ମతͰͪΐͬͱ௥͍ʹ͍͘
    w ʢ޿ࠂαΠζ΋ͪΐͬͱେ͖Ίʣ ඞཁͳ৘ใ͸ެࣜαΠτʹ͋Δ IUUQTQMBOUVNMDPN
48. ެࣜαΠτͷ௥͍ํ IUUQTQMBOUVNMDPN ਤ͝ͱͷϦϯΫ 
 ʢ⾢ͰεΫϩʔϧʣ ֤ϖʔδ 
 ڞ௨ϝχϡʔ ݴޠ੾ସ ϖʔδ֊૚ߏ଄ ೥݄ݱࡏ
49. ϦϑΝϨϯεΨΠυʢ1%'ΨΠυʣ IUUQTQMBOUVNMDPNKBHVJEF
50. ϦϑΝϨϯεΨΠυͷΦεεϝϙΠϯτ IUUQTQMBOUVNMDPNKBHVJEF w ͦΕͧΕͷਤ͝ͱʹষཱͯ
    w ॻ͖͍ͨਤͷ৘ใΛ௥͍΍͍͢
    w ʢ޿ࠂ͕ͳ͍ʣ
51. w (JU)VC
    4QPOTPST
    w 1BUSFPO
    w -JCFSBQBZ
    w 1BZ1BM 1MBOU6.-͕༗༻ͩͱࢥͬͨΒεϙϯαʔʹ IUUQTQMBOUVNMDPNKB
52. εϙϯαʔಛయͱͯ͠
    BEGSFF
    ൛ͷ
    XFCTJUF
    Λ࢖͑Δ εϙϯαʔಛయ IUUQTQMBOUVNMDPNQBUSFPOKB
53. ·ͱΊ
54. ਤΛ;Θͬͱඳ͜͏
55. ;Θͬͱ͍ͯͯ͠΋
    ޡղͳ͘఻ΘΔ֬཰͸্͕Δ
56. ਖ਼֬͞͸ޙ͔Β෇͍ͯ͘Δ
57. "QQFOEJY
58. ཁૉͷϨΠΞ΢τௐ੔ w ϨΠΞ΢τ͸1MBOU6.-ʹ೚ͤΔͷ͕جຊ
    w ϨΠΞ΢τΛ׬ᘳʹ੔͍͑ͨͳΒผͷπʔϧΛ࢖ͬͨ΄͏͕͍͍
    w ͋Δఔ౓ͷௐ੔͸ޮ͘
    w ϥΠϯͷ௕͞
    w ໼ҹͷํ޲Λௐ੔
    w άϧʔϐϯά
    w ఆٛॱ
59. ϥΠϯͷ௕͞ @startuml (A) - (B) (A) -- (C) (A) --- (D) (A) ---- (E) @enduml
60. ໼ҹͷํ޲Λௐ੔ @startuml (A) -r-> (B) (A) -d-> (C) (A) -l-> (D) (A) -u-> (E) @enduml SJHIU
    
    MFGU
    EPXO
    
    VQ
61. άϧʔϐϯά @startuml rectangle Group { (B) (C) } (A) -> (B) (A) -> (C) @enduml
62. άϧʔϐϯάͱ
    IJEEFO
    ϥΠϯ @startuml rectangle Group { (B) (C) (B) -d[hidden]- (C) } (A) -> (B) (A) -> (C) @enduml E
    ͸
    EPXO
    ͷ͜ͱ
    ଞͷํ޲ࢦఆ΋Ͱ͖Δ
63. ཁૉͷఆٛॱ @startuml (A) -> (B) @enduml @startuml (B) <- (A) @enduml
64. ݟͨ໨ͷมߋ w ςʔϚʢUIFNFʣΛ࢖͏
    w ϥΠϒϥϦΛ࢖͏
    
    w TLJOQBSBN
    Λ࢖͏
65. ςʔϚʢTQBDFMBCʣ @startuml !theme spacelab (A) -- (B) (A) -- (C) @enduml ૊ΈࠐΈͷςʔϚͷҰཡ͸ 
 IUUQTQMBOUVNMDPNKBUIFNF
66. ϥΠϒϥϦΛ࢖͏ @startuml !include <awslib/AWSCommon> !include <awslib/AWSSimplified> !include <awslib/General/Users> !include <awslib/Database/Aurora> !include <awslib/Database/DynamoDB> Users(A, "A", "tech") DynamoDB(B, "B", "tech") Aurora(C, "C", "tech") (A) -- (B) (A) -- (C) @enduml ૊ΈࠐΈͷϥΠϒϥϦͷҰཡ͸ 
 IUUQTQMBOUVNMDPNKBTUEMJC
67. ৭Λม͑ͯݟ΍͘͢͢Δ @startuml skinparam usecase { backgroundColor #fcc } (A) -- (B) (A) -- (C) @enduml શͯͷ
    VTFDBTF
    ͕ର৅
68. ৭Λม͑ͯݟ΍͘͢͢ΔʢಛఆͷཁૉͷΈʣ @startuml skinparam usecase<<SPECIAL>> { backgroundColor #fcc } usecase A <<SPECIAL>> (A) -- (B) (A) -- (C) @enduml 41&$*"-
    ͷϥϕϧ͕෇͍ͨ
    VTFDBTF
    ͷΈ͕ର৅
69. TLJOQBSBN
    ͷݕࡧ IUUQTQMBOUVNMEPDVNFOUBUJPOSFBEUIFEPDTJPFOMBUFTUGPSNBUUJOHBMMTLJOQBSBNTIUNM "TIMFZT
    1MBOU6.-
    %PD
    ࢦఆՄೳͳTLJOQBSBNΛݕࡧ
    
70. 3FGFSFODFT
71. 3FGFSFODFT w 1MBOU6.-
    w IUUQTQMBOUVNMDPN
    w "TIMFZT
    1MBOU6.-
    %PD
    w IUUQTQMBOUVNMEPDVNFOUBUJPOSFBEUIFEPDTJPFOMBUFTU GPSNBUUJOHBMMTLJOQBSBNTIUNM
    w ͪΐ͏ͥͭιϑτ΢ΣΞઃܭೖ໳
    w IUUQTHJIZPKQCPPL
72. 3FGFSFODFT w 4UBCMF
    %J ff VTJPO
    0OMJOF
    w IUUQTTUBCMFEJ ff VTJPOXFCDPN
    w "
    NBO
    JT
    MPPLJOH
    VQ
    BU
    B
    IJHI
    XBMM
    5IF
    XBMM
    JT
    NBEF
    PG
    CSJDLT
    5IF
    XBMM
    JT
    
    NFUFST
    IJHI