Variables d’environnement, hors de votre code

Stockez tokens, mots de passe et chaînes de connexion dans les paramètres de chaque application. Les valeurs restent masquées à l’écran, un .env arrive d’un simple collage et un redémarrage applique le changement sans nouvel envoi.

Commencer maintenantRéférence de l’API
Jusqu’à 256 variables par application, sur tous les plans. Aussi depuis la CLI et l’API.

Comment ça marche

Les variables appartiennent à l’application, pas aux fichiers que vous envoyez. Modifiez-en une et le prochain démarrage la prend en compte.

  1. 1

    Ajoutez ou collez

    Saisissez une clé et sa valeur, collez des lignes KEY=valeur dans un champ de clé ou importez un fichier .env.

  2. 2

    Enregistrez

    Un seul enregistrement envoie toute la liste. Les valeurs que le shell couperait ou développerait partent entre guillemets.

  3. 3

    Redémarrez

    Juste après l’enregistrement, le tableau de bord propose de redémarrer. L’application démarre avec les nouvelles valeurs, sans nouvel envoi.

Les secrets restent masqués à l’écran

L’éditeur, dans les paramètres de votre application, masque chaque valeur jusqu’à ce que vous la demandiez et regroupe les clés liées.

  • Valeurs masquées

    Les valeurs s’affichent en points. Révélez-en une avec l’œil, copiez-la sans la révéler ou cliquez dessus pour la modifier.

    • Chaque modification se valide ou s’annule à part
    • Maintenez Shift pour supprimer une ligne en un clic

  • Groupées par préfixe

    Les clés qui partagent un préfixe, comme DB_HOST et DB_USER, sont listées ensemble, par ordre alphabétique.

    • Recherche par clé au-delà de 15 variables
    • Un avertissement quand il reste peu de places

  • Variables Square Cloud

    HOST, PORT et SQUARECLOUD_APP_ID accompagnent chaque application, en lecture seule, avec une note sur le rôle de chacune.

    • HOST 0.0.0.0 et PORT 80 pour le HTTP
    • L’ID de l’application, lu par votre code
  • Jusqu’à 256 variables par application
  • Clés jusqu’à 1 024 caractères, valeurs jusqu’à 4 096
  • Dans un workspace, seuls les administrateurs ouvrent l’éditeur
  • Inclus dans tous les plans

Apportez le .env que vous avez déjà

Importez un fichier .env et vérifiez-le avant tout changement : nouvelles clés, clés qui seraient remplacées et lignes qui ne peuvent pas entrer, chacune avec son numéro de ligne et la raison.

  • Collez des lignes entières

    Collez plusieurs lignes KEY=valeur dans un champ de clé et chacune devient une ligne. Une clé que vous avez déjà prend la valeur collée.

    • Les commentaires et le préfixe export sont pris en compte
    • Coller dans une ligne remplie conserve cette variable

  • Définissez-les au déploiement

    Le formulaire de déploiement accepte aussi des variables et, si votre projet contient un .env.example, il vous propose ses clés à remplir.

    • Lit aussi .env.sample, .env.template et .env.dist
    • Laisse HOST et PORT à Square Cloud

  • Exportez ou copiez

    Téléchargez toutes les variables dans un fichier texte KEY=VALUE, ou copiez-les toutes, pour les reprendre dans une autre application.

    • Les valeurs sortent entre guillemets, prêtes à charger
    • Les lignes sans clé sont ignorées

Les valeurs arrivent dans votre code telles que vous les avez saisies

Votre application charge ses variables via un shell, où un espace, un $ ou un ; peut couper ou modifier une valeur. L’éditeur met ces valeurs entre guillemets pour vous.

  • Des guillemets là où il faut

    Une valeur avec des espaces ou des caractères comme $, &, ;, | ou ) passe entre guillemets simples quand vous la validez, l’importez ou enregistrez.

  • Guillemets risqués refusés

    Des guillemets doubles autour d’une valeur avec $ laisseraient le shell la développer : l’éditeur vous demande de les retirer ou d’utiliser des guillemets simples.

  • Des clés toujours valides

    Les espaces d’une clé deviennent des tirets bas, et une clé ne peut pas apparaître deux fois. À l’import, une clé doit commencer par une lettre ou _.

Depuis le terminal et l’API

Les mêmes variables sont accessibles depuis la CLI, la GitHub Action, l’extension VS Code et l’API REST.

CLI Square Cloud
squarecloud app env set DB_HOST=10.0.0.4 "GREETING=hi there"squarecloud app env set --from-file .envsquarecloud app env list

Depuis la version 3.1.1, la CLI met entre guillemets les valeurs avec des espaces ou des symboles. Voir tout ce que fait la CLI.

API REST
curl -X POST "https://api.squarecloud.app/v2/apps/$APP_ID/envs" \  -H "Authorization: $SQUARECLOUD_API_KEY" \  -H "Content-Type: application/json" \  -d '{"envs": {"NODE_ENV": "production", "LOG_LEVEL": "info"}}'curl -X POST "https://api.squarecloud.app/v2/apps/$APP_ID/restart" \  -H "Authorization: $SQUARECLOUD_API_KEY"

Envoyez les valeurs telles que le shell doit les lire, entre guillemets simples si elles contiennent des espaces ou des symboles. Un redémarrage les applique.

  • GET
    /v2/apps/{appId}/envs

    Liste les variables d’environnement de l’application.

  • POST
    /v2/apps/{appId}/envs

    Ajoute des variables ou modifie celles qui existent. Les autres restent telles quelles.

  • PUT
    /v2/apps/{appId}/envs

    Remplace toutes les variables par celles que vous envoyez.

  • DELETE
    /v2/apps/{appId}/envs

    Supprime les variables que vous indiquez.

  • Les clés d’API peuvent être limitées à envs:read ou envs:write, et à une seule application.
Référence de l’API

Questions sur les variables d’environnement

Que sont les variables d’environnement sur Square Cloud ?

Ce sont des paires clé-valeur stockées dans les paramètres de votre application et chargées à son démarrage. Elles gardent tokens, mots de passe et chaînes de connexion hors de votre code et des fichiers que vous envoyez. Chaque application a sa propre liste, jusqu’à 256 variables.

Dois-je redéployer après avoir modifié une variable ?

Non. Enregistrez la modification et redémarrez l’application : elle démarre avec les nouvelles valeurs, sans nouvel envoi. Jusqu’au redémarrage, le processus en cours garde les valeurs avec lesquelles il a démarré.

Quelles variables Square Cloud fournit-il ?

HOST (0.0.0.0), PORT (80) et SQUARECLOUD_APP_ID, l’ID de l’application. Elles s’affichent en lecture seule en haut de l’éditeur. Une application web qui écoute sur cet hôte et ce port est accessible en HTTP.

Comment stocker une valeur avec des espaces, des guillemets ou un $ ?

Saisissez-la telle quelle. Le tableau de bord et la CLI mettent ces valeurs entre guillemets simples pour que le shell les charge sans changement. Via l’API, envoyez-les déjà entre guillemets simples. Évitez les guillemets doubles autour d’une valeur avec $ : le shell la développerait.

Puis-je garder un fichier .env dans mon projet ?

Oui, mais importez-le plutôt dans le tableau de bord : les variables définies là-bas ont priorité sur les valeurs de ce fichier. Pour exclure le fichier de vos envois, listez-le dans squarecloud.ignore, que lisent la CLI et l’extension VS Code.

Qui peut voir les valeurs ?

Dans votre compte, vous seul. Dans un workspace, seuls les membres ayant la permission d’administrateur ouvrent l’éditeur. Une clé d’API a besoin du scope envs:read, ou d’un accès complet, pour les lire.

Combien de variables une application peut-elle avoir ?

Jusqu’à 256, avec des clés jusqu’à 1 024 caractères et des valeurs jusqu’à 4 096. L’éditeur vous prévient quand il reste peu de places et n’enregistre pas au-delà de la limite.

Les sites statiques ont-ils des variables d’environnement ?

Non. Un site statique est servi sous forme de fichiers, sans processus pour les lire, donc ses paramètres n’ont pas d’onglet de variables. Elles servent aux applications avec un runtime, comme Node.js, Python, Java, Go ou Rust.

Un plan pour chaque étape de votre projet

Commencez petit et évoluez quand vous en avez besoin, sans contrat d’engagement.

Comparer tous les plans

4,9 sur 5 · 402 avis sur Google + TrustpilotTrustpilot

Hébergé dans un datacenter partenaire disposant des certifications
Tier 3ISO 27001SOC 2 Type IIProtection DDoS permanente
Découvrez notre infrastructure

Prêt à faire évoluer votre projet ?

Rejoignez les plus de 500 000 développeurs qui ont utilisé Square Cloud pour héberger leurs projets.

Commencez dès maintenant sur Square CloudVoir les plans et les tarifs
  • Tarifs prévisibles
  • Aucune surprise de facturation
  • Déployez en quelques secondes
  • Haute disponibilité
  • Évoluez en toute stabilité
  • Redémarrage automatique
  • SSL et sécurité inclus
  • Conteneurs isolés