実践 net/http Middleware パターン / Kizuku.go Vol.1

Transcript

1. ࣮ફ net/http Middlewareύλʔϯ খࢁ݈Ұ࿠ / GMO PEPABO inc. 2024.7.26 Kizuku.go Vol.1 1
2. ࣗݾ঺հ ϗεςΟϯάࣄۀ෦ 2018೥ த్ೖࣾ খࢁ ݈Ұ࿠ Ken’ichiro Oyama গ࣮͠༻తͰখ͞ͳOSSΛॻ͘ͷ͕झຯɻ • GitHub : k1LoW • Twitter : @k1LoW 2
3. GMOϖύϘʹ͍ͭͯ 3 https://pepabo.com
4. ΞδΣϯμ • net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ • Α͘࢖ΘΕΔ Middleware ύλʔϯΛར༻ͨ͠ػೳ • զʑ͕࣮ફ͍ͯ͠Δ Middleware ύλʔϯΛར༻ͨ͠ػೳ • ·ͱΊ 4
5. 5 net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ
6. • net/http ύοέʔδ • Package http provides HTTP client and server implementations. • HTTPΫϥΠΞϯτ΍HTTPαʔόͷ࣮૷ͷͨΊͷύοέʔδ • net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ • HTTPϦΫΤετ/ϨεϙϯεΛऔΓѻ͏HTTPαʔόʹ͓͍ͯػೳΛ࣮૷͢Δࡍʹ࢖༻Ͱ͖ Δ࣮૷ύλʔϯ 6 net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯͱ͸Կ͔
7. • ಛఆͷϙʔτͰTCP઀ଓ(HTTP/3͸UDPʣΛ଴ͪड͚ɺTLSऴ୺ॲཧΛͨ͠ΓɺΫϥΠΞϯτ͔ Β௚઀HTTPϦΫΤετΛड͚ͯ࠷ऴతʹHTTPϨεϙϯεΛฦ͢αʔόϓϩηε • NGINX΍Apache͸HTTPαʔόͱݴ͑Δ • ʢຊηογϣϯͰ͸HTTPαʔόͱWebαʔόΛ۠ผ͠·ͤΜʣ 7 net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ HTTPαʔό
8. • WebΞϓϦέʔγϣϯΛߏங͢Δͱ͖ɺHTTPαʔόͱWebΞϓϦέʔγϣϯ/ϑϨʔϜϫʔΫͷ ૊Έ߹ΘͤͰɺHTTPϦΫΤετ/ϨεϙϯεΛऔΓѻ͏͜ͱ͕ଟ͍ • HTTPαʔόͱWebΞϓϦέʔγϣϯ/ϑϨʔϜϫʔΫͷؒͷΠϯλʔϑΣΠεඪ४Խ͢Δ͜ͱ Ͱɺॊೈͳ૊Έ߹ΘͤΛ࣮ݱ͢Δ࢓༷͕͋Δ • WSGIʢPythonʣɺRackʢRubyʣɺPSGIʢPerlʣ 8 net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ WebΞϓϦέʔγϣϯΛߏங͢Δ
9. • ʢதུʣ The process of wrapping the Pylons application in middleware results in a structure conceptually similar to the layers in an onionʢλϚωΪʣ. • ຊηογϣϯʹ͓͚ΔMiddlewareύλʔϯͱಉ͡ • WSGI Middleware ͸ HTTPαʔόͱWebΞϓϦέ
 ʔγϣϯ/ϑϨʔϜϫʔΫͷதؒͷWSGIϨΠϠͰ࣮ݱ • ͪͳΈʹɺHTTPαʔόͷϨΠϠͰ΋WebΞϓϦέʔγϣϯ/
 ϑϨʔϜϫʔΫͷϨΠϠͰ΋Middlewareύλʔϯ͸͋Δ
 ʢ͋ͬͯΑ͍ʣ 9 net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ WSGI Middleware https://docs.pylonsproject.org/projects/pylons-webframework/en/latest/concepts.html#wsgi-middleware
10. 10 net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ WSGI Middleware
11. • Goͷ৔߹͸net/httpύοέʔδͷଘࡏ͔ΒHTTPαʔόͷػೳͱ·ͱΊͯ1ͭͷίʔυϕʔεͱ͠ ͯ͠·͏͜ͱ͕ଟ͍ • Middlewareύλʔϯʹ͓͚ΔMiddleware͕WebΞϓϦέʔγϣϯʹͱͬͯͷMiddlewareͰ͋Δ ͱͱ΋ʹHTTPαʔόͷMiddlewareͱͯ͠΋ड͚ೖΕΒΕΔ • ΞʔΩςΫνϟ͕γϯϓϧʹͳΔϝϦοτͩͱߟ͑Δ 11 net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ Goʹ͓͚ΔWebΞϓϦέʔγϣϯ
12. 12 net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ net/http Middleware
13. 13 net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ ϕʔεͱͳΔίʔυ
14. • ServerHTTPϝιουΛ࣋ͭΠϯλʔϑΣʔε • ServeHTTPϝιου͸ɺͦͷ໊ͷ௨ΓHTTPϦΫΤετΛड͚ͯHTTPϨεϙϯεΛฦͨ͢ Ίͷϝιου 14 net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ http.Handler
15. 15 net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ http.Handler http.Handler
16. • http.HandlerΛड͚औΓhttp.HandlerΛฦؔ͢਺γάωνϟ 16 net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ net/http ύοέʔδʹ͓͚ΔMiddlewareύλʔϯ
17. 🤔 17
18. • http.HandlerFuncͰؔ਺Λhttp.Handlerʹม׵͍ͯ͠Δ 18 net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ MiddlewareύλʔϯͰͷ࣮૷Πϝʔδ
19. • http.HandlerΛड͚औΓhttp.HandlerΛฦ͢
 Middleware͸ೖΕࢠʹͰ͖Δ 19 net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ MiddlewareύλʔϯͰͷ࣮૷Πϝʔδ
20. 20 Α͘࢖ΘΕΔ Middleware ύλʔϯΛར༻ͨ͠ػೳ
21. • ΞΫηεϩά • CORS • ೝূೝՄ • ΞΫηε੍ޚ 21 Α͘࢖ΘΕΔ Middleware ύλʔϯΛར༻ͨ͠ػೳ Α͘࢖ΘΕΔ Middleware ύλʔϯΛར༻ͨ͠ػೳ
22. 22 զʑ͕࣮ફ͍ͯ͠Δ Middleware ύλʔϯΛར༻ͨ͠ػೳ
23. • Goͷ৔߹͸net/httpύοέʔδͷଘࡏ͔ΒHTTPαʔόͷػೳͱ·ͱΊͯ1ͭͷίʔυϕʔεͱ͠ ͯ͠·͏͜ͱ͕ଟ͍ • Middlewareύλʔϯʹ͓͚ΔMiddleware͕WebΞϓϦέʔγϣϯʹͱͬͯͷMiddlewareͰ͋ Δͱͱ΋ʹHTTPαʔόͷMiddlewareͱͯ͠΋ඇ࿈ଓͰड͚ೖΕΒΕΔ • ΞʔΩςΫνϟ͕γϯϓϧʹͳΔϝϦοτ 23 զʑ͕࣮ફ͍ͯ͠Δ Middleware ύλʔϯΛར༻ͨ͠ػೳ ʢ࠶ܝʣGoʹ͓͚ΔWebΞϓϦέʔγϣϯ
24. • ྫ͑͹ʮHTTPϓϩΩγαʔόΛGoͰಠࣗʹॻ͘ʯͱ͍͏બ୒ • HTTPαʔόͷػೳΛGoͰॻ͘͜ͱͰɺΑΓυϝΠϯʹಛԽͨ͠ػೳΛఏڙ͢Δ͜ͱ͕Մೳ • ϓϩΩγαʔόͰ΋ net/http ύοέʔδΛ࢖͏͜ͱʹ͸มΘΓ͸ͳ͍ɻͭ·ΓɺMiddleware ύ λʔϯ͸ͦͷ··࣮ફͰ͖Δ 24 զʑ͕࣮ફ͍ͯ͠Δ Middleware ύλʔϯΛར༻ͨ͠ػೳ ౰વɺHTTPαʔόͷΈΛGoͰॻ͘͜ͱ΋Մೳ
25. 2manymws/rc 25
26. • rc is a response cache middleware for cache. • ϦΫΤετʹԠͯ͡ಈతʹΩϟογϡ൑ఆΛม͑Δ͜ͱ͕Ͱ͖ΔMiddleware • Ωϟογϡ൑ఆ΍Ωϟογϡͷฦ٫͸ rc.Casher ΠϯλʔϑΣʔεΛຬ࣮ͨ͢૷Λ࡞Δ͜ ͱͰ೚ҙͷ൑ఆϩδοΫΛ૊ΈࠐΉ͜ͱ͕Մೳ • ΩϟογϡετϨʔδ΋ಠࣗʹ૊ΈࠐΈՄೳ • σΟεΫΩϟογϡͰ͋Ε͹ɹɹhttps://github.com/2manymws/rcutil Λ࢖༻Մೳ • Ωϟογϡૢ࡞ʹ͓͚ΔσϑΥϧτͷಈ࡞͸RFC9111ʹ४ڌ • ϓϩΩγαʔόʹඞཁͳػೳͷΈΛ࣮૷͍ͯ͠Δ 26 զʑ͕࣮ફ͍ͯ͠Δ Middleware ύλʔϯΛར༻ͨ͠ػೳ https://github.com/2manymws/rc
27. 2manymws/rl 27
28. • rl is a rate limit middleware for multiple limit rules. • ϦΫΤετʹԠͯ͡ಈతʹϨʔτϦϛοτͷϧʔϧΛઃఆͰ͖ΔMiddleware • ϨʔτϦϛοτͷϧʔϧΛ rl.Limitter ΠϯλʔϑΣʔεΛຬͨ͢͜ͱͰ૊ΈࠐΉ͜ͱ͕Ͱ͖ Δɻ • ϨʔτϦϛοτͷϩδοΫʹ͸Sliding Window CounterύλʔϯΛ࠾༻ • https://blog.cloudflare.com/counting-things-a-lot-of-different-things/ • IPϕʔε΍ϗετϕʔεͳͲ࣮ફతͳϦϛοτϧʔϧ͸ http://github.com/2manymws/rlutils ʹޙ չ͍ͯ͠Δ 28 զʑ͕࣮ફ͍ͯ͠Δ Middleware ύλʔϯΛར༻ͨ͠ػೳ https://github.com/2manymws/rl
29. 2manymws/mm 29
30. • mm is a middleware-middleware for multiple rules. • ϦΫΤετʹԠͯ͡ಈతʹMiddlewareΛ੾Γସ͑Δ͜ͱ͕Ͱ͖ΔMiddleware • Middlewareద༻ϧʔϧΛ mm.Builder ΠϯλʔϑΣʔεΛຬͨ͢͜ͱͰ૊ΈࠐΉ͜ͱ͕Ͱ͖ Δɻ • ·࣮ͩફ౤ೖ͸͍ͯ͠ͳ͍ • ར༻͍ͨ͠Middleware͕ϦΫΤετʹԠͯ͡੾Γସ͑Δͱ͍͏ػೳΛ࣋ͨͳ͍৔߹ͳͲʹ࢖༻ ͢ΔΠϝʔδ 30 զʑ͕࣮ફ͍ͯ͠Δ Middleware ύλʔϯΛར༻ͨ͠ػೳ https://github.com/2manymws/mm
31. 31 ·ͱΊ
32. 32 ·ͱΊ શͯ͸http.Handler • net/httpύοέʔδͷHTTPαʔό͸http.HandlerΛऔΓѻ͏ • http.ServeMux΋http.Handler • WebΞϓϦέʔγϣϯʹ͓͚Δʮϧʔλʯͱݺ͹ΕΔ΋ͷ͸ɺ୯ʹʮϦΫΤετύεΛݩʹಈతʹ http.HandlerΛ੾Γ͔͑Δhttp.Handlerʯͱݴ͑Δ • Middleware΋http.Handler • શͯͷϦΫΤετ/Ϩεϙϯεʹରͯ͠λϚωΪͷΑ͏ʹhttp.HanderΛϥοϓ͍ͯ͠Δ • Middlewareͷڍಈ΋ϦΫΤετΛݩʹಈతʹมΘ͍͍ͬͯ • Α͏͸ʮػೳશମΛͲ͏σβΠϯ͢Δ͔ʯʹམͪண͘ • શͯ͸http.Handler
33. 33 Thank you!