Robert Goik: Wszyscy kochamy type systems. TypeScript jest świetny, przenosi rozwijanie doświadczenia na zupełnie nowy poziom. GraphQL to system typów dla naszego API. W trakcie prezentacji, Robert spróbuje wycisnąć z niego jeszcze więcej za pomocą Apollo Federation. Wspólnie poszukamy odpowiedzi na pytanie o implementację GraphQL w architekturze rozproszonej.

1. My recipe for a scalable
microservices architecture?
Apollo Federation and GraphQL
Robert Goik

2. REST vs GraphQL
VS

3. REST vs GraphQL?

4. RESTful API
https://martinfowler.com/articles/richardsonMaturityModel.html

5. GraphQL
https://spec.graphql.org/
“This is the speci+ication for GraphQL, a query language
and execution engine originally created at Facebook in
2012 for describing the capabilities and requirements of
data models for client-server applications.”

6. THE MONOLITHS

7. MICROSERVICES

8. API GATEWAY PATTERN

9. https://github.com/roberuto/citadel-of-ricks

10. auth service
https://github.com/roberuto/citadel-of-ricks

11. characters service
auth service
https://github.com/roberuto/citadel-of-ricks

12. characters service
auth service
pick-a-rick service
https://github.com/roberuto/citadel-of-ricks

13. characters service
auth service
pick-a-rick service
gateway
https://github.com/roberuto/citadel-of-ricks

14. characters service
auth service
pick-a-rick service
gateway
No CI/CD
Lack of validation :)
https://github.com/roberuto/citadel-of-ricks

15. schema stitching
imperative code
new monolit

16. APOLLO FEDERATION

18. Apollo Federation
gateway

19. Principled GraphQL
INTEGRITY PRINCIPLES
1. One Graph
2. Federated Implementation
3. Track the Schema in a Registry
https://principledgraphql.com/

20. INTEGRITY PRINCIPLES
One Graph
“Your company should have one unified graph,
instead of multiple graphs created by each team.”
https://principledgraphql.com/

21. INTEGRITY PRINCIPLES
Federated Implementation
“Though there is only one graph, the implementation of that
graph should be federated across multiple teams.”
https://principledgraphql.com/

22. INTEGRITY PRINCIPLES
Track the Schema in a Registry
“There should be a single source of truth for
registering and tracking the graph.”
https://principledgraphql.com/

23. Principled GraphQL
AGILITY PRINCIPLES
4. Abstract, Demand-Oriented Schema
5. Use an Agile Approach to Schema Development
6. Iteratively Improve Performance
7. Use Graph Metadata to Empower Developers
https://principledgraphql.com/

24. AGILITY PRINCIPLES
Abstract, Demand-Oriented Schema
“The schema should act as an abstraction layer that
provides flexibility to consumers while hiding
service implementation details.”
https://principledgraphql.com/

25. AGILITY PRINCIPLES
Use an Agile Approach to Schema Development
“The schema should be built incrementally based
on actual requirements and evolve smoothly over time.”
https://principledgraphql.com/

26. AGILITY PRINCIPLES
Iteratively Improve Performance
“Performance management should be a continuous,
data-driven process, adapting smoothly to changing
query loads and service implementations.”
https://principledgraphql.com/

27. AGILITY PRINCIPLES
Use Graph Metadata to Empower Developers
“Developers should be equipped with
rich awareness of the graph throughout the entire
development process.”
https://principledgraphql.com/

28. Principled GraphQL
OPERATIONS PRINCIPLES
8. Access and Demand Control
9. Structured Logging
10. Separate the GraphQL Layer from the Service Layer
https://principledgraphql.com/

29. OPERATIONS PRINCIPLES
Access on Demand Control
“Grant access to the graph on a per-client basis,
and manage what and how clients can access it.”
https://principledgraphql.com/

30. OPERATIONS PRINCIPLES
Structured Logging
“Capture structured logs of all graph operations
and leverage them as the primary tool for
understanding graph usage.”
https://principledgraphql.com/

31. OPERATIONS PRINCIPLES
Separate the GraphQL Later from Service Layer
“Adopt a layered architecture with data graph
functionality broken into a separate tier rather
than baked into every service.”
https://principledgraphql.com/

32. SHOW ME…

33. Schema - supergraph

34. Directives
● GRAPHQL
@include, @skip, @deprecated, @specifiedBy
● APOLLO FEDERATION
@key, @external, @requires, @provides, @extends,

35. Entities
DIRECTIVES: @key
characters service

36. Extending entities
DIRECTIVES: @key, @external, @requires
pick-a-rick service

37. Schema - supergraph
pick-a-rick service
characters service
Entity “owner”

38. @extends directive?
“Some libraries such as graphql-java don't have native support
for type extensions in their printer. Apollo Federation supports
using an @extends directive in place of extend type to annotate
type references|”
https://www.apollographql.com/docs/federation/federation-spec/
DIRECTIVES: @extends

39. @requires
“You cannot require fields that are defined in a subgraph besides
the entity's originating subgraph.”
DIRECTIVES: @requires

40. @provides
DIRECTIVES: @provides
inventory
products
“Each subgraph that @provides a field must also define a resolver
for that field. That resolver's behavior must match the behavior of
the resolver in the field's originating subgraph.”

41. Services
Auth
Web App
NO!
Characters PickARick
Gateway

42. Reference resolvers
characters service

43. Schema - subgraphs
auth service pick-a-rick service

44. Species status resolver
pick-a-rick service

46. with speciesStatus
without speciesStatus

48. NO federated services

49. Federated services

50. gateway

51. Apollo Federation - subscriptions
Apollo Server 3 removes built-in
support for subscriptions
Subscriptions are not currently
supported in Apollo Federation.
https://www.apollographql.com/docs/apollo-server/data/subscriptions/

52. gateway - ApolloGateway

53. gateway - ApolloGateway, PRODUCTION?

54. gateway - ApolloGateway, PRODUCTION?
CURIOUS?

55. ROVER

56. Supergraph - YAML config file

57. Rover CLI - compose supergraph

58. gateway - ApolloGateway, PRODUCTION

59. Apollo Studio - PRODUCTION 2.0

60. Apollo Studio

61. Rover

62. Cannot use Apollo Studio?

63. Customize gateway’s data

64. Authorization - MUTATION
auth service

65. Authorization - TOKEN

66. QueryPlan

67. ApolloServer - authorization
gateway
decoded JWT
token
passthrough

68. ApolloGateway - authorization
gateway

69. ApolloServer - authMiddleware
gateway auth server

70. graphql-shield - permissions
pick-a-rick service

71. graphql-shield - middleware
pick-a-rick service

72. THANK YOU