Variables et secrets

Variables par environnement, références entre services, variables scellées et historique.

Éditer les variables

L'onglet Variables d'un service liste ses variables pour l'environnement choisi. Le mode Raw accepte un fichier .env (commentaires et préfixe export ignorés). Les noms suivent [A-Z_][A-Z0-9_]*.

Une modification s'applique au prochain déploiement : après l'enregistrement, le bouton « Redeploy » relance le service.

Références entre services

Une valeur peut référencer une variable d'un autre service du projet : ${postgres.DATABASE_URL} (la syntaxe ${{postgres.DATABASE_URL}} est aussi acceptée). La référence est résolue au déploiement, jusqu'à 5 niveaux ; une boucle est signalée avec le nom de la variable en cause.

DATABASE_URL=${postgres.DATABASE_URL}
REDIS_URL=${redis.REDIS_URL}

Les variables partagées d'un environnement (Réglages du projet → Variables) sont injectées dans tous ses services, la variable propre d'un service l'emportant ; référencez-en une avec ${shared.NOM}. Le nom de service shared est réservé.

Variables scellées, historique, copie

  • Scellée : la valeur n'est plus jamais réaffichée dans la console (écriture seule). Une variable scellée ne peut pas être descellée.
  • Historique : chaque modification est conservée ; une ancienne valeur peut être restaurée.
  • Copie : les variables d'un environnement peuvent être copiées vers un autre.

Les valeurs sont chiffrées (AES-256-GCM) en base et déchiffrées au déploiement.

Variables fournies par Kapapra

  • PORT : port du service (8080 par défaut), non modifiable par une variable ;
  • KAPAPRA_SERVICE_NAME, KAPAPRA_ENVIRONMENT_NAME, KAPAPRA_DEPLOYMENT_ID ;
  • KAPAPRA_PUBLIC_DOMAIN (services web), KAPAPRA_PRIVATE_DOMAIN, KAPAPRA_GIT_COMMIT_SHA quand ils existent.
Variables et secrets — Kapapra docs