sealed-secrets — controller giải mã SealedSecret cho Kubernetes
Ví dụ này biên dịch một stack nhỏ, có thật — controller sealed-secrets —
từ một Aggregate do Developer viết sang Kubernetes, dựa trên Helm chart
sealed-secrets chính thức được phục vụ từ một kho chart HTTPS.
sealed-secrets cho phép commit dữ liệu bí mật đã mã hóa vào hệ thống quản lý mã nguồn
một cách an toàn: một khóa công khai mã hóa một secret thành custom resource SealedSecret,
và một controller phạm vi cluster giữ khóa riêng tương ứng sẽ giải mã nó
trở lại thành một Secret gốc của Kubernetes. Controller mở rộng API của cluster
bằng custom resource SealedSecret riêng của nó thay vì là một máy chủ mà
các ứng dụng định tuyến tới, nên nó không có cạnh uses và không xuất gì cho
bên tiêu thụ: các ứng dụng lấy secret của mình bằng cách khai báo các tài nguyên
SealedSecret, và controller mở niêm phong thành các Secret Kubernetes tương ứng.
Controller tạo cặp khóa niêm phong của nó trong cluster lúc chạy, nên không có
dữ liệu khóa nào được tạo ra lúc kết xuất.
Các tệp
| Tệp | Vai trò |
|---|---|
aggregate.yaml | Ý định của Developer: một component sealed-secrets duy nhất (core/security/sealed-secrets). |
manifest.yaml | Ánh xạ kiểu component tới Recipe có nguồn chính thức (sealed-secrets). |
release.yaml | Bản ghi của operator cho đích Kubernetes: kích thước tài nguyên tính toán của operator. |
Ví dụ này minh họa điều gì
- Một bề mặt soạn thảo. Một Aggregate duy nhất là nguồn sự thật cho việc controller là gì; Manifest cho biết cách hiện thực hóa nó.
- Một chart được phục vụ qua HTTPS. Recipe lấy chart từ một kho chart HTTPS
thay vì một registry OCI; quá trình build phân giải và ghim nó khi chạy
aggrega pull. - Một CRD nằm trong thư mục CRD của chart. CustomResourceDefinition
SealedSecretnằm trong thư mục CRD gốc của Helm trong chart, không nằm trong các template; nó luôn được kết xuất vào đầu ra cùng với release, không điều kiện. - Một controller mở rộng cluster, không có cạnh topology. sealed-secrets thêm
custom resource riêng của nó vào API của cluster; bên tiêu thụ yêu cầu secret bằng cách khai báo
các tài nguyên
SealedSecret, nên component không nối cạnhusesnào và không xuất gì cả. - Một controller duy nhất, nhất quán. Chart kết xuất một controller cùng với RBAC và các Service của nó, không có datastore, cache hay broker bên ngoài. Đầ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 lập. Recipe ghim image của controller vào một tag release có thể phân giải (
docker.io/bitnami/sealed-secrets-controller:0.38.4), nên workload được kết xuất tham chiếu tới 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 sealed-secrets-controllerSau đó 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 sealed-secrets-controllerBuild
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/. Quá trình build phân giải chart upstream từ
kho chart HTTPS 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 không gian làm việc chưa có thư mục `sealed-secrets-controller`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `sealed-secrets-controller` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `sealed-secrets-controller` mới. Sau đó gọi công cụ `build` với `workspace_root` đặt thành `sealed-secrets-controller`, `release` đặt thành `release.yaml`, `auto_pull` đặt thành true và `write` đặt thành true. Hãy cho tôi biết lần build đã ghi những tệp nào; chúng nằm dưới `sealed-secrets-controller/dist/`.Những gì được kết xuất
Quá trình build xuất controller sealed-secrets thành một tập đối tượng Kubernetes:
- một
CustomResourceDefinitioncho API sealed-secrets (SealedSecret), - một
Deployment— controller, - RBAC gắn quyền cho nó: một
ClusterRole, mộtClusterRoleBinding, haiRole, và haiRoleBinding, - một
ServiceAccount, - hai
Service— service của controller và service metrics của nó.
Image của controller được ghim vào tag release của nó, nên workload tham chiếu tới một tag image đã ghim.