Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

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

ArchivoRol
aggregate.yamlIntención del desarrollador: un único componente cert-manager (core/security/cert-manager) con la instalación de los CRD activada.
manifest.yamlAsigna el tipo de componente a la Recipe de Helm de cert-manager (cert-manager).
release.yamlDocumento 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 Deployment para el controlador que concilia las solicitudes de certificados, un Deployment para el webhook que valida los recursos personalizados y les asigna valores predeterminados, y un Deployment para 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_crds del desarrollador llega al chart, que instala las CustomResourceDefinitions de cert-manager (los recursos Certificate, Issuer, ClusterIssuer y ACME Order/Challenge). Ponlo en false cuando los CRD se gestionan por separado.
  • Cableado de admisión. El chart emite la ValidatingWebhookConfiguration y la MutatingWebhookConfiguration que sirve el webhook, el Service del webhook y el conjunto RBAC completo — un ClusterRole/ClusterRoleBinding por cada responsabilidad del controlador más los Roles 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:

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

Después imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:

Terminal window
cd cert-manager-tls

Compilació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:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

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