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

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

FichierRôle
aggregate.yamlIntention du développeur : un seul composant external-secrets (core/security/external-secrets) installant les définitions de ressources personnalisées avec la release.
manifest.yamlMappe le type de composant vers la Recipe officielle à source (external-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 l’opérateur ; le Manifest dit comment le réaliser.
  • Une valeur du développeur se propage jusqu’au rendu. La valeur install_crds du développeur est écrite dans la valeur installCRDs du 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 uses et 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 :

Terminal window
aggrega scaffold --example external-secrets-operator

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

Terminal window
cd external-secrets-operator

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 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, des ClusterRoleBindings, un Role et un RoleBinding,
  • trois ServiceAccounts, un par charge de travail,
  • un Service pour le webhook,
  • deux ValidatingWebhookConfigurations,
  • un Secret d’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.