OpenBao — máy chủ quản lý bí mật trên Kubernetes
Ví dụ này biên dịch một stack nhỏ, thực tế — một máy chủ bí mật OpenBao
duy nhất — từ một Aggregate do Developer viết sang Kubernetes, dựa trên
Helm chart chính thức của OpenBao.
OpenBao lưu trữ, tạo và kiểm soát quyền truy cập vào token, mật khẩu, chứng chỉ và các bí mật khác thông qua một HTTP API có xác thực, đồng thời mã hóa trạng thái lưu trữ của nó trên một volume dữ liệu bền vững. Ở đây nó chạy như một máy chủ độc lập duy nhất, lưu trạng thái trong backend lưu trữ tệp tích hợp sẵn, nên nó được kết xuất thành một máy chủ có trạng thái đang chạy, dựa trên một persistent volume thay vì một tài nguyên đám mây được quản lý. Máy chủ được khởi tạo và mở niêm phong (unseal) lúc chạy bên trong cluster — root token và các unseal key của nó do máy chủ đang chạy tạo ra sau khi khởi động — nên không có thông tin xác thực nào được khai báo trong Aggregate và không có bí mật nào được tạo ra lúc build.
Các tệp
| Tệp | Vai trò |
|---|---|
aggregate.yaml | Ý định của developer: một component secrets duy nhất (core/security/openbao) với web UI tích hợp được bật. |
manifest.yaml | Ánh xạ kiểu component sang Recipe có nguồn chính thức (openbao). |
release.yaml | Bản ghi của operator cho target Kubernetes: kích thước tài nguyên tính toán của máy chủ và kích thước volume dữ liệu. |
Ví dụ này minh họa điều gì
- Một bề mặt soạn thảo duy nhất. Một Aggregate duy nhất là nguồn chân lý cho việc máy chủ bí mật là gì; Manifest cho biết cách hiện thực hóa nó.
- Một giá trị của developer được truyền tới bản kết xuất. Giá trị
ui_enabledcủa developer được ghi vào cấu hình máy chủ mà chart mount, dùng để bật/tắt web UI tích hợp. - Một máy chủ có trạng thái trên persistent volume. Recipe có nguồn
cấu hình chế độ standalone với backend lưu trữ tệp, nên máy chủ lưu
trạng thái đã mã hóa của nó trên một
PersistentVolumeClaimđược mount tại/openbao/data, với kích thước theostorage.sizecủa operator. - Không có thông tin xác thực lúc kết xuất. OpenBao tự khởi tạo và mở niêm phong lúc
chạy, nên bản build không nối thông tin xác thực nào và không tạo ra
Secretnào. Đầu ra được kết xuất giống hệt nhau từng byte qua các lần chạy với cùng đầu vào. - Một image có thể tái tạo. Recipe ghim image máy chủ vào một tag phát hành có thể phân giải (
quay.io/openbao/openbao:2.5.5), nên workload được kết xuất tham chiếu một phiên bản đã ghim.
Tạo ví dụ
Bạn có thể build ví dụ này bằng các lệnh bên dưới, hoặc để trợ lý AI của bạn build giúp bạn.
Ghi ví dụ vào một thư mục mới đặt theo tên của nó:
aggrega scaffold --example openbao-secretsSau đó nó in ra các lệnh cần chạy tiếp theo. Lệnh đầu tiên chuyển vào thư mục mới:
cd openbao-secretsBuild
Workspace này không có .aggrega-config.yaml, nên các thực thể thư viện chuẩn được phân giải từ registry hub, hub.aggrega.ai, và không cần cờ catalog:
aggrega pull --release release.yamlaggrega build --release release.yamlCác artifact được kết xuất nằm trong dist/. Bản build phân giải chart upstream theo
tham chiếu OCI khi chạy aggrega pull và ghim nó trong một lockfile.
Với trợ lý AI
Một trợ lý AI được thiết lập với các công cụ của Aggrega cũng có thể làm như vậy: hãy dán prompt này vào trợ lý.
Chỉ dùng các công cụ của Aggrega và không tự tạo thư mục nào. Nếu thư mục Workspace chưa có thư mục `openbao-secrets`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `openbao-secrets` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `openbao-secrets` mới. Sau đó gọi công cụ `build` với `workspace_root` đặt thành `openbao-secrets`, `release` đặt thành `release.yaml`, `auto_pull` đặt thành true và `write` đặt thành true. Cho tôi biết bản dựng đã ghi những tệp nào; chúng nằm trong `openbao-secrets/dist/`.Những gì được kết xuất
Bản build tạo ra stack OpenBao gọn nhẹ với một workload duy nhất dưới dạng bảy đối tượng Kubernetes:
- một
StatefulSetcho máy chủ OpenBao, - một
ConfigMapchứa cấu hình máy chủ (backend lưu trữ tệp và listener của API), - hai
Service— service API chính và service headless nội bộ mà StatefulSet dùng để có mạng pod ổn định, - một
ServiceAccountcho pod máy chủ, - một
ClusterRoleBindingcấp cho máy chủ quyền token-review mà nó dùng để xác thực các service account của Kubernetes, - một
Podhelm.sh/hook: testkiểm tra trạng thái sẵn sàng của máy chủ.
Không có CustomResourceDefinition nào — OpenBao là một máy chủ tự đóng gói, không phải một controller mở rộng API của cluster. Image máy chủ được ghim vào tag phát hành của nó, nên workload tham chiếu một image tag đã ghim.