Share
Embed
grapi: Bulding JSON API server with grpc-gateway for microservices
presented at Go Conference 2018 Spring https://gocon.connpass.com/event/82515/
grapi: https://github.com/izumin5210/grapi
grpc-gateway: https://github.com/grpc-ecosystem/grpc-gateway
izumin5210
April 15, 2018
Transcript
57 slides
-
©2018 Wantedly, Inc. grapi: Building JSON API server with grpc-gateway
for microservices Go Conference 2018 Spring 13.Apr.2018 - @izumin5210 -
©2018 Wantedly, Inc. $ whoami a.k.a. usamimi engineer izumin5210 Engineer
at Wantedly, Inc. Wantedly People ‣ Web Application Engineer - Profile Data Strategy Group ‣ Interests in developer productivity on microservices Gopher, Rubyist, JavaScripter and Androider -
©2018 Wantedly, Inc. grapi: Building JSON API server with grpc-gateway
for microservices Go Conference 2018 Spring 13.Apr.2018 - @izumin5210 -
©2018 Wantedly, Inc. WHY Go ? Microservices and Go in
Wantedly ͋ΘͤͯΑΈ͍ͨ Why microservices ? Why Rails and Go ? ‣ %PDLFS͕ૣ͔͘Β1SPEVDUJPOͰΘΕ͍ͯͨ .JDSPTFSWJDFTPO,VCFSOFUFTΛೖΕ͍͢ ‣ Γ͍ͨ͜ͱʹ࠷దͳٕज़બఆΛ ઐ৬1ZUIPO $ υϝΠϯ͕ݟ͑ͯΔ(Pʕ◔ϖ◔ʔ ͦΕҎ֎3BJMT Rails Developer Meetup 2018: Microservices on "Rails" https://www.wantedly.com/companies/wantedly/post_articles/113554 -
©2018 Wantedly, Inc. WHY Go ? Microservices and Go in
Wantedly ͋ΘͤͯΑΈ͍ͨ Why microservices ? Why Rails and Go ? ‣ %PDLFS͕ૣ͔͘Β1SPEVDUJPOͰΘΕ͍ͯͨ .JDSPTFSWJDFTPO,VCFSOFUFTΛೖΕ͍͢ ‣ Γ͍ͨ͜ͱʹ࠷దͳٕज़બఆΛ ઐ৬1ZUIPO $ υϝΠϯ͕ݟ͑ͯΔ(Pʕ◔ϖ◔ʔ ͦΕҎ֎3BJMT Rails Developer Meetup 2018: Microservices on "Rails" https://www.wantedly.com/companies/wantedly/post_articles/113554 -
©2018 Wantedly, Inc. WHY Go ? Microservices and Go in
Wantedly Microservices and Go Wantedly People ❤ Go ‣ ܰྔɾϋΠύϑΥʔϚϯε ,VCFSOFUFTͱͷ૬ੑ˕ ‣ αʔϏεؒ௨৴ͳͲͰ*0͕૿͕͑ͪ go͚ͬͯͭΔ͚ͩͰඇಉظʹͳͬͯศར sync errgroup chanͳͲศར Rails Developer Meetup 2018: Microservices on "Rails" https://www.wantedly.com/companies/wantedly/post_articles/113554 -
©2018 Wantedly, Inc. WHY Go ? Microservices and Go in
Wantedly Microservices and Go Wantedly People ❤ Go ‣ ܰྔɾϋΠύϑΥʔϚϯε ,VCFSOFUFTͱͷ૬ੑ˕ ‣ αʔϏεؒ௨৴ͳͲͰ*0͕૿͕͑ͪ go͚ͬͯͭΔ͚ͩͰඇಉظʹͳͬͯศར sync errgroup chanͳͲศར Rails Developer Meetup 2018: Microservices on "Rails" https://www.wantedly.com/companies/wantedly/post_articles/113554 -
©2018 Wantedly, Inc. Web API with Go How do you
build Web API with Go? -
©2018 Wantedly, Inc. Web API with Go How do you
build Web API with Go ? ‣ Stdlib net/http ‣ Lightweight / High-performance package - e.g. gin, echo, ... ‣ (Full-stack) web-app framework - e.g. Revel, beego, ... The Go gopher was designed by Renée French. -
©2018 Wantedly, Inc. Go in Wantedly We uses github.com/gin-gonic/gin ‣
ॳظ͔ΒHJOΛར༻͖ͯͨ͠ ʢৄࡉΒͳ͍ʣ ൺֱత͔͘Βcontext.Contextϕʔεͩͬͨʁ ػೳɾੑೳͷόϥϯεʁ ͔ΜͨΜͳWBMJEBUJPOͱ͔͍ͭͯΔ ύϑΥʔϚϯεѱ͘ͳ͍ ඇৗʹ͍͕͋ͬͨʢվળૣ͍ʣ Rails Developer Meetup 2018: Microservices on "Rails" https://www.wantedly.com/companies/wantedly/post_articles/113554 gin gin gin gin gin ? Web API with Go in Wantedly -
©2018 Wantedly, Inc. // Boilerplate code for JSON API server
in net/http // ちょっとした誇張表現がはいっているかも func CreateBook(w http.ResponseWriter, r *http.Request) { data, err := ioutil.ReadAll(r) if err != nil { http.Error(w, err.Error(), http.StatusBadRequest) return } req := &CreateBookRequest{} if err = json.Unmarshal(data, book); err != nil { http.Error(w, err.Error(), http.StatusBadRequest) return } // ここが本当に実現したいロジック w.WriteHeader(http.StatusCreated) if err := json.NewEncoder(w).Encode(book); err != nil { http.Error(w, err.Error(), http.StatusInternalServerError) return } } (PͷͭΒ͞ Boilerplate in net/http FH$36%ͷ$ʢ$SFBUFʣͷ࣮XJUInet/http IUUQ3FRVFTU͔ΒCPEZಡΈग़͠ ΤϥʔϋϯυϦϯά CPEZΛTUSVDUʹVONBSTIBM ΤϥʔϋϯυϦϯά ຊʹ࣮ݱ͍ͨ͠ϩδοΫΛॻ͘ ΤϥʔϋϯυϦϯά +40/ʹNBSTIBMͯ͠SFTQPOTFʹॻ͘ ΤϥʔϋϯυϦϯά -
©2018 Wantedly, Inc. (PͷͭΒ͞ Boilerplate in gin FH$36%ͷ$ʢ$SFBUFʣͷ࣮XJUIgin SFRVFTUCPEZΛTUSVDUʹVONBSTIBM
ΤϥʔϋϯυϦϯά ຊʹ࣮ݱ͍ͨ͠ϩδοΫΛॻ͘ ΤϥʔϋϯυϦϯά Ϩεϙϯεͭ͘Δ // Boilerplate code for JSON API server in gin-gonic/gin func CreateBook(c *gin.Context) { req := &CreateBookRequest{} if err := c.BindJSON(req) { c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) return } // ここが本当に実現したいロジック c.JSON(200, book) } -
©2018 Wantedly, Inc. // GET /@:user_id/books?page=2&per=10 func ListBooks(c *gin.Context) {
userID, err := strconv.Atoi(c.Param("user_id")) // TOOD: Should handle errors page, err := strconv.Atoi(c.Query("page")) // TOOD: Should handle errors per, err := strconv.Atoi(c.Query("per")) // TOOD: Should handle errors // ... c.JSON(200, books) } (PͷͭΒ͞ query/path params "MMRVFSZQBUIQBSBNTBSFTUSJOH ‣ 63-༝དྷͷύϥϝλͯ͢stringʹͳΔ ݩσʔλ͕จࣈྻͳͷͰ ͨΓલͬͪΌͨΓલ͕ͩʜ ‣ ύϥϝλͻͱͭͻͱͭܕมʁ ৬ਓͷखʹΑΔ͔͋ͨͨΈͷ͋Δ -
©2018 Wantedly, Inc. (PͷͭΒ͞ type BookService interface { ListBooks(context.Context, *ListBooksRequest)
([]*Book, error) CreateBook(context.Context, *CreateBookRequest) (*Book, error) // ... } ࣮͍ͨ͠ͷ͜Ε͚ͩͷͣ -
©2018 Wantedly, Inc. gRPC WHAT is gRPC? gRPC? (PPHMF࡞ͬͨ31$GSBNFXPSL͕044ʹͳͬͨͷ ҎԼHSQDJPΑΓҾ༻
4JNQMFTFSWJDFEFpOJUJPO 8PSLTBDSPTTMBOHVBHFTBOEQMBUGPSNT 4UBSURVJDLMZBOETDBMF #JEJSFDUJPOBMTUSFBNJOHBOEJOUFHSBUFEBVUI -
©2018 Wantedly, Inc. gRPC WHAT is gRPC? gRPC? (PPHMF࡞ͬͨ31$GSBNFXPSL͕044ʹͳͬͨͷ ҎԼHSQDJPΑΓҾ༻
4JNQMFTFSWJDFEFpOJUJPO 8PSLTBDSPTTMBOHVBHFTBOEQMBUGPSNT 4UBSURVJDLMZBOETDBMF #JEJSFDUJPOBMTUSFBNJOHBOEJOUFHSBUFEBVUI -
©2018 Wantedly, Inc. gRPC "Simple service definition" service BookService {
rpc CreateBook (CreateBookRequest) returns (Book) {} } message Book { string book_id = 1; } message CreateBookRequest { Book book = 1; } ͜Ε͕ -
©2018 Wantedly, Inc. gRPC "Simple service definition" ͜͏ͳΔ type BookServiceServer
interface { CreateBook(context.Context, *CreateBookRequest) (*Book, error) } type Book struct { BookId string `protobuf:"..." json:"book_id,omitempty"` } type CreateBookRequest struct { Book *Book `protobuf:"..." json:"book,omitempty"` } -
©2018 Wantedly, Inc. gRPC "Simple service definition" ͜Ε͚࣮ͩ͢Ε0, type BookServiceServer
interface { CreateBook(context.Context, *CreateBookRequest) (*Book, error) } type Book struct { BookId string `protobuf:"..." json:"book_id,omitempty"` } type CreateBookRequest struct { Book *Book `protobuf:"..." json:"book,omitempty"` } -
©2018 Wantedly, Inc. gRPC "Simple service definition" ϦΫΤετ༰ͪΌΜͱߏମʹϚοϐϯάͯ͘͠ΕΔ type BookServiceServer
interface { CreateBook(context.Context, *CreateBookRequest) (*Book, error) } type Book struct { BookId string `protobuf:"..." json:"book_id,omitempty"` } type CreateBookRequest struct { Book *Book `protobuf:"..." json:"book,omitempty"` } -
©2018 Wantedly, Inc. service BookService { rpc CreateBook (CreateBookRequest) returns
(Book) {} } message Book { string book_id = 1; } message CreateBookRequest { Book book = 1; } gRPC WHY gRPC? Code generation To use protobuf as IDL (Interface Definition Language) ‣ protoc protoc-gen-go 1SPUPDPM#VGGFSTͷεΩʔϚ͔Β αʔόɾΫϥΠΞϯτͷ*'ͱ࣮Λੜ ‣ ੜ͞ΕΔαʔόͷ*'ͷ࣮Λొ grpc.Server͕ϦΫΤετΛTUSVDUʹόΠϯυ ొ࣮ͨ͠Λݺͼग़ͯ͘͠ΕΔ type BookServiceServer interface { CreateBook(context.Context, *CreateBookRequest) (*Book, error) } type Book struct { BookId string `protobuf:"..." json:"book_id,omitempty"` } type CreateBookRequest struct { Book *Book `protobuf:"..." json:"book,omitempty"` } -
©2018 Wantedly, Inc. service BookService { rpc CreateBook (CreateBookRequest) returns
(Book) {} } message Book { string book_id = 1; } message CreateBookRequest { Book book = 1; } gRPC WHY gRPC? Code generation with protoc ‣ QSPUPD QSPUPDHFOHP 1SPUPDPM#VGGFSTͷεΩʔϚ͔Β αʔόɾΫϥΠΞϯτͷ*'ͱ࣮Λੜ ‣ ੜ͞ΕΔαʔόͷ*'ͷ࣮Λొ grpc.Server͕ϦΫΤετΛTUSVDUʹόΠϯυ ొ࣮ͨ͠Λݺͼग़ͯ͘͠ΕΔ type BookServiceServer interface { CreateBook(context.Context, *CreateBookRequest) (*Book, error) } type Book struct { BookId string `protobuf:"..." json:"book_id,omitempty"` } type CreateBookRequest struct { Book *Book `protobuf:"..." json:"book,omitempty"` } ͕ࣗͨͪॻ͘ͷαʔόͷ࣮ ຊʹඞཁͳϩδοΫͷΈʹूதͰ͖Δʂ -
©2018 Wantedly, Inc. Why NOT gRPC? gRPC ͷϜζΧγ͞ H31$)551ͷίωΫγϣϯΛுΓͬͺͳ͠ʹ͢Δ
Πϯϑϥ·ΘΓͷϜζΧγ͞(SBDFGVMͳ%FQMPZ -PBE#BMBODJOH FUD 1SPUPCVGόΠφϦΛΓͱΓ͢Δ DVSM͑ͳ͍ʜ ΫϥΠΞϯτ͍··Ͱͱશ͘ҟͳΔٕज़Λ͏͜ͱʹ ߟ͑Δ͜ͱ͕ଟ͍ʂ Δ͚ͩͰ͋Δ͚ͲɼՔಇதͷαʔϏεʹυΧοͱ͍ΕΔͷେม gRPC WHY gRPC? -
©2018 Wantedly, Inc. Why NOT gRPC? gRPC ͷϜζΧγ͞ H31$)551ͷίωΫγϣϯΛுΓͬͺͳ͠ʹ͢Δ
Πϯϑϥ·ΘΓͷϜζΧγ͞(SBDFGVMͳ%FQMPZ -PBE #BMBODJOH FUD 1SPUPCVGόΠφϦΛΓͱΓ͢Δ DVSM͑ͳ͍ʜ ΫϥΠΞϯτ͍··Ͱͱશ͘ҟͳΔٕज़Λ͏͜ͱʹ ߟ͑Δ͜ͱ͕ଟ͍ʂ Δ͚ͩͰ͋Δ͚ͲɼՔಇதͷαʔϏεʹυΧοͱ͍ΕΔͷେม ύϑΥʔϚϯε໘Ұ୴ஔ͍͓͍ͯͯɼ*%-ͱDPEFHFOFSBUJPOʹΑΔੜ࢈ੑ্Λૂ͍͍ͨ Ώ͘Ώ͘H31$Λ͍͖͍ͬͯͨڭɾݕূͷͨΊɼͱΓ͋͑ͣϛχϚϜʹಋೖ͍ͨ͠ gRPC WHY gRPC? -
©2018 Wantedly, Inc. grpc-gateway WHAT is grpc-gateway? WHAT is grpc-gateway?
‣ H31$αʔόͷલஈʹཱͭSFWFSTFQSPYZ ‣ )551 +40/H31$ʹม͢Δ ‣ ࠾༻ࣄྫ FUDEʢ,VCFSOFUFTͷόοΫΤϯυʹ͍Δࢄ,74ʣ 8BOUFEMZ1FPQMFͰڈळ͘Β͍͔Βͬͦ͜Γ͍ͬͯΔ Ϣʔβ͝ͱͷઃఆΛ൚༻తͳײ͡Ͱ֨ೲ͢Δαʔό ݁ߏΆ͜Ά͜ୟ͔ΕΔ͚ͲɼݩؾʹϨεϙϯεΛฦ͍ͯ͠Δ -
©2018 Wantedly, Inc. grpc-gateway WHAT is grpc-gateway? "1*Λୟ͘ਓ͔Β )551 +40/Λ͍ͬͯΔΑ͏ʹΈ͑Δ
ैདྷ௨ΓͷڥͰ"1*Λར༻Ͱ͖Δ https://github.com/grpc-ecosystem/grpc-gateway -
©2018 Wantedly, Inc. grpc-gateway WHAT is grpc-gateway? 1SPYZͷ࣮ protoc protoc-gen-grpc-gatewayͰੜ
https://github.com/grpc-ecosystem/grpc-gateway -
©2018 Wantedly, Inc. grpc-gateway WHY grpc-gateway? WHY grpc-gateway? ͳͥHSQDHBUFXBZΛ͍͍͔ͨ ‣
ڥɾJOUFSGBDFͦͷ··ʹ H31$ͷ*%-ͱDPEFHFOSBUJPOΛར༻Ͱ͖Δʂ ‣ ʮͲ͜ʹʯʮԿΛ͛ΕʯʮԿ͕ฦͬͯ͘Δ͔ʯ *%-ΛಡΊͻͱͰ͔Δ ͍ΘΏΔʮυΩϡϝϯτʯ͕ಘΒΕΔ service BookService { rpc CreateBook (CreateBookRequest) returns (Book) { option (google.api.http) = { post: "/books" body: "book" }; } } H31$)551ͷϚοϐϯά୯७໌շ -
©2018 Wantedly, Inc. grpc-gateway WHY grpc-gateway? WHY grpc-gateway? ͳͥHSQDHBUFXBZΛ͍͍͔ͨ
͍ΘΏΔʮυΩϡϝϯτʯ͕ಘΒΕΔ *OUFSGBDF%SJWFO%FWFMPQNFOU͕࣮ݱͰ͖Δ ʢ4XBHHFS+40/4DIFNB͕ࢦͨ͠ੈքʣ service BookService { rpc CreateBook (CreateBookRequest) returns (Book) { option (google.api.http) = { post: "/books" body: "book" }; } } H31$)551ͷϚοϐϯά୯७໌շ -
©2018 Wantedly, Inc. grpc-gateway ͭΒ͍ͱ͜Ζ ͭΒ͍ͱ͜Ζᶃ QSPUPDͷίϚϯυ͕Ή͔͍ͣ͠ # gRPC サーバ
& クライアント生成 protoc \ -I ./vendor/github.com/grpc-ecosystem-grpc-gateway \ -I ./vendor/github.com/grpc-ecosystem-grpc-gateway/thrid_party/googleapis \ --go_out=plugins=grpc:. api/protos/book.proto # grpc-gateway の reverse proxy 生成 protoc \ -I ./vendor/github.com/grpc-ecosystem-grpc-gateway \ -I ./vendor/github.com/grpc-ecosystem-grpc-gateway/thrid_party/googleapis \ --grpc-gateway_out=logtostderr=true:grpc:. api/protos/book.proto -
©2018 Wantedly, Inc. grpc-gateway ͭΒ͍ͱ͜Ζ ͭΒ͍ͱ͜Ζᶄ ʮαʔόΛىಈ͢Δ·Ͱʯ͕͍ ‣ αʔόΛͭಈ͔͢ͷͰͨΓલͰ͋Δ͕ʜ
ճͷnet.Listen ͭαʔόͷηοτΞοϓɾىಈ ͭͷαʔόͷTIVUEPXOॲཧʜ ‣ ࠓճͷείʔϓ͋͘·Ͱʮੜ࢈ੑΛ্͛Δʯ͜ͱ ֤ΤϯυϙΠϯτ࣮ͷੜ࢈ੑ্͕ͬͯɼ࠷ॳ͕ͩΔ͍ͱαʔϏε࡞Δ͜ͱࣗମ͕ԯ߷ʹͳΔʜ -
©2018 Wantedly, Inc. 8SJUJOH+40/"1*JO(P ຊ࣭͡Όͳ͍ίʔυΛͨ͘͞Μॻ͔ͳ͍ͱ͍͚ͳ͍ H31$*%- $PEFHFOFSBUJPO
)JHIQFSGPSNBODF ҰํͰɼ͍ΖΜͳલ४උ͕ඞཁʹͳΔ ੜ࢈ੑΛ্͛Δ͜ͱΛ༏ઌ͍ͨ͠*%-ͱDPEFHFOFSBUJPO͚ͩ͏ HSQDHBUFXBZNBQTH31$UP)551 +40/ H31$Λ͍ͭͷڥͰར༻Մೳ ͔͠͠ɼϓϩδΣΫτͷελʔτμογϡ͕ಷ͘ͳͬͯ͠·͏ʜ grapi ͜͜·Ͱͷཧ -
©2018 Wantedly, Inc. 8SJUJOH+40/"1*JO(P ຊ࣭͡Όͳ͍ίʔυΛͨ͘͞Μॻ͔ͳ͍ͱ͍͚ͳ͍ H31$*%- $PEFHFOFSBUJPO
)JHIQFSGPSNBODF ҰํͰɼ͍ΖΜͳલ४උ͕ඞཁʹͳΔ ੜ࢈ੑΛ্͛Δ͜ͱΛ༏ઌ͍ͨ͠*%-ͱDPEFHFOFSBUJPO͚ͩ͏ HSQDHBUFXBZNBQTH31$UP)551 +40/ H31$Λ͍ͭͷڥͰར༻Մೳ ͔͠͠ɼϓϩδΣΫτͷελʔτμογϡ͕ಷ͘ͳͬͯ͠·͏ʜ grapi ͜͜·Ͱͷཧ -
©2018 Wantedly, Inc. grapi WHAT is grapi? grapi ಡΈํʮ͙ΒͬͽʯΒ͍͠ ‣
IUUQTHJUIVCDPNJ[VNJOHSBQJ ‣ ʮߟ͑Δ͜ͱΛݮΒ͢ʯ͜ͱͰ ੜ࢈ੑΛ͋͛ΔͨΊͷ$-*QBDLBHF (FOFSBUFTQSPKFDUTLFMFUPO (FOFSBUFTTFSWJDFTLFMFUPOT 8SBQTQSPUPD -
©2018 Wantedly, Inc. grapi WHAT is grapi? grapi init SBJMTOFXతͳ
‣ ϓϩδΣΫτͷεέϧτϯੜ ‣ ྃޙʹʮHSBQJTFSWFSʯΛ࣮ߦ͢Ε αʔό͕ىಈ͢Δঢ়ଶʹͳΔ [~/src/github.com/izumin5210-sandbox/sampleapp] :) % grapi init . ➜ Initialize project ✔ .gitignore ✔ Gopkg.toml ✔ grapi.toml ✔ api/protos/.keep ✔ app/run.go ✔ app/server/.keep ✔ cmd/server/run.go ▸ Install dependencies Root project is "github.com/izumin5210-sandbox/sampleapp" 2 transitively valid internal packages 4 external packages imported from 3 projects (0) ✓ select (root) (1) ? attempt github.com/golang/protobuf with 1 pkgs; 3 (1) try github.com/golang/[email protected] -
©2018 Wantedly, Inc. grapi WHAT is grapi? grapi g service
SBJMTHDPOUSPMMFSతͳ ‣ H31$TFSWJDFͷεέϧτϯੜ 1SPUPCVGͱ(Pͷαʔό࣮ͷ͕Ͱ͖Δ QSPUPDͷ࣮ߦͬͯ͘ΕΔʢޙड़ʣ ‣ ͋ͱΛຒΊΔ͚ͩΈ͍ͨͳঢ়ଶ ‣ grapi g scaffold-serviceʹ͢Δͱ "1*ઃܭΨΠυͷඪ४ϝιου͕ શͯἧͬͨঢ়ଶʹͳΔʢޙड़ʣ [~/src/github.com/izumin5210-sandbox/sampleapp] :) % grapi g scaffold-service book ➜ Scaffold service ✔ api/protos/book.proto ✔ app/server/book_server.go ✔ app/server/book_server_register_funcs.go ✔ app/server/book_server_test.go ➜ Execute protoc ▸ Install plugins ✔ protoc-gen-go ✔ protoc-gen-grpc-gateway ✔ protoc-gen-swagger ▸ Execute protoc ✔ api/protos/book.proto -
©2018 Wantedly, Inc. grapi WHAT is grapi? API Design Guide
͍͍"1*࡞ΔͨΊͷΨΠυϥΠϯCZ(PPHMF ‣ ͍͍"1*Λ࡞ΔͨΊͷΞϨίϨ͕ॻ͍ͯ͋Δ H31$ϕʔεH31$ʹ׳Εͯͳ͍ਓಡΉͱྑ͍ ‣ ඪ४ϝιου ͍ΘΏΔ$36%࣮ݱʹඞཁͳϝιου܈ /BNJOH 3FRVFTU 3FTQPOTFͷܗࣜͳͲΛఆٛ API ઃܭΨΠυ https://cloud.google.com/apis/design/ -
©2018 Wantedly, Inc. grapi WHAT is grapi? grapi protoc ͏QSPUPDͷҾ֮͑ͳͯ͘େৎ
‣ grapi.tomlΈ͍͍ͯײ͡ʹ QMVHJOͷϏϧυ api/protos/**/*.protoAʹରͯ͠protoc࣮ߦ Ҿ͍͍ײ͡ʹΈཱͯΒΕΔ [protoc] protos_dir = "./api/protos" out_dir = "./api" import_dirs = [ "./vendor/github.com/grpc-ecosystem/grpc-gateway", "./vendor/github.com/grpc-ecosystem/grpc-gateway/third_party/googleapis", ] [[protoc.plugins]] path = "./vendor/github.com/golang/protobuf/protoc-gen-go" name = "go" args = { plugins = "grpc" } [[protoc.plugins]] path = "./vendor/github.com/grpc-ecosystem/grpc-gateway/protoc-gen-grpc-gat name = "grpc-gateway" args = { logtostderr = true } [[protoc.plugins]] path = "./vendor/github.com/grpc-ecosystem/grpc-gateway/protoc-gen-swagger" name = "swagger" args = { logtostderr = true } -
©2018 Wantedly, Inc. grapi WHAT is grapi? αʔόͷىಈ αʔό࣮ͷొճͰ͍͍Α ‣
grapiserver.New()Έ͍͍ͯײ͡ʹઃఆ ىಈϙʔτͱ͔ *OUFSDFQUPSͱ͔ ‣ ࣮ͷొA8JUI4FSWFSTAʹ͚ͩ͢ ͦΕ͚ͩͰ͍͍Α͏ʹίʔυ͕ੜ͞Ε͍ͯΔ func Run() error { s := grapiserver.New( grapiserver.WithDefaultLogger(), grapiserver.WithServers( server.NewBookServiceServer(), // <= これ ), ) return s.Serve() } -
©2018 Wantedly, Inc. grapi WHAT is grapi? αʔόͷىಈ Ωϛ͚ͩͷ࠷ڧͷΦϓγϣϯΛ࡞Ζ͏ ‣
ΊͬͪΌ͍Ζ͍Ζͬͯ͘ΕΔຐ๏ͷΦϓγϣϯ Λఏڙ͢Δύοέʔδ͕ଘࡏʢQSJWBUFʣ ΞΫηεϩΪϯάͱ͔ ϝτϦΫεͱ͔ ΤϥʔϨϙʔςΟϯάͱ͔ ‣ ͜Ε·ͨͷػձʹ͓͠·͢ ؾʹͳΔਓΛฉ͖ʹདྷ͍ͯͩ͘͞ʣ func Run() error { defer servicex.Close() s := grapiserver.New( servicex.WithDefault(), // <= これ grapiserver.WithServers( server.NewBookServiceServer(), ), ) return s.Serve() } -
©2018 Wantedly, Inc. grapi WHY grapi? Design philosophy of grapi
HSBQJͷࢥͱ͔ ‣ ࢦ͢rails newͱrails g create-react-app ֤ΤϯυϙΠϯτͷ࣮͚ͩॻ͚͍͍ੈք ‣ ʮϑϧελοΫʯʹ͠ͳ͍ .JDSPTFSWJDFͰ͏ͨΊʹ࡞ͬͨ ͳΔ͘খ͍͞ͷ͕Ͱ͖ΔΑ͏ʹͳ͍ͬͯΕɼͬͯؾܰʹࣺͯΒΕΔ 4NBMMJT#FBVUJGVM -
©2018 Wantedly, Inc. grapi WHY grapi? Design philosophy of grapi
HSBQJͷࢥͱ͔ ‣ ҰํͰɼ03.)551$MJFOUͷΑ͏ͳࡉ͔͍ʹ౿Έࠐ·ͳ͍ .JDSPTFSWJDF͚ͳͷͰɼ3%#͡Όͳ͍͓͠ΖόοΫΤϯυΛ࣋ͬͯΔέʔε͋Δ 03.ʹݶͬͯݴ͑ɼσϑΝΫτ͕ͳ͍ 3BJMTͷ"DUJWF3FDPSEͷΑ͏ͳҟৗͳੜ࢈ੑ্͕ݟࠐΊΔͷ͕ͳ͍ ʢҰํͰɼQMVHJOػߏ͚ͭͯ֎͚ରԠ͍͍͔ͬͯʣ -
©2018 Wantedly, Inc. 8SJUJOH+40/"1*JO(P ຊ࣭͡Όͳ͍ίʔυΛͨ͘͞Μॻ͔ͳ͍ͱ͍͚ͳ͍ H31$*%- $PEFHFOFSBUJPO
)JHIQFSGPSNBODF ҰํͰɼ͍ΖΜͳલ४උ͕ඞཁʹͳΔ ੜ࢈ੑΛ্͛Δ͜ͱΛ༏ઌ͍ͨ͠*%-ͱDPEFHFOFSBUJPO͚ͩ͏ HSQDHBUFXBZNBQTH31$UP)551 +40/ H31$Λ͍ͭͷڥͰར༻Մೳ ͔͠͠ɼϓϩδΣΫτͷελʔτμογϡ͕ಷ͘ͳͬͯ͠·͏ʜ Conclusion ղܾ͔ͨͬͨ͠ -
©2018 Wantedly, Inc. HSBQJ$PEFHFOSBUPSBOEHPQBDLBHFUPSFEVDFCPJMFSQMBUFT CPJMFQMBUFΛ໓QSPUPD·ΘΓͷࡶ͞ΛӅṭ ͍͍ײ͡ͷίʔυδΣωϨʔλ
ߟ͑Δ͜ͱΛݮΒͤΔͷͰɼຊ࣭తͳ࣮ʹूதͰ͖Δ ં֯ͷϚΠΫϩαʔϏεΞʔΩςΫνϟͳͷͰɼ ಛੑΛཧղ͠దͳٕज़બఆΛ৺͕͚ͯ)BQQZ)BDLJOH͠Α͏ Conclusion ՝ղܾ & ·ͱΊ