sealed-secrets — contrôleur Kubernetes de déchiffrement des SealedSecret
Cet exemple compile une petite stack réelle — le contrôleur sealed-secrets — à partir d’un seul Aggregate écrit par le développeur vers Kubernetes, adossé au chart Helm officiel de sealed-secrets servi depuis un dépôt de charts HTTPS.
sealed-secrets permet de committer en toute sécurité du contenu secret chiffré dans un système de gestion de versions : une clé publique chiffre un secret en une ressource personnalisée SealedSecret, et un contrôleur à l’échelle du cluster détenant la clé privée correspondante le déchiffre en un Secret Kubernetes natif. Le contrôleur étend l’API du cluster avec sa propre ressource personnalisée SealedSecret au lieu d’être un serveur vers lequel les applications routent, si bien qu’il ne prend aucune arête uses et n’exporte rien vers les consommateurs : les applications obtiennent leurs secrets en déclarant des ressources SealedSecret, et le contrôleur descelle les Secrets Kubernetes correspondants. Le contrôleur génère sa paire de clés de scellement dans le cluster à l’exécution, si bien qu’aucun contenu de clé n’est produit au moment du rendu.
Fichiers
| Fichier | Rôle |
|---|---|
aggregate.yaml | Intention du développeur : un seul composant sealed-secrets (core/security/sealed-secrets). |
manifest.yaml | Associe le type de composant à la Recipe officielle à source (sealed-secrets). |
release.yaml | Document de l’opérateur pour la cible Kubernetes : le dimensionnement des ressources de calcul de l’opérateur. |
Ce qu’il démontre
- Une seule surface de rédaction. Un seul Aggregate est la source de vérité sur ce qu’est le contrôleur ; le Manifest dit comment le réaliser.
- Un chart servi via HTTPS. La Recipe obtient le chart depuis un dépôt de charts HTTPS plutôt que depuis un registre OCI ; le build le résout et l’épingle lors de
aggrega pull. - Une CRD livrée dans le répertoire CRD du chart. La CustomResourceDefinition
SealedSecretse trouve dans le répertoire CRD natif de Helm du chart, et non dans les templates ; elle est rendue dans la sortie avec la release, sans condition. - Un contrôleur qui étend le cluster, sans arête de topologie. sealed-secrets ajoute sa propre ressource personnalisée à l’API du cluster ; les consommateurs demandent des secrets en déclarant des ressources
SealedSecret, si bien que le composant ne câble aucune arêteuseset n’exporte rien. - Un seul contrôleur cohérent. Le chart rend un seul contrôleur avec son RBAC et ses Services, sans datastore, cache ou broker étranger. La sortie rendue est identique octet par octet d’une exécution à l’autre pour la même entrée.
- Une image reproductible. La Recipe épingle l’image du contrôleur sur un tag de release résolvable (
docker.io/bitnami/sealed-secrets-controller:0.38.4), si bien que la charge de travail rendue référence une version épinglée.
Générer l’exemple
Vous pouvez construire cet exemple avec les commandes ci-dessous, ou le faire construire pour vous par votre assistant IA.
Écrivez l’exemple dans un nouveau dossier qui porte son nom :
aggrega scaffold --example sealed-secrets-controllerElle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :
cd sealed-secrets-controllerBuild
Cet espace de travail ne contient aucun .aggrega-config.yaml, si bien que les entités de la bibliothèque standard se résolvent depuis le registre du hub, hub.aggrega.ai, et qu’aucun flag de catalogue n’est nécessaire :
aggrega pull --release release.yamlaggrega build --release release.yamlLes artefacts rendus se trouvent sous dist/. Le build résout le chart upstream depuis le dépôt de charts HTTPS lors de aggrega pull et l’épingle dans un fichier de verrouillage.
Avec un assistant IA
Un assistant IA configuré avec les outils d’Aggrega peut faire de même : collez-lui ce prompt.
Utilisez uniquement les outils Aggrega et ne créez vous-même aucun dossier. Si le dossier de l’espace de travail ne contient pas encore de dossier `sealed-secrets-controller`, appelez une fois l’outil `scaffold` avec `example` défini sur `sealed-secrets-controller` et sans `dir` : il écrit l’exemple dans un nouveau dossier `sealed-secrets-controller`. Appelez ensuite l’outil `build` avec `workspace_root` défini sur `sealed-secrets-controller`, `release` défini sur `release.yaml`, `auto_pull` défini sur true et `write` défini sur true. Indiquez-moi quels fichiers le build a écrits ; ils se trouvent sous `sealed-secrets-controller/dist/`.Ce qui est rendu
Le build émet le contrôleur sealed-secrets sous forme d’un ensemble d’objets Kubernetes :
- une
CustomResourceDefinitionpour l’API de sealed-secrets (SealedSecret), - un
Deployment— le contrôleur, - le RBAC qui le lie : un
ClusterRole, unClusterRoleBinding, deuxRoles et deuxRoleBindings, - un
ServiceAccount, - deux
Services — le service du contrôleur et son service de métriques.
L’image du contrôleur est épinglée sur son tag de release, si bien que la charge de travail référence un tag d’image épinglé.