Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

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

FichierRôle
aggregate.yamlIntention du développeur : un seul composant sealed-secrets (core/security/sealed-secrets).
manifest.yamlAssocie le type de composant à la Recipe officielle à source (sealed-secrets).
release.yamlDocument 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 SealedSecret se 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ête uses et 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 :

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

Elle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :

Terminal window
cd sealed-secrets-controller

Build

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 :

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

Les 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 CustomResourceDefinition pour l’API de sealed-secrets (SealedSecret),
  • un Deployment — le contrôleur,
  • le RBAC qui le lie : un ClusterRole, un ClusterRoleBinding, deux Roles et deux RoleBindings,
  • 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é.