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

sealed-secrets — controlador de Kubernetes de descifrado de SealedSecret

Este ejemplo compila un stack pequeño y real — el controlador sealed-secrets — a partir de un único Aggregate escrito por el desarrollador para Kubernetes, respaldado por el chart de Helm oficial de sealed-secrets servido desde un repositorio de charts HTTPS.

sealed-secrets permite hacer commit de material secreto cifrado en el control de versiones de forma segura: una clave pública cifra un secreto en un recurso personalizado SealedSecret, y un controlador con ámbito de clúster que tiene la clave privada correspondiente lo descifra de nuevo en un Secret nativo de Kubernetes. El controlador extiende la API del clúster con su propio recurso personalizado SealedSecret en lugar de ser un servidor hacia el que enrutan las aplicaciones, así que no admite ninguna arista uses y no exporta nada a los consumidores: las aplicaciones obtienen sus secretos declarando recursos SealedSecret, y el controlador desella los Secrets de Kubernetes correspondientes. El controlador genera su par de claves de sellado en el clúster en tiempo de ejecución, así que no se produce ningún material de claves en tiempo de renderizado.

Archivos

ArchivoRol
aggregate.yamlIntención del desarrollador: un único componente sealed-secrets (core/security/sealed-secrets).
manifest.yamlAsigna el tipo de componente a la Recipe oficial con origen (sealed-secrets).
release.yamlDocumento 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 controlador; el Manifest dice cómo realizarlo.
  • Un chart servido por HTTPS. La Recipe obtiene el chart de un repositorio de charts HTTPS en lugar de un registro OCI; la compilación lo resuelve y lo fija en aggrega pull.
  • Una CRD incluida en el directorio de CRD del chart. La CustomResourceDefinition SealedSecret se encuentra en el directorio de CRD nativo de Helm del chart, no en las plantillas; se renderiza en la salida con la release de forma incondicional.
  • Un controlador que extiende el clúster, sin arista de topología. sealed-secrets añade su propio recurso personalizado a la API del clúster; los consumidores solicitan secretos declarando recursos SealedSecret, así que el componente no conecta ninguna arista uses y no exporta nada.
  • Un único controlador coherente. El chart renderiza un único controlador con su RBAC y sus Services, sin 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 la imagen del controlador a una etiqueta de release resoluble (docker.io/bitnami/sealed-secrets-controller:0.38.4), así que la carga de trabajo renderizada hace 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:

Terminal window
aggrega scaffold --example sealed-secrets-controller

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

Terminal window
cd sealed-secrets-controller

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 desde el repositorio de charts HTTPS en aggrega pull y lo fija en un archivo de bloqueo.

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 `sealed-secrets-controller`, llama una vez a la herramienta `scaffold` con `example` establecido en `sealed-secrets-controller` y sin `dir`: escribe el ejemplo en una nueva carpeta `sealed-secrets-controller`. Luego llama a la herramienta `build` con `workspace_root` establecido en `sealed-secrets-controller`, `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 `sealed-secrets-controller/dist/`.

Qué se renderiza

La compilación emite el controlador sealed-secrets como un conjunto de objetos de Kubernetes:

  • una CustomResourceDefinition para la API de sealed-secrets (SealedSecret),
  • un Deployment — el controlador,
  • el RBAC que lo vincula: un ClusterRole, un ClusterRoleBinding, dos Roles y dos RoleBindings,
  • una ServiceAccount,
  • dos Services — el servicio del controlador y su servicio de métricas.

La imagen del controlador está fijada a su etiqueta de release, así que la carga de trabajo hace referencia a una etiqueta de imagen fijada.