Square CloudSquare Cloud

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.

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. 01

    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. 02

    Enregistrez

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

  3. 03

    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

Du premier deploy à 1 To de RAM, sans changer de plateforme. Chaque phase ajoute de la mémoire et des fonctionnalités à la précédente, et l'upgrade s'applique immédiatement.

Comparer tous les plans
1 Go → 2 Go

Hobby

Sortez l'idée du localhost et mettez-la en ligne.

  • Jusqu'à 2 vCPU
  • Métriques en temps réel
  • Blob Storage
  • Rollback en 1 clic
  • Square Shield anti-DDoS

À partir de12,49 R$/mois

4 Go → 8 Go

Standard

Recommandé

La production avec bases de données, domaine personnalisé et équipe.

  • Jusqu'à 4 vCPU
  • Bases de données
  • Domaine personnalisé
  • Load balancer
  • AI Gateway
  • Workspaces

À partir de44,99 R$/mois

12 Go → 24 Go

Pro

Plus de mémoire, des snapshots quotidiens et de la visibilité sur ce qui tourne.

  • Jusqu'à 12 vCPU
  • Snapshots quotidiens des applications
  • Analyse des performances
  • Support prioritaire

À partir de124,99 R$/mois

32 Go → 1 To

Enterprise

De grandes opérations, avec un canal Discord privé.

  • Jusqu'à 16 vCPU
  • Canal Discord privé

À partir de299,90 R$/mois

HobbyStandardProEnterprise
Calcul
Mémoire RAM1 Go → 2 Go4 Go → 8 Go12 Go → 24 Go32 Go → 1 To
vCPU1 → 246 → 1216
Plateforme
Métriques en temps réelInclusInclusInclusInclus
Blob StorageInclusInclusInclusInclus
Rollback en 1 clicInclusInclusInclusInclus
Square Shield anti-DDoSInclusInclusInclusInclus
Bases de donnéesNon inclusInclusInclusInclus
Domaine personnaliséNon inclusInclusInclusInclus
Load balancerapplications par domaineNon inclus2510
AI GatewayNon inclusInclusInclusInclus
Snapshots quotidiens des applicationsNon inclusNon inclusInclusInclus
Analyse des performancesNon inclusNon inclusInclusInclus
Équipe et support
Workspacesmembres par workspaceNon inclus3 → 710 → 2020 → 50
Support prioritaireNon inclusNon inclusInclusInclus
Canal Discord privéNon inclusNon inclusNon inclusInclus

4,9 sur 5

482 avis sur Google et Trustpilot

Hébergé dans un datacenter partenaire disposant des certifications

  • Tier 3
  • ISO 27001
  • SOC 2 Type II
  • Protection 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.

  • 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