Kratos Go framework: microservices cloud-native

Kratos là gì

Kratos là một Go framework nhẹ để xây microservices cloud-native. Thay vì gộp mọi thứ vào một toolkit lớn, nó tách transport, middleware, service registry, nạp config, logging và wire encoding thành từng mảnh riêng, tùy bạn chọn dùng cái nào. Kratos dựa vào Protobuf để định nghĩa API và sinh boilerplate cho HTTP, gRPC, đồng thời dùng log/slog của standard library thay vì một logger riêng. Một hệ sinh thái contrib tách biệt bổ sung các tích hợp tùy chọn mà không làm phình core module.

Năng lực cốt lõi của Kratos

• ✓Quy trình API-first: viết một định nghĩa Protobuf duy nhất rồi sinh code server và client cho cả HTTP lẫn gRPC từ đó.
• ✓Lớp transport thống nhất, chạy song song một HTTP server và một gRPC server trong cùng một service, đúng như ví dụ usage trong README.
• ✓Chuỗi middleware kết hợp được, bao gồm recovery, logging, validation, tracing, metrics và auth.
• ✓Các thành phần registry, configuration và encoding có thể thay thế mà không phải sửa code ứng dụng.
• ✓Logging xây trên log/slog của standard library, có phần mở rộng OpenTelemetry qua các gói contrib.
• ✓Xử lý nhất quán cho metadata, errors, validation và sinh OpenAPI trên nhiều service.
• ✓Một hệ sinh thái contrib riêng cho các tích hợp tùy chọn — registry, config store, middleware, encoding, observability — được tách khỏi core module.

Khi nào nên dùng Kratos

• •Dựng một Go microservice mới cần lộ ra cả API HTTP lẫn gRPC từ một codebase.
• •Đội ngũ muốn chuẩn hóa Protobuf làm nguồn sự thật duy nhất cho hợp đồng API giữa các service.
• •Dự án muốn áp middleware như auth, tracing, metrics một cách nhất quán thay vì gắn tùy tiện theo từng handler.
• •Triển khai cloud-native cần service registry và nguồn config có thể thay thế thay vì hardcode giá trị.

Cài đặt Kratos CLI và điều kiện tiên quyết

Kratos yêu cầu Go 1.25 trở lên, cộng thêm `protoc` và `protoc-gen-go` đã cài, vì CLI sinh code từ định nghĩa Protobuf. Cài CLI bằng `go install github.com/go-kratos/kratos/cmd/kratos/v3@latest`, sau đó chạy `kratos upgrade`. Từ đó, `kratos new helloworld` dựng khung một project; `cd helloworld && go mod tidy && kratos run` khởi chạy nó, và README hướng dẫn truy cập `http://localhost:8000/helloworld/kratos` để xác nhận nó đang chạy.

Xây một service với Kratos

Với quy trình sinh service đầy đủ hơn, trình tự trong README là `kratos proto add api/helloworld/helloworld.proto`, `kratos proto client api/helloworld/helloworld.proto`, `kratos proto server api/helloworld/helloworld.proto -t internal/service`, rồi `go generate ./...` và `kratos run`. Nối service theo cách viết tay trông như sau: ```go package main import ( "github.com/go-kratos/kratos/v3" "github.com/go-kratos/kratos/v3/transport/grpc" "github.com/go-kratos/kratos/v3/transport/http" ) func main() { httpSrv := http.NewServer(http.Address(":8000")) grpcSrv := grpc.NewServer(grpc.Address(":9000")) app := kratos.New( kratos.Name("helloworld"), kratos.Version("v1.0.0"), kratos.Server(httpSrv, grpcSrv), ) if err := app.Run(); err != nil { panic(err) } } ``` Cả hai server đăng ký vào cùng một `kratos.App`, nên chỉ một lệnh gọi `Run()` là khởi động và dừng cả hai cùng lúc.

So sánh Kratos với các Go framework khác

Câu hỏi thường gặp

Vấn đề mà Kratos giải quyết

Xây một Go microservice vừa nói gRPC (cho các lệnh gọi nội bộ) vừa nói HTTP (cho client bên ngoài hoặc webhook) thường có nghĩa là phải duy trì hai định nghĩa API riêng biệt, rồi lệch nhau dần khi service lớn lên. Kratos giải quyết việc này bằng cách biến Protobuf thành nguồn sự thật duy nhất: định nghĩa API một lần, rồi sinh cả code server HTTP lẫn gRPC từ đó, cộng thêm client stub, thay vì viết tay các handler song song cho từng transport.

Ai nên dùng — và ai nên bỏ qua

Đội Go xây nhiều hơn một microservice, cần HTTP và gRPC dùng chung một định nghĩa API, là đối tượng hợp nhất với Kratos — quy trình code generation trả công xứng đáng khi bạn phải giữ đồng bộ vài service trở lên. Một lập trình viên đơn lẻ chỉ làm một API HTTP thì không cần đến registry, chuỗi middleware và toolchain protobuf của Kratos. Bỏ qua nó đi. gin hay net/http thuần đã đủ với ít công sức thiết lập hơn nhiều. Ai còn chạy Kratos v2 trong production nên dành thời gian đọc hướng dẫn migration trước khi đụng vào v3.

Repo liên quan