Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

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ệpVai 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.yamlBả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_enabled củ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 theo storage.size củ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 Secret nà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ó:

Terminal window
aggrega scaffold --example openbao-secrets

Sau đó 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:

Terminal window
cd openbao-secrets

Build

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:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Cá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 StatefulSet cho máy chủ OpenBao,
  • một ConfigMap chứ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 ServiceAccount cho pod máy chủ,
  • một ClusterRoleBinding cấ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 Pod helm.sh/hook: test kiể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.