7-11-23 - [RivieraDev] - Avoiding Common Pitfalls with Modern Microservices Testing

Have you ever wondered why your microservices break in production after all the tests have passed during CI/CD? Have you ever wondered if you’re testing too much or too little? If you want to learn about common pitfalls and how to catch them at build time rather than at runtime, this session is for you!

In this session, I’ll share some common battle scars from my experiences in the field. Additionally, I will introduce the testing pyramid and explain why it is important in helping to continuously deploy microservices independently without fear. I will demonstrate, through a test-driven development approach, how the combination of Pact contract testing combined with Quarkus developer joy can help prevent your microservices from breaking in production.

Transcript

1. Eric Deandrea Sr. Principal Developer Advocate Red Hat @edeandrea Avoiding common pitfalls with modern microservices testing Drawings courtesy of Holly Cummins
2. @edeandrea #RedHat #RivieraDev2023
3. @edeandrea #RedHat #RivieraDev2023 “Every time we touch one microservice, all the others break.”
4. @edeandrea #RedHat #RivieraDev2023
5. @edeandrea #RedHat #RivieraDev2023 “My end-to-end test environment is only up the third weekend every month.”
6. @edeandrea #RedHat #RivieraDev2023 Disclaimer!
7. @edeandrea #RedHat #RivieraDev2023 Disclaimer! I am not a tester. (or even test expert)
8. @edeandrea #RedHat #RivieraDev2023 Disclaimer! I am not a tester. (or even test expert) That’s ok– testing is every developer’s job!
9. @edeandrea #RedHat #RivieraDev2023 Why is testing microservices so hard?
10. @edeandrea #RedHat #RivieraDev2023 Netflix microservice architecture
11. @edeandrea #RedHat #RivieraDev2023 Death star “That’s no moon. It’s our architecture.”
12. @edeandrea #RedHat #RivieraDev2023 Do microservices solve all problems?
13. @edeandrea #RedHat #RivieraDev2023 A microservice system: a portrait
16. @edeandrea #RedHat #RivieraDev2023 Netflix microservice architecture
17. @edeandrea #RedHat #RivieraDev2023 Netflix microservice architecture Testing with microservices is easy!
18. @edeandrea #RedHat #RivieraDev2023 Netflix microservice architecture Testing with microservices is easy! My services are so small! Everything is decoupled!
19. @edeandrea #RedHat #RivieraDev2023 Netflix microservice architecture Testing with microservices is easy! My services are so small! Everything is decoupled! But….. If you only test the points, And not the lines…. Does the thing actually work?
20. @edeandrea #RedHat #RivieraDev2023 distributed != decoupled
21. @edeandrea #RedHat #RivieraDev2023 Understand the coupling
22. @edeandrea #RedHat #RivieraDev2023 “It is all that is left unsaid upon which tragedies are built.” - Kreia, Star Wars Knights of the Old Republic II: The Sith Lords
23. @edeandrea #RedHat #RivieraDev2023
24. @edeandrea #RedHat #RivieraDev2023 This is not the answer.
25. @edeandrea #RedHat #RivieraDev2023 “You lied to me. How many other lies have I been told by the Council? And how do you know that you even have the truth?” – Anakin Skywalker
26. @edeandrea #RedHat #RivieraDev2023 “Many of the truths that we cling to depend on our viewpoint.” — Obi-Wan Kenobi, Return of the Jedi
27. @edeandrea #RedHat #RivieraDev2023 “In my book, experience outranks everything.” — Captain Rex, The Clone Wars
28. @edeandrea #RedHat #RivieraDev2023 Ok, so how do we try these out?
29. @edeandrea #RedHat #RivieraDev2023 Get good at testing.
30. @edeandrea #RedHat #RivieraDev2023 Get good at testing. And automation.
32. end-to-end tests high realism high value
33. end-to-end tests unit tests low effort high realism high value
34. end-to-end tests unit tests integration tests low effort high realism high value
35. end-to-end tests unit tests integration tests low effort high realism
36. end-to-end tests unit tests integration tests low effort high realism tests with application server test REST endpoints tests with a database
37. @edeandrea #RedHat #RivieraDev2023 their code our code Why mocks aren’t enough
38. @edeandrea #RedHat #RivieraDev2023 our mock our code Why mocks aren’t enough
39. @edeandrea #RedHat #RivieraDev2023 our mock our code ✔ tests Why mocks aren’t enough
40. @edeandrea #RedHat #RivieraDev2023 our mock our code Why mocks aren’t enough
41. @edeandrea #RedHat #RivieraDev2023 our mock our code ✔ tests ✘ reality our code their actual code Why mocks aren’t enough
42. @edeandrea #RedHat #RivieraDev2023 a mock stormtrooper
43. @edeandrea #RedHat #RivieraDev2023 a mock stormtrooper “Aren’t you a little short for a stormtrooper?” – Princess Leia
44. @edeandrea #RedHat #RivieraDev2023 https://www.flickr.com/photos/jdhancock/4811282106 Source: https://medium.com/jung-skywalker/star-wars-symbology-luke-han-and-how-to-face-the-abyss-e9fa966319b5
45. @edeandrea #RedHat #RivieraDev2023 Demo The limitations of unit tests https://github.com/edeandrea/pact-quarkus-wookie-carpet-demo
46. @edeandrea #RedHat #RivieraDev2023 “Will someone get this big walking carpet out of my way?” – Princess Leia Demo The limitations of unit tests https://github.com/edeandrea/pact-quarkus-wookie-carpet-demo
47. @edeandrea #RedHat #RivieraDev2023 “Will someone get this big walking carpet out of my way?” – Princess Leia Demo The limitations of unit tests https://github.com/edeandrea/pact-quarkus-wookie-carpet-demo
48. @edeandrea #RedHat #RivieraDev2023 A potential solution
49. @edeandrea #RedHat #RivieraDev2023 How to test a fire alarm?
50. @edeandrea #RedHat #RivieraDev2023
51. @edeandrea #RedHat #RivieraDev2023 How NOT to test a fire alarm!
52. @edeandrea #RedHat #RivieraDev2023
54. Unit testing a fire alarm
55. @edeandrea #RedHat #RivieraDev2023 uh … is that enough?
56. @edeandrea #RedHat #RivieraDev2023
57. @edeandrea #RedHat #RivieraDev2023 contract testing a fire alarm
58. Photo: https://www.westcoastfirepits.com/shop/death-star
59. Photo: https://www.westcoastfirepits.com/shop/death-star How to SAFELY burn a Death Star!
60. end-to-end tests unit tests integration tests low effort high realism high value
61. end-to-end tests unit tests integration tests low effort high realism high value contract tests
62. @edeandrea #RedHat #RivieraDev2023 our code their code A better mock
63. @edeandrea #RedHat #RivieraDev2023 our code their code contract test mock functional test A better mock
64. @edeandrea #RedHat #RivieraDev2023 ✔ our tests ✔ their tests ✔ reality our code their code contract test mock functional test A better mock
65. @edeandrea #RedHat #RivieraDev2023 our code their code A better mock
66. @edeandrea #RedHat #RivieraDev2023 our code their code contract test mock functional test A better mock
67. @edeandrea #RedHat #RivieraDev2023 ✔ our tests ✘ their tests ✘ reality our code their code contract test mock functional test A better mock
68. @edeandrea #RedHat #RivieraDev2023 A better mock our code their code
69. @edeandrea #RedHat #RivieraDev2023 A better mock our code their code contract test mock functional test
70. @edeandrea #RedHat #RivieraDev2023 ✘ our tests ✔ their tests ✘ reality A better mock our code their code contract test mock functional test
71. @edeandrea #RedHat #RivieraDev2023 Pact Contract Testing
72. @edeandrea #RedHat #RivieraDev2023 Demo
73. @edeandrea #RedHat #RivieraDev2023 “Help me, Pact! You’re my only hope!” – Princess Leia (almost) Demo
74. @edeandrea #RedHat #RivieraDev2023 “Uh, you’re telling me that consumers can break a provider’s tests?”
76. @edeandrea #RedHat #RivieraDev2023 Consumer-driven contract testing
77. @edeandrea #RedHat #RivieraDev2023 consumer Consumer-driven contract testing
78. @edeandrea #RedHat #RivieraDev2023 contract consumer tests mock declare (Pact) Pact file Consumer-driven contract testing Spring Cloud Contract Pact
79. @edeandrea #RedHat #RivieraDev2023 contract consumer tests provider mock declare (Pact) contract tests verify Pact file Consumer-driven contract testing Spring Cloud Contract Pact Pact
80. @edeandrea #RedHat #RivieraDev2023 contract consumer tests provider mock declare (Pact) contract tests verify Pact file Consumer-driven contract testing ☑ rich semantic testing Spring Cloud Contract Pact Pact
81. @edeandrea #RedHat #RivieraDev2023 contract consumer tests provider mock declare (Pact) contract tests verify Pact file Consumer-driven contract testing ☑ rich semantic testing ☑ provider can ‘develop to the contract’ instead of developing speculatively (TDD) Spring Cloud Contract Pact Pact
82. @edeandrea #RedHat #RivieraDev2023 contract consumer tests provider mock declare (Pact) contract tests verify Pact file Consumer-driven contract testing ☑ rich semantic testing ☑ provider can ‘develop to the contract’ instead of developing speculatively (TDD) ⛔ existing spec assets cannot be re-purposed Spring Cloud Contract Pact Pact
83. @edeandrea #RedHat #RivieraDev2023 contract consumer tests provider mock declare (Pact) contract tests verify Pact file Consumer-driven contract testing ☑ rich semantic testing ☑ provider can ‘develop to the contract’ instead of developing speculatively (TDD) ⛔ existing spec assets cannot be re-purposed ⛔ provider needs to know who consumers are Spring Cloud Contract Pact Pact
84. @edeandrea #RedHat #RivieraDev2023 contract consumer tests provider mock declare (Pact) contract tests verify Pact file Consumer-driven contract testing ☑ rich semantic testing ☑ provider can ‘develop to the contract’ instead of developing speculatively (TDD) ⛔ existing spec assets cannot be re-purposed ⛔ provider needs to know who consumers are ⛔ consumers can break provider CI Spring Cloud Contract Pact Pact
85. @edeandrea #RedHat #RivieraDev2023 …but I want to just use Swagger/OpenAPI
86. @edeandrea #RedHat #RivieraDev2023 Is Pact always the best choice?
87. @edeandrea #RedHat #RivieraDev2023 Provider-driven contract testing
88. @edeandrea #RedHat #RivieraDev2023 consumer provider Provider-driven contract testing
89. @edeandrea #RedHat #RivieraDev2023 contract consumer provider OpenAPI Provider-driven contract testing generate (OpenAPI snapshot of current implementation) other protocol specs
90. @edeandrea #RedHat #RivieraDev2023 contract consumer provider contract tests verify OpenAPI Provider-driven contract testing generate (OpenAPI snapshot of current implementation) other protocol specs Schemathesis Microcks
91. @edeandrea #RedHat #RivieraDev2023 contract consumer tests provider mock contract tests verify OpenAPI Provider-driven contract testing generate (OpenAPI snapshot of current implementation) other protocol specs Prism Microcks Schemathesis Microcks
92. @edeandrea #RedHat #RivieraDev2023 contract consumer tests provider mock contract tests verify OpenAPI Provider-driven contract testing generate (OpenAPI snapshot of current implementation) other protocol specs ☑ familiar contract format Prism Microcks Schemathesis Microcks
93. @edeandrea #RedHat #RivieraDev2023 contract consumer tests provider mock contract tests verify OpenAPI Provider-driven contract testing generate (OpenAPI snapshot of current implementation) other protocol specs ☑ familiar contract format ☑ provider does not need comms with consumers Prism Microcks Schemathesis Microcks
94. @edeandrea #RedHat #RivieraDev2023 contract consumer tests provider mock contract tests verify OpenAPI Provider-driven contract testing generate (OpenAPI snapshot of current implementation) other protocol specs ☑ familiar contract format ☑ provider does not need comms with consumers ⛔ provider does not get insight into how API is being used (deprecation is harder) Prism Microcks Schemathesis Microcks
95. @edeandrea #RedHat #RivieraDev2023 contract consumer tests provider mock contract tests verify OpenAPI Provider-driven contract testing generate (OpenAPI snapshot of current implementation) other protocol specs ☑ familiar contract format ☑ provider does not need comms with consumers ⛔ provider does not get insight into how API is being used (deprecation is harder) ⛔ spec-based tests lack functional depth Prism Microcks Schemathesis Microcks
96. @edeandrea #RedHat #RivieraDev2023 Is OpenAPI enough? It has the same syntax, but the semantics are different.
97. @edeandrea #RedHat #RivieraDev2023 Is OpenAPI enough? It has the same syntax, but the semantics are different. It looks the same, but the behaviour is different.
98. @edeandrea #RedHat #RivieraDev2023 Is OpenAPI enough? It has the same syntax, but the semantics are different. It looks the same, but the behaviour is different. Looks like a storm trooper. Behaves like Luke. (because it it is Luke)
99. @edeandrea #RedHat #RivieraDev2023 Demo: Semantic testing with Pact
100. @edeandrea #RedHat #RivieraDev2023 how annoying, the provider is returning 204. the contract expects 404, so my test is broken. quarkus will return 204 by default. 204 vs 404 - it’s more about the theory behind REST...if a caller asks for a resource the server doesn't have, it should be a 404 - same way if a user types in an invalid URL into the browser ugh, it’s too late at night to care about REST theory. I’m just going to update the expectations in the test to match reality. what?! why is my other contract test broken now? 
 oh … because what I’m changing is a mock…. Based on a true story….
101. @edeandrea #RedHat #RivieraDev2023
102. @edeandrea #RedHat #RivieraDev2023 soo … microservices testing is hard limit end-to-end testing mocks will not be enough contract testing can rescue you
103. @edeandrea #RedHat #RivieraDev2023 ® Thank you! Merci! @edeandrea
104. @edeandrea #RedHat #RivieraDev2023 Feedback Slides
105. @edeandrea #RedHat #RivieraDev2023 Additional Resources
106. @edeandrea #RedHat #RivieraDev2023 https://github.com/quarkusio/quarkus-super-heroes More realistic sample application (fewer wookies)
107. @edeandrea #RedHat #RivieraDev2023 Kubernetes Native Java with Quarkus Deployment Developer Joy • Quickly & easily build Kubernetes-Native Java applications • Industry leader in startup time and memory utilization for native and JVM applications • One step native executable generation • Leverage existing Java, Jakarta, MicroProfile, & Spring expertise • Imperative & reactive APIs side-by-side • Live coding with zero config https://www.infoq.com/articles/native-java-quarkus
108. @edeandrea #RedHat #RivieraDev2023 https://www.oreilly.com/library/view/reactive-systems-in/9781492091714 https://developers.redhat.com/e-books/understanding-quarkus https://developers.redhat.com/e-books/practising-quarkus