external-secrets — operator đồng bộ hóa secret cho Kubernetes
Ví dụ này biên dịch một stack nhỏ, có thật — operator external-secrets —
từ một Aggregate do Developer soạn sang Kubernetes, dựa trên Helm chart
external-secrets chính thức.
external-secrets đồng bộ hóa dữ liệu bí mật từ các hệ thống quản lý secret bên ngoài
— HashiCorp Vault, AWS Secrets Manager, Google Secret Manager, Azure Key
Vault và các hệ thống khác — vào các Secret gốc của Kubernetes, giữ chúng đồng bộ khi
nguồn thay đổi. Đây là một controller phạm vi cluster, mở rộng API của cluster
bằng các custom resource riêng chứ không phải một server mà ứng dụng định tuyến tới, nên nó
không nhận cạnh uses nào, và thứ duy nhất nó công bố là nơi một Prometheus server tìm thấy
metrics của nó: ứng dụng lấy secret bằng cách khai báo các resource ExternalSecret và
SecretStore, và operator hiện thực hóa các Secret
Kubernetes tương ứng.
Các tệp
| Tệp | Vai trò |
|---|---|
aggregate.yaml | Ý định của Developer: một component external-secrets duy nhất (core/security/external-secrets) cài đặt các custom resource definition cùng với release. |
manifest.yaml | Ánh xạ kiểu component sang Recipe có nguồn chính thức (external-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 chân lý cho việc operator là gì; Manifest cho biết cách hiện thực hóa nó.
- Một giá trị của developer đi tới bước render. Giá trị
install_crdscủa developer được ghi vào giá trịinstallCRDscủa chart, đưa các custom resource definition của external-secrets vào cluster cùng với release. - Một controller mở rộng cluster, không có cạnh topology. external-secrets thêm
các custom resource riêng 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 resource đó, nên component không nối cạnh
usesnào và không xuất gì ngoài nơi đặt metrics của nó. - Một operator thống nhất duy nhất. Chart render controller, webhook và certificate controller thành một operator; subchart provider đi kèm bị tắt, nên không kéo theo datastore, cache hay broker ngoại lai nào. Đầu ra đã render giống hệt 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 cả ba container image vào một release tag phân giải được (
ghcr.io/external-secrets/external-secrets:v2.7.0), nên các workload đã render 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 external-secrets-operatorSau đó 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 external-secrets-operatorBuild
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ỉ sử 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 chứa thư mục `external-secrets-operator`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `external-secrets-operator` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `external-secrets-operator` mới. Sau đó gọi công cụ `build` với `workspace_root` đặt thành `external-secrets-operator`, `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 trong `external-secrets-operator/dist/`.Những gì được kết xuất
Bản build xuất operator external-secrets dưới dạng một tập các đối tượng Kubernetes:
- 24
CustomResourceDefinitioncho API của external-secrets (ExternalSecret,SecretStore,ClusterSecretStore, cùng các resource push và generator liên quan), - ba
Deployment— controller, webhook và certificate controller, - RBAC liên kết chúng: các
ClusterRole, cácClusterRoleBinding, mộtRolevà mộtRoleBinding, - ba
ServiceAccount, mỗi workload một cái, - một
Servicecho webhook, - hai
ValidatingWebhookConfiguration, - một
Secretgiữ chỗ mà certificate controller điền chứng chỉ phục vụ của webhook vào lúc runtime.
Cả ba container image đều được ghim vào release tag của chúng, nên các workload tham chiếu tới các image đã ghim.