Kubernetes Native Microservices with Quarkus and MicroProfile

Kubernetes Native Microservices with Quarkus and MicroProfile
contents
preface
acknowledgments
about this book
Who should read this book?
How this book is organized: A road map
About the code
liveBook discussion forum
about the authors
about the cover illustration
Part 1—Introduction
1 Introduction to Quarkus, MicroProfile, and Kubernetes
1.1 What is a microservice?
1.1.1 The rise of microservices
1.1.2 Microservices architecture
1.1.3 The need for microservices specifications
1.2 MicroProfile
1.2.1 History of MicroProfile
1.2.2 MicroProfile community core principles
1.3 Quarkus
1.3.1 Developer joy
1.3.2 MicroProfile support
1.3.3 Runtime efficiency
1.4 Kubernetes
1.4.1 Introduction to Kubernetes
1.5 Kubernetes-native microservices
Summary
2 Your first Quarkus application
2.1 Creating a project
2.2 Developing with live coding
2.3 Writing a test
2.4 Creating a native executable
2.5 Running in Kubernetes
2.5.1 Generating Kubernetes YAML
2.5.2 Packaging an application
2.5.3 Deploying and running an application
Summary
Part 2—Developing microservices
3 Configuring microservices
3.1 MicroProfile Config architecture overview
3.2 Accessing a configuration
3.3 The Bank service
3.3.1 Creating the Bank service
3.3.2 Configuring the Bank service name field
3.4 Configuration sources
3.5 Configuring the mobileBanking field
3.6 Grouping properties with @ConfigProperties
3.7 Quarkus-specific configuration features
3.7.1 Quarkus configuration profiles
3.7.2 Property expressions
3.7.3 Quarkus ConfigMapping
3.7.4 Run-time vs. build-time properties
3.8 Configuration on Kubernetes
3.8.1 Common Kubernetes configuration sources
3.8.2 Using a ConfigMap for Quarkus applications
3.8.3 Editing a ConfigMap
3.8.4 Kubernetes Secrets
Summary
4 Database access with Panache
4.1 Data sources
4.2 JPA
4.3 Simplifying database development
4.3.1 Active record approach
4.3.2 Data repository approach
4.3.3 Which approach to use?
4.4 Deployment to Kubernetes
4.4.1 Deploying PostgreSQL
4.4.2 Package and deploy
Summary
5 Clients for consuming other microservices
5.1 What is MicroProfile REST Client?
5.2 Service interface definition
5.2.1 CDI REST client
5.2.2 Programmatic REST client
5.2.3 Choosing between CDI and a programmatic API
5.2.4 Asynchronous response types
5.3 Customizing REST clients
5.3.1 Client request headers
5.3.2 Declaring providers
Summary
6 Application health
6.1 The growing role of developers in application health
6.2 MicroProfile Health
6.2.1 Liveness vs. readiness
6.2.2 Determining liveness and readiness status
6.3 Getting started with MicroProfile Health
6.3.1 Account service MicroProfile Health liveness
6.3.2 Creating an Account service liveness health check
6.3.3 Account service MicroProfile Health readiness
6.3.4 Disabling vendor readiness health checks
6.3.5 Creating a readiness health check
6.3.6 Quarkus health groups
6.3.7 Displaying the Quarkus Health UI
6.4 Kubernetes liveness and readiness probes
6.4.1 Customizing health check properties
6.4.2 Deploying to Kubernetes
6.4.3 Testing the readiness health check in Kubernetes
Summary
7 Resilience strategies
7.1 Resilience strategies overview
7.2 Executing a method under a separate thread with @Asynchronous
7.3 Constraining concurrency with bulkheads
7.4 Updating a TransactionService with a bulkhead
7.5 Exception handling with fallbacks
7.6 Defining execution timeouts
7.7 Recovering from temporary failure with @Retry
7.8 Avoiding repeated failure with circuit breakers
7.8.1 MicroProfile Fault Tolerance: @CircuitBreaker
7.8.2 How a circuit breaker works
7.8.3 Updating the TransactionService to use @CircuitBreaker
7.8.4 Testing the circuit breaker
7.9 Overriding annotation parameter values using properties
7.10 Deploying to Kubernetes
Summary
8 Reactive in an imperative world
8.1 Reactive example
8.2 What is Reactive Streams?
8.2.1 Publisher, Subscriber, and Processor
8.2.2 The importance of back pressure
8.3 Reactive Messaging in Quarkus
8.3.1 Bridging from imperative to reactive with emitters
8.3.2 What about blocking?
8.3.3 Testing “in memory”
8.4 How does it work?
8.4.1 MicroProfile Reactive Messaging specification
8.4.2 Message content and metadata
8.4.3 Messages in the stream
8.5 Deploying to Kubernetes
8.5.1 Apache Kafka in Minikube
8.5.2 Putting it all together
Summary
9 Developing Spring microservices with Quarkus
9.1 Quarkus/Spring API compatibility overview
9.2 Spring dependency injection and configuration compatibility
9.2.1 Setting up the Spring Cloud Config Server
9.2.2 Using the Spring Config Server as a configuration source
9.2.3 Converting the Bank service to use Spring Configuration APIs
9.3 Quarkus/Spring Web API compatibility
9.4 Quarkus/Spring Data JPA compatibility
9.5 Deploying to Kubernetes
9.6 How Quarkus implements Spring API compatibility
9.7 Common Quarkus/Spring compatibility questions
9.8 Comparing the Spring Boot and Quarkus startup processes
Summary
Part 3—Observability, API definition, and security of microservices
10 Capturing metrics
10.1 The role of metrics in a microservices architecture
10.2 Getting started with MicroProfile Metrics
10.2.1 Graphing metrics with Prometheus and Grafana
10.2.2 MicroProfile Metrics
10.2.3 Instrumenting the Account service
10.2.4 Instrumenting the TransactionService
10.2.5 Creating business metrics
10.2.6 MicroProfile Fault Tolerance and JAX-RS integration with MicroProfile Metrics
10.2.7 Micrometer metrics
10.2.8 Simulating a busy production system
Summary
11 Tracing microservices
11.1 How does tracing work?
11.2 Jaeger
11.2.1 Trace sampling
11.2.2 Setting up the Minikube environment
11.2.3 Installing Jaeger
11.2.4 Microservice tracing with Jaeger
11.3 Tracing specifications
11.3.1 OpenTracing
11.3.2 What is MicroProfile OpenTracing?
11.3.3 OpenTelemetry
11.4 Customizing application tracing
11.4.1 Using @Traced
11.4.2 Injecting a tracer
11.4.3 Tracing database calls
11.4.4 Tracing Kafka messages
Summary
12 API visualization
12.1 Viewing OpenAPI documents with Swagger UI
12.1.1 Enabling OpenAPI
12.1.2 Swagger UI
12.2 MicroProfile OpenAPI
12.2.1 Application information
12.2.2 Customizing the schema output
12.2.3 Defining operations
12.2.4 Operation responses
12.2.5 Tagging operations
12.2.6 Filtering OpenAPI content
12.3 Design-first development
12.3.1 OpenAPI file base
12.3.2 Mixing the file and annotations
12.4 Code first or OpenAPI first?
Summary
13 Securing a microservice
13.1 Authorization and authentication overview
13.2 Using file-based authentication and authorization
13.3 Authentication and authorization with OpenID Connect
13.3.1 Introduction to OpenID Connect (OIDC)
13.3.2 OIDC and Keycloak
13.3.3 Accessing a protected resource with OpenID Connect
13.3.4 Testing the Code Authorization Flow
13.4 Json Web Tokens (JWT) and MicroProfile JWT
13.4.1 JWT header
13.4.2 JWT payload
13.4.3 JWT signature
13.5 Securing the Transaction service using MicroProfile JWT
13.6 Propagating the JWT
13.6.1 Secure an Account service endpoint
13.6.2 Propagating JWT from the Transaction service to the Account service
13.7 Running the services in Kubernetes
Summary
index
Symbols
A
B
C
D
E
F
G
H
I
J
K
L
M
N
O
P
Q
R
S
T
U
V
W