How go-kratos/kratos works
Kratos is a Go framework for building cloud-native microservices. Its primary workflow is API-first service development: developers use the CLI and Protobuf generators to scaffold a service, then run it through the application lifecycle with HTTP and/or gRPC transports. Clients can discover and select service instances; middleware, configuration, encoding, logging, and registry implementations provide supporting capabilities. Source excerpts establish several runtime calls, while README statements support the documented code-generation workflow and broad feature branches; unsampled subsystem links are omitted or marked unverified.
Main entry points: app.go App lifecycle · kratos Kratos CLI · middleware Middleware · registry.go Registry API
Components 22
Service development
- Kratos CLI
cmd/kratos - Protobuf API
- HTTP generator
cmd/protoc-gen-go-http/main.go - Errors generator
cmd/protoc-gen-go-errors/main.go
Application runtime
- App lifecycle
app.go - Middleware
middleware - Configuration
config - Logging
log
Transport and clients
- HTTP server
transport/http/server.go - gRPC server
transport/grpc/server.go - HTTP client
transport/http/client.go - gRPC client
transport/grpc/client.go - Encoding codecs
encoding
Service platform
- Registry API
registry/registry.go - Node selection
selector - Consul registry
contrib/registry/consul/client.go - Polaris routing
contrib/polaris/router.go - Protobuf form decoding
encoding/form/proto_decode.go
Extensions
- Contrib integrations
contrib - MCP transport
contrib/transport/mcp/server.go - OAuth2 middleware
contrib/middleware/oauth2/server.go
Other components
- Service developer
Connections 26
- Service developer → Kratos CLI: scaffolds service
README.md - Service developer → Protobuf API: defines API
README.md - Protobuf API → Kratos CLI: adds API
README.md - Kratos CLI → HTTP generator: generates HTTP
README.md - Kratos CLI → Errors generator: generates errors
- Service developer → App lifecycle: runs service
README.md - App lifecycle → HTTP server: starts and stops
app.go - App lifecycle → gRPC server: starts and stops
- App lifecycle → Registry API: registers instance
app.go - HTTP server → Middleware: applies middleware
transport/http/server.go - gRPC server → Middleware: applies middleware
transport/grpc/server.go - App lifecycle → Logging: sets default logger
app.go - HTTP client → Encoding codecs: encodes requests
transport/http/client.go - HTTP client → Registry API: uses discovery
transport/http/client.go - HTTP client → Node selection: selects nodes
transport/http/client.go - gRPC client → Registry API: uses discovery
transport/grpc/client.go - gRPC client → Node selection: selects peers
transport/grpc/client.go - gRPC client → Middleware: chains middleware
transport/grpc/client.go - Consul registry → Registry API: returns instances
contrib/registry/consul/client.go - Polaris routing → Node selection: reads node metadata
contrib/polaris/router.go - Protobuf form decoding → Encoding codecs: uses proto JSON
encoding/form/proto_decode.go - MCP transport → Contrib integrations: extends transport
contrib/transport/mcp/server.go - OAuth2 middleware → Middleware: implements middleware
contrib/middleware/oauth2/server.go - Service developer → Contrib integrations: adopts integrations
README.md - Service developer → Configuration: configures services
README.md - Service developer → Encoding codecs: chooses formats
README.md