"gRPC-Web: It’s All About Communication": Devoxx Belgium 2019
•
1 gostou•705 visualizações
Slides of our Devoxx 2019 talk "gRPC-Web: It’s All About Communication"
Recomendados
Recomendados
Mais conteúdo relacionado
Mais procurados
Mais procurados (20)
Semelhante a "gRPC-Web: It’s All About Communication": Devoxx Belgium 2019
Semelhante a "gRPC-Web: It’s All About Communication": Devoxx Belgium 2019 (20)
Mais de Alex Borysov
Mais de Alex Borysov (6)
Último
Último (20)
"gRPC-Web: It’s All About Communication": Devoxx Belgium 2019
- 1. gRPC-Web: It’s All About Communication DEVOXX, NOVEMBER 7, 2019 Alex BORYSOV Yevgen GOLUBENKO
- 2. @aiborisov @HalloGene_ Images contained in this presentation are the property of Netflix Inc. and cannot be reused
- 17. “DOCS ARE UP TO DATE” THEY SAID @aiborisov @HalloGene_
- 26. @aiborisov @HalloGene_ API DEFINITIONS syntax = "proto3"; service FixtureService { // Return next line of geese and clouds rpc GetFixture (GetFixtureRequest) returns (FixtureResponse); } service LeaderboardService { // Returns current top scores rpc GetTopScores (TopScoresRequest) returns (TopScoresResponse); // Updates a single player's score rpc UpdateScore (UpdateScoreRequest) returns (UpdateScoreResponse); }
- 27. @aiborisov @HalloGene_ API DEFINITIONS syntax = "proto3"; service FixtureService { // Return next line of geese and clouds rpc GetFixture (GetFixtureRequest) returns (FixtureResponse); } service LeaderboardService { // Returns current top scores rpc GetTopScores (TopScoresRequest) returns (TopScoresResponse); // Updates a single player's score rpc UpdateScore (UpdateScoreRequest) returns (UpdateScoreResponse); }
- 28. @aiborisov @HalloGene_ API DEFINITIONS syntax = "proto3"; service FixtureService { // Return next line of geese and clouds rpc GetFixture (GetFixtureRequest) returns (FixtureResponse); } service LeaderboardService { // Returns current top scores rpc GetTopScores (TopScoresRequest) returns (TopScoresResponse); // Updates a single player's score rpc UpdateScore (UpdateScoreRequest) returns (UpdateScoreResponse); }
- 29. APIs code reviews Language-neutral contract @aiborisov @HalloGene_ PROTO API FIRST
- 30. APIs code reviews Language-neutral contract APIs DON’T LIE @aiborisov @HalloGene_ PROTO API FIRST
- 32. @aiborisov @HalloGene_ ● Java ● Go ● C/C++ ● C# ● Node.js ● PHP ● Ruby ● Python ● Dart ● Objective-C gRPC SPEAKS YOUR LANGUAGE
- 33. @aiborisov @HalloGene_ ● Linux ● MacOS ● Windows ● Android ● iOS ● Web gRPC CODE GEN
- 34. @aiborisov @HalloGene_ ● Linux ● MacOS ● Windows ● Android ● iOS ● Web gRPC CODE GEN
- 36. @aiborisov @HalloGene_ gRPC-WEB CODE GEN $ protoc -I=$DIR gateway.proto --js_out=import_style=commonjs:$OUT_DIR --grpc-web_out=import_style=commonjs, mode=grpcwebtext:$OUT_DIR
- 37. @aiborisov @HalloGene_ gRPC-WEB CODE GEN $ protoc -I=$DIR gateway.proto --js_out=import_style=commonjs:$OUT_DIR --grpc-web_out=import_style=commonjs, mode=grpcwebtext:$OUT_DIR
- 38. @aiborisov @HalloGene_ gRPC-WEB CODE GEN $ protoc -I=$DIR gateway.proto --js_out=import_style=commonjs:$OUT_DIR --grpc-web_out=import_style=commonjs, mode=grpcwebtext:$OUT_DIR
- 39. @aiborisov @HalloGene_ gRPC-WEB CODE GEN $ protoc -I=$DIR gateway.proto --js_out=import_style=commonjs:$OUT_DIR --grpc-web_out=import_style=commonjs, mode=grpcwebtext:$OUT_DIR Supported import styles: closure, commonjs, commonjs+dts, typescript
- 40. @aiborisov @HalloGene_ https://github.com/grpc/grpc/blob/ master/doc/PROTOCOL-HTTP2.md Requests / Responses HTTP/2 Transport Mapping Connection Management Security Error Handling gRPC over HTTP/2
- 43. @aiborisov @HalloGene_ WE NEED A GATE!
- 44. @aiborisov @HalloGene_ gRPC-Web Spec https://github.com/grpc/grpc/blob/ master/doc/PROTOCOL-WEB.md Support any HTTP/* Support web-specific features Can became optional with WHATWG Streams Standard (future) WE NEED A GATE!
- 45. @aiborisov @HalloGene_ GATEWAY gRPC Web Stub gRPC Service GATEWAY.PROTO gRPC-Web HTTP/2HTTP/1* PROXY
- 46. @aiborisov @HalloGene_ GATEWAY gRPC Web Stub gRPC Service GATEWAY.PROTO gRPC-Web HTTP/2HTTP/1* PROXY
- 47. @aiborisov @HalloGene_ ENVOY CONFIG (envoy.yaml) static_resources: listeners: filter_chains: - filters: - name: envoy.http_connection_manager config: route_config: virtual_hosts: - name: local_service cors: allow_origin: - "*" allow_methods: GET, PUT, DELETE, POST, OPTIONS allow_headers: … , x-grpc-web, grpc-timeout, x-accept-response-streaming expose_headers: grpc-status,grpc-message,custom-header-1 http_filters: - name: envoy.grpc_web - name: envoy.cors - name: envoy.router
- 48. @aiborisov @HalloGene_ ENVOY CONFIG (envoy.yaml) cors: allow_origin: - "*" allow_methods: GET, PUT, DELETE, POST, OPTIONS allow_headers: … , x-grpc-web, grpc-timeout, x-accept-response-streaming expose_headers: grpc-status,grpc-message,custom-header-1 http_filters: - name: envoy.grpc_web - name: envoy.cors - name: envoy.router
- 49. @aiborisov @HalloGene_ ENVOY CONFIG (envoy.yaml) cors: allow_origin: - "*" allow_methods: GET, PUT, DELETE, POST, OPTIONS allow_headers: … , x-grpc-web, grpc-timeout, x-accept-response-streaming expose_headers: grpc-status,grpc-message,custom-header-1 http_filters: - name: envoy.grpc_web - name: envoy.cors - name: envoy.router
- 50. @aiborisov @HalloGene_ ENVOY CONFIG (envoy.yaml) cors: allow_origin: - "*" allow_methods: GET, PUT, DELETE, POST, OPTIONS allow_headers: … , x-grpc-web, grpc-timeout, x-accept-response-streaming expose_headers: grpc-status,grpc-message,custom-header-1 http_filters: - name: envoy.grpc_web - name: envoy.cors - name: envoy.router
- 51. @aiborisov @HalloGene_ ENVOY PROXY Fault Tolerance Service Discovery Load Balancing Health Checking
- 52. gRPC Service gRPC Stub @aiborisov @HalloGene_ gRPC over HTTP/* gRPC Service gRPC Stub gRPC- Web Stub
- 59. CLI tools GUI tools Testing tools and more @aiborisov @HalloGene_ gRPC ECOSYSTEM
- 62. API CHANGES @aiborisov @HalloGene_ message repeated repeated message int32 + GooseType goose_type = 2;
- 63. API CHANGES: SAFELY ADD/REMOVE FIELDS @aiborisov @HalloGene_
- 65. @aiborisov @HalloGene_ UNCOVER THE TRUTH: SERVER REFLECTION API syntax = "proto3"; service ServerReflection { rpc ListApis (ListApisRequest) returns (ListApisResponse); rpc GetMethod (GetMethodRequest) returns (GetMethodResponse); }
- 66. @aiborisov @HalloGene_ UNCOVER THE TRUTH: SERVER REFLECTION API val grpcServer = ServerBuilder.forPort(SERVER_PORT) .addService(fixtureService) .addService(leaderboardService) .addService(ProtoReflectionService.newInstance()) .build();
- 67. @aiborisov @HalloGene_ UNCOVER THE TRUTH: SERVER REFLECTION API val grpcServer = ServerBuilder.forPort(SERVER_PORT) .addService(fixtureService) .addService(leaderboardService) .addService(ProtoReflectionService.newInstance()) .build();
- 68. @aiborisov @HalloGene_ UNCOVER THE TRUTH: SERVER REFLECTION API $ grpcurl -plaintext $GATEWAY:8080 list game.FixtureService game.LeaderboardService grpc.reflection.v1alpha.ServerReflection
- 69. @aiborisov @HalloGene_ UNCOVER THE TRUTH: SERVER REFLECTION API $ grpcurl -plaintext $GATEWAY:8080 describe game.FixtureService game.FixtureService is a service: service FixtureService { rpc GetFixture ( .game.GetFixtureRequest ) returns ( .game.FixtureResponse ); }
- 70. @aiborisov @HalloGene_ UNCOVER THE TRUTH: SERVER REFLECTION API $ grpcurl -plaintext $GATEWAY:8080 describe game.FixtureResponse game.FixtureResponse is a message: message FixtureResponse { repeated .game.FixtureLine lines = 1; }
- 71. @aiborisov @HalloGene_ gRPC TIMEOUT generatePlayerId = () => { const request = new GeneratePlayerIdRequest(); const metadata = {}; return playerIdServicePromiseClient.generatePlayerId(request, metadata); }
- 72. @aiborisov @HalloGene_ gRPC DEADLINE generatePlayerId = () => { const request = new GeneratePlayerIdRequest(); const deadline = (new Date()).getTime() + timeoutInMillis; const metadata = { deadline }; return playerIdServicePromiseClient.generatePlayerId(request, metadata); }
- 79. Canonical gRPC Status Codes Deadline Support Deadline Propagation @aiborisov @HalloGene_ gRPC ERROR CODES
- 81. @aiborisov @HalloGene_ One request, one response Requests can be redundant Polling interval? API: UNARY
- 82. @aiborisov @HalloGene_ One request, multiple responses Real-time updates gRPC-Web: supports server-side streaming API: STREAMING
- 83. @aiborisov @HalloGene_ gRPC-WEB STREAMING syntax = "proto3"; service LeaderboardService { // Returns current top scores rpc GetTopScores (TopScoresRequest) returns (TopScoresResponse); // Updates a single player's score rpc UpdateScore (UpdateScoreRequest) returns (UpdateScoreResponse); }
- 84. @aiborisov @HalloGene_ gRPC-WEB STREAMING syntax = "proto3"; service LeaderboardService { // Returns current top scores rpc GetTopScores (TopScoresRequest) returns (TopScoresResponse); // Subscribes to top scores updates rpc StreamTopScores (TopScoresRequest) returns (stream TopScoresResponse); // Updates a single player's score rpc UpdateScore (UpdateScoreRequest) returns (UpdateScoreResponse); }
- 87. @aiborisov @HalloGene_ gRPC-WEB THINGS Canonical proto APIs No more handcrafted JSONs Canonical status codes Server streaming Well-defined domain methods
- 88. SPECIAL THANKS: MYKYTA PROTSENKO @aiborisov @HalloGene_
- 89. SPECIAL THANKS: THE STRANGER THINGS CREW @aiborisov @HalloGene_