cert-manager — bộ điều khiển vòng đời chứng chỉ TLS cho Kubernetes
Ví dụ này biên dịch một stack nhỏ có thật — bộ điều khiển chứng chỉ cert-manager — từ một Aggregate do Developer soạn sang Kubernetes. Developer
khai báo cert-manager là gì; một Recipe duy nhất của Ops ánh xạ ý định đó
sang Helm chart chính thức của cert-manager từ registry jetstack và kết xuất
các đối tượng Kubernetes.
cert-manager là một add-on Kubernetes ở phạm vi cluster, tự động hóa việc cấp phát
và gia hạn chứng chỉ X.509 từ các nguồn cấp như ACME (Let’s
Encrypt), một CA riêng, hoặc Vault. Nó mở rộng cluster bằng các custom resource riêng là
Certificate, Issuer và ClusterIssuer. Ứng dụng yêu cầu
chứng chỉ bằng cách khai báo các resource đó — chứ không phải bằng cách nối tới một upstream — nên
component này không có cạnh uses. Cũng vì lý do đó, nó không có dạng container
cục bộ độc lập, nên họ này chỉ cung cấp một Recipe Helm; không có
target Compose. Tất cả những gì component công bố là nơi một máy chủ Prometheus tìm thấy
metrics của nó.
Các tệp
| Tệp | Vai trò |
|---|---|
aggregate.yaml | Ý định của Developer: một component cert-manager duy nhất (core/security/cert-manager) với việc cài đặt CRD được bật. |
manifest.yaml | Ánh xạ kiểu component sang Recipe Helm của cert-manager (cert-manager). |
release.yaml | Bản ghi của operator cho target Kubernetes: kích thước tài nguyên của controller/webhook/CA-injector. |
Ví dụ này minh họa điều gì
- Một bề mặt soạn thảo, được hiện thực bởi một Recipe của Ops. Aggregate là nguồn sự thật về việc cert-manager là gì. Manifest cho biết cách hiện thực nó bằng cách ánh xạ kiểu component sang một Recipe theo tên; Release cung cấp kích thước vận hành. Ý định của Developer và ánh xạ của Ops được giữ tách biệt.
- Ba workload phối hợp từ một component. Recipe kết xuất cả
ba phần của cert-manager: một
Deploymentcho controller đối soát các yêu cầu chứng chỉ, mộtDeploymentcho webhook xác thực và đặt giá trị mặc định cho các custom resource, và mộtDeploymentcho CA injector nối CA bundle của webhook vào cluster. - Cài đặt API chứng chỉ. Giá trị
install_crdscủa developer được truyền vào chart, chart này cài đặt cácCustomResourceDefinitioncủa cert-manager (các resourceCertificate,Issuer,ClusterIssuervàOrder/Challengecủa ACME). Đặt nó thành false khi các CRD được quản lý bên ngoài. - Nối admission. Chart phát ra
ValidatingWebhookConfigurationvàMutatingWebhookConfigurationmà webhook phục vụ,Servicecủa webhook, và toàn bộ tập RBAC — mộtClusterRole/ClusterRoleBindingcho mỗi trách nhiệm của controller cùng cácRolecho leader-election — để controller có các quyền nó cần. - Image tái lập được. Chart cung cấp các release tag có thể phân giải; Recipe ghim lại các image controller, webhook, CA-injector và ACME solver vào các tag đó để các workload được kết xuất tham chiếu các phiên bản đã được 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 cert-manager-tlsSau đó 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 cert-manager-tlsBuild
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 `cert-manager-tls`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `cert-manager-tls` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `cert-manager-tls` mới. Sau đó gọi công cụ `build` với `workspace_root` đặt thành `cert-manager-tls`, `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 bản build đã ghi những tệp nào; chúng nằm trong `cert-manager-tls/dist/`.Những gì được kết xuất
Bản build phát ra toàn bộ stack cert-manager — ba Deployment (controller, webhook và CA injector), sáu CustomResourceDefinition của cert-manager khi install_crds được bật, một ValidatingWebhookConfiguration và một MutatingWebhookConfiguration, Service của webhook, các ServiceAccount của controller, và tập RBAC gồm các ClusterRole, ClusterRoleBinding, cùng các Role và RoleBinding cho leader-election. Nó cũng bao gồm một Job post-install (bước kiểm tra API khi khởi động, chặn cho đến khi API chứng chỉ sẵn sàng phục vụ) và một Service metrics cho mỗi controller và CA injector — tổng cộng 50 đối tượng Kubernetes. Các image controller, webhook, CA-injector và ACME-solver được ghim vào release tag của chúng, nên mọi workload đều tham chiếu một image tag đã được ghim.