external-secrets — operador de Kubernetes de sincronización de secretos
Este ejemplo compila un stack pequeño y real — el operador external-secrets — a partir de un único Aggregate escrito por el desarrollador para Kubernetes, respaldado por el chart de Helm oficial de external-secrets.
external-secrets sincroniza material secreto desde sistemas externos de gestión de secretos — HashiCorp Vault, AWS Secrets Manager, Google Secret Manager, Azure Key Vault y otros — hacia Secrets nativos de Kubernetes, manteniéndolos sincronizados a medida que cambia el origen. Es un controlador con ámbito de clúster que extiende la API del clúster con sus propios recursos personalizados, en lugar de un servidor hacia el que enrutan las aplicaciones, así que no admite ninguna arista uses, y todo lo que publica es dónde encuentra un servidor Prometheus sus métricas: las aplicaciones obtienen sus secretos declarando recursos ExternalSecret y SecretStore, y el operador materializa los Secrets de Kubernetes correspondientes.
Archivos
| Archivo | Rol |
|---|---|
aggregate.yaml | Intención del desarrollador: un único componente external-secrets (core/security/external-secrets) que instala las definiciones de recursos personalizados con la release. |
manifest.yaml | Asigna el tipo de componente a la Recipe oficial con origen (external-secrets). |
release.yaml | Documento del operador para el destino Kubernetes: el dimensionamiento del cómputo del operador. |
Lo que demuestra
- Una única superficie de autoría. Un único Aggregate es la fuente de verdad sobre qué es el operador; el Manifest dice cómo realizarlo.
- Un valor del desarrollador llega al renderizado. El valor
install_crdsdel desarrollador se escribe en el valorinstallCRDsdel chart, lo que lleva las definiciones de recursos personalizados de external-secrets al clúster con la release. - Un controlador que extiende el clúster, sin arista de topología. external-secrets añade sus propios recursos personalizados a la API del clúster; los consumidores solicitan secretos declarando esos recursos, así que el componente no conecta ninguna arista
usesy no exporta nada más que dónde están sus métricas. - Un único operador coherente. El chart renderiza el controlador, el webhook y el controlador de certificados como un solo operador; el subchart de proveedor incluido está desactivado, así que no se incorpora ningún almacén de datos, caché ni broker ajeno. La salida renderizada es idéntica byte a byte entre ejecuciones con la misma entrada.
- Una imagen reproducible. La Recipe fija las tres imágenes de contenedor a una etiqueta de release resoluble (
ghcr.io/external-secrets/external-secrets:v2.7.0), así que las cargas de trabajo renderizadas hacen referencia a una versión fijada.
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 external-secrets-operatorDespués imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:
cd external-secrets-operatorCompilació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 por tu cuenta. Si la carpeta del espacio de trabajo aún no contiene una carpeta `external-secrets-operator`, llama una vez a la herramienta `scaffold` con `example` establecido en `external-secrets-operator` y sin `dir`: escribe el ejemplo en una nueva carpeta `external-secrets-operator`. Después llama a la herramienta `build` con `workspace_root` establecido en `external-secrets-operator`, `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 `external-secrets-operator/dist/`.Qué se renderiza
La compilación emite el operador external-secrets como un conjunto de objetos de Kubernetes:
- 24
CustomResourceDefinitions para la API de external-secrets (ExternalSecret,SecretStore,ClusterSecretStorey los recursos de push y de generadores relacionados), - tres
Deployments — el controlador, el webhook y el controlador de certificados, - el RBAC que los vincula:
ClusterRoles,ClusterRoleBindings, unRoley unRoleBinding, - tres
ServiceAccounts, una por carga de trabajo, - un
Servicepara el webhook, - dos
ValidatingWebhookConfigurations, - un
Secretde marcador de posición que el controlador de certificados rellena en tiempo de ejecución con el certificado de servicio del webhook.
Las tres imágenes de contenedor están fijadas a su etiqueta de release, así que las cargas de trabajo hacen referencia a imágenes fijadas.