cert-manager — controlador del ciclo de vida de los certificados TLS de Kubernetes
Este ejemplo compila un stack pequeño y real — un controlador de certificados cert-manager — a partir de un único Aggregate escrito por el desarrollador para Kubernetes. El desarrollador declara qué es cert-manager; una única Recipe de Ops asigna esa intención al chart de Helm oficial de cert-manager del registro de jetstack y renderiza los objetos de Kubernetes.
cert-manager es un complemento de Kubernetes con ámbito de clúster que automatiza la emisión y la renovación de certificados X.509 a partir de fuentes emisoras como ACME (Let’s Encrypt), una CA privada o Vault. Extiende el clúster con sus propios recursos personalizados Certificate, Issuer y ClusterIssuer. Las aplicaciones piden certificados declarando esos recursos — no conectando un upstream —, así que el componente no admite ninguna arista uses. Por la misma razón no tiene una forma independiente como contenedor local, así que esta familia incluye solo una Recipe de Helm; no hay destino Compose. Todo lo que publica el componente es dónde encuentra un servidor Prometheus sus métricas.
Archivos
| Archivo | Rol |
|---|---|
aggregate.yaml | Intención del desarrollador: un único componente cert-manager (core/security/cert-manager) con la instalación de los CRD activada. |
manifest.yaml | Asigna el tipo de componente a la Recipe de Helm de cert-manager (cert-manager). |
release.yaml | Documento del operador para el destino Kubernetes: el dimensionamiento de controlador/webhook/inyector de CA. |
Lo que demuestra
- Una única superficie de autoría, realizada por una Recipe de Ops. El Aggregate es la fuente de verdad sobre qué es cert-manager. El Manifest dice cómo realizarlo asignando el tipo de componente a una Recipe por nombre; la Release aporta el dimensionamiento operativo. La intención del desarrollador y la asignación de Ops permanecen separadas.
- Tres cargas de trabajo coordinadas a partir de un componente. La Recipe renderiza las tres partes de cert-manager: un
Deploymentpara el controlador que concilia las solicitudes de certificados, unDeploymentpara el webhook que valida los recursos personalizados y les asigna valores predeterminados, y unDeploymentpara el inyector de CA que conecta el bundle de CA del webhook en el clúster. - Instalación de la API de certificados. El valor
install_crdsdel desarrollador llega al chart, que instala lasCustomResourceDefinitions de cert-manager (los recursosCertificate,Issuer,ClusterIssuery ACMEOrder/Challenge). Ponlo en false cuando los CRD se gestionan por separado. - Cableado de admisión. El chart emite la
ValidatingWebhookConfigurationy laMutatingWebhookConfigurationque sirve el webhook, elServicedel webhook y el conjunto RBAC completo — unClusterRole/ClusterRoleBindingpor cada responsabilidad del controlador más losRoles de elección de líder —, así que el controlador tiene los permisos que necesita. - Imágenes reproducibles. El chart incluye etiquetas de release resolubles; la Recipe vuelve a fijar las imágenes del controlador, del webhook, del inyector de CA y del solucionador ACME a esas etiquetas, así que las cargas de trabajo renderizadas hacen referencia a versiones fijadas.
Generar el ejemplo
Puedes compilar este ejemplo con los comandos de abajo, o hacer que tu asistente de IA lo compile por ti.
Escribe el ejemplo en una carpeta nueva con su nombre:
aggrega scaffold --example cert-manager-tlsDespués imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:
cd cert-manager-tlsCompilación
Este espacio de trabajo no contiene ningún .aggrega-config.yaml, así que las entidades de la biblioteca estándar se resuelven desde el registro del hub, hub.aggrega.ai, y no hace falta ningún flag de catálogo:
aggrega pull --release release.yamlaggrega build --release release.yamlLos artefactos renderizados quedan bajo dist/. La compilación resuelve el chart upstream por referencia OCI en aggrega pull y lo fija en un lockfile.
Con un asistente de IA
Un asistente de IA configurado con las herramientas de Aggrega puede hacer lo mismo: pégale este prompt.
Usa solo las herramientas de Aggrega y no crees ninguna carpeta tú mismo. Si la carpeta del espacio de trabajo aún no contiene una carpeta `cert-manager-tls`, llama una sola vez a la herramienta `scaffold` con `example` establecido en `cert-manager-tls` y sin `dir`: escribe el ejemplo en una nueva carpeta `cert-manager-tls`. Después llama a la herramienta `build` con `workspace_root` establecido en `cert-manager-tls`, `release` establecido en `release.yaml`, `auto_pull` establecido en true y `write` establecido en true. Dime qué archivos escribió la compilación; están en `cert-manager-tls/dist/`.Qué se renderiza
La compilación emite el stack completo de cert-manager — tres Deployments (el controlador, el webhook y el inyector de CA), las seis CustomResourceDefinitions de cert-manager cuando install_crds está activado, una ValidatingWebhookConfiguration y una MutatingWebhookConfiguration, el Service del webhook, las ServiceAccounts del controlador, y el conjunto RBAC de ClusterRoles, ClusterRoleBindings, y Roles y RoleBindings de elección de líder. También incluye un Job posterior a la instalación (la comprobación de la API al arrancar, que bloquea hasta que la API de certificados está en servicio) y un Service de métricas para el controlador y otro para el inyector de CA — 50 objetos de Kubernetes en total. Las imágenes del controlador, del webhook, del inyector de CA y del solucionador ACME están fijadas a sus etiquetas de release, así que cada carga de trabajo hace referencia a una etiqueta de imagen fijada.