★

Outline

What this site covers and how it's organized — 28 chapters across 13 parts, both stacks against one Protobuf contract.

OverviewPrerequisites & the Lab

This site teaches gRPC API design against a single Protocol Buffers contract for a shipping and cargo domain. gRPC here is the internal, latency-sensitive routing and tracking service that the sibling REST booking service calls. Every hands-on chapter ships the same example in both Quarkus and Python, generated from the same proto, and CI asserts each response against the contract so the two stacks never drift. The full arc is below.

Part 0 — Prerequisites & the Lab

• Ch0 · Prerequisites & the lab

Part 1 — Why gRPC, and the Decision Lens

• Ch1 · From REST to RPC
• Ch2 · The gRPC decision framework

Part 2 — Protocol Buffers: the Contract Language

• Ch3 · Protocol Buffers in depth
• Ch4 · Well-known types and JSON mapping
• Ch5 · Contract-first with Buf

Part 3 — HTTP/2 & the Four RPC Types

• Ch6 · HTTP/2 foundation and why gRPC is fast
• Ch7 · Unary RPCs and the generated code
• Ch8 · Server-streaming
• Ch9 · Client-streaming and bidirectional

Part 4 — Reliability: Deadlines, Errors & Interceptors

• Ch10 · Deadlines, timeouts and cancellation
• Ch11 · Error and exception handling
• Ch12 · Interceptors

Part 5 — Schema Evolution & the Living Contract

• Ch13 · Schema design over gRPC
• Ch14 · Evolution and versioning

Part 6 — Concurrency & Long-Running Work

• Ch15 · Backend I/O concurrency
• Ch16 · Async and long-running jobs over gRPC

Part 7 — Streaming at Scale & Performance

• Ch17 · Streaming deep-dive
• Ch18 · Performance and tuning

Part 8 — Security

• Ch19 · TLS and mTLS
• Ch20 · AuthN and AuthZ

Part 9 — Observability, Mesh & Load Balancing

• Ch21 · Observability
• Ch22 · Load balancing and service mesh

Part 10 — Browsers, Transcoding & Cross-Protocol

• Ch23 · gRPC-Web and JSON transcoding
• Ch24 · Cross-protocol choices and HTTP/3

Part 11 — Testing & Debugging

• Ch25 · Testing and the CLI
• Ch26 · Debugging gRPC

Part 12 — Running It & the Final Project

• Ch27 · The final project
• Appendix A · OpenShift Local (CRC)