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.

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ệpVai 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.yamlBả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 Deployment cho controller đối soát các yêu cầu chứng chỉ, một Deployment cho webhook xác thực và đặt giá trị mặc định cho các custom resource, và một Deployment cho CA injector nối CA bundle của webhook vào cluster.
  • Cài đặt API chứng chỉ. Giá trị install_crds của developer được truyền vào chart, chart này cài đặt các CustomResourceDefinition của cert-manager (các resource Certificate, Issuer, ClusterIssuer và Order/Challenge củ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 ValidatingWebhookConfiguration và MutatingWebhookConfiguration mà webhook phục vụ, Service của webhook, và toàn bộ tập RBAC — một ClusterRole/ClusterRoleBinding cho mỗi trách nhiệm của controller cùng các Role cho 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ó:

Terminal window
aggrega scaffold --example cert-manager-tls

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 cert-manager-tls

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 `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.