Utiliser les environnements depuis le code, la CI et les serveurs

Jetons machine, la CLI aman et les SDK Node, Python, Go, Java/Kotlin, PHP, .NET et Rust — déchiffrés chez vous.

Web
Sur cette page
  1. Créer un jeton
  2. La CLI
  3. SDK
  4. CI et Kubernetes

Les programmes lisent un environnement avec un jeton machine. Le déchiffrement a lieu sur la machine qui exécute le programme : Woosool ne voit jamais les valeurs.

Créer un jeton

Secrets → projet → environnement → Jetons machine : nommez-le, choisissez une expiration et, si vous le souhaitez, les adresses ou plages IP autorisées. Copiez le jeton wsv_… — affiché une seule fois — dans le coffre de secrets de votre CI ou la configuration du serveur sous AMAN_TOKEN, avec AMAN_URL à l'adresse de votre Aman.

Un jeton est en lecture seule et limité à un environnement. Il cesse de fonctionner à son expiration ou sa révocation, au renouvellement de la clé de l'environnement et quand son créateur perd l'accès (un admin peut le Réémettre). Son créateur peut aussi le réémettre pour changer le secret.

La CLI

curl -fsSL https://aman.woosool.com/aman.mjs -o aman.mjs      # Node 18 ou plus
node aman.mjs run -- npm start                               # variables seulement dans le programme
node aman.mjs pull --format dotenv --out .env                # ou json, yaml, shell, docker, k8s
node aman.mjs login --env prod                               # un jeton par environnement

pull n'affiche pas de secrets à l'écran sans --reveal et demande --force avant d'écrire un environnement protégé, ou un fichier que Git enregistrerait.

SDK

Node / TypeScript, Python, Go, Java / Kotlin, PHP, .NET et Rust s'utilisent de la même façon : créez le client (il lit AMAN_URL / AMAN_TOKEN), puis get("DATABASE_URL"), lisez tout ou injectez les variables dans le processus. Ils gardent un cache d'une minute, réessaient en cas d'erreur réseau et n'enregistrent jamais de valeurs dans les journaux.

CI et Kubernetes

Gardez le jeton dans le coffre de secrets de la CI et lancez la commande de déploiement via aman run --. Dans Kubernetes, seul le jeton est un Secret Kubernetes : lancez l'application via aman run --, ou laissez un conteneur d'initialisation écrire les variables dans un volume en mémoire.

Attention

Un jeton est un mot de passe pour machines. Ne le versionnez jamais ; donnez à chaque pipeline son propre jeton, avec une liste d'adresses IP quand c'est possible.