external-secrets — opérateur Kubernetes de synchronisation des secrets
Cet exemple compile une petite stack réelle — l’opérateur external-secrets — à partir d’un seul Aggregate écrit par le développeur vers Kubernetes, en s’appuyant sur le chart Helm officiel d’external-secrets.
external-secrets synchronise du contenu secret depuis des systèmes externes de gestion de secrets — HashiCorp Vault, AWS Secrets Manager, Google Secret Manager, Azure Key Vault et d’autres — vers des Secrets Kubernetes natifs, en les maintenant synchronisés à mesure que la source change. C’est un contrôleur à l’échelle du cluster qui étend l’API du cluster avec ses propres ressources personnalisées, et non un serveur vers lequel les applications routent, si bien qu’il ne prend aucune arête uses, et tout ce qu’il publie, c’est l’endroit où un serveur Prometheus trouve ses métriques : les applications obtiennent leurs secrets en déclarant des ressources ExternalSecret et SecretStore, et l’opérateur matérialise les Secrets Kubernetes correspondants.
Fichiers
| Fichier | Rôle |
|---|---|
aggregate.yaml | Intention du développeur : un seul composant external-secrets (core/security/external-secrets) installant les définitions de ressources personnalisées avec la release. |
manifest.yaml | Mappe le type de composant vers la Recipe officielle à source (external-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 l’opérateur ; le Manifest dit comment le réaliser.
- Une valeur du développeur se propage jusqu’au rendu. La valeur
install_crdsdu développeur est écrite dans la valeurinstallCRDsdu chart, ce qui amène les définitions de ressources personnalisées d’external-secrets dans le cluster avec la release. - Un contrôleur qui étend le cluster, sans arête de topologie. external-secrets ajoute ses propres ressources personnalisées à l’API du cluster ; les consommateurs demandent des secrets en déclarant ces ressources, si bien que le composant ne câble aucune arête
useset n’exporte rien d’autre que l’endroit où se trouvent ses métriques. - Un seul opérateur cohérent. Le chart rend le contrôleur, le webhook et le contrôleur de certificats comme un seul opérateur ; le sous-chart de fournisseur inclus est désactivé, si bien qu’aucun datastore, cache ou broker étranger n’est intégré. 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 les trois images de conteneur sur un tag de release résolvable (
ghcr.io/external-secrets/external-secrets:v2.7.0), si bien que les charges de travail rendues référencent 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 external-secrets-operatorElle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :
cd external-secrets-operatorBuild
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 par référence OCI lors de aggrega pull et l’épingle dans un lockfile.
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 `external-secrets-operator`, appelez une fois l’outil `scaffold` avec `example` défini sur `external-secrets-operator` et sans `dir` : il écrit l’exemple dans un nouveau dossier `external-secrets-operator`. Appelez ensuite l’outil `build` avec `workspace_root` défini sur `external-secrets-operator`, `release` défini sur `release.yaml`, `auto_pull` défini sur true et `write` défini sur true. Indiquez-moi les fichiers écrits par le build ; ils se trouvent sous `external-secrets-operator/dist/`.Ce qui est rendu
Le build émet l’opérateur external-secrets sous forme d’un ensemble d’objets Kubernetes :
- 24
CustomResourceDefinitions pour l’API d’external-secrets (ExternalSecret,SecretStore,ClusterSecretStore, et les ressources de push et de générateurs associées), - trois
Deployments — le contrôleur, le webhook et le contrôleur de certificats, - le RBAC qui les lie : des
ClusterRoles, desClusterRoleBindings, unRoleet unRoleBinding, - trois
ServiceAccounts, un par charge de travail, - un
Servicepour le webhook, - deux
ValidatingWebhookConfigurations, - un
Secretd’espace réservé que le contrôleur de certificats remplit à l’exécution avec le certificat de service du webhook.
Les trois images de conteneur sont épinglées sur leur tag de release, si bien que les charges de travail référencent des images épinglées.