Variabili d’ambiente fuori dal tuo codice

Conserva token, password e stringhe di connessione nelle impostazioni di ogni applicazione. I valori restano nascosti sullo schermo, un .env entra con un solo incolla e un riavvio applica la modifica senza un nuovo upload.

Inizia oraRiferimento API
Fino a 256 variabili per applicazione, in tutti i piani. Anche dalla CLI e dall’API.

Come funziona

Le variabili appartengono all’applicazione, non ai file che carichi. Cambiane una e il prossimo avvio la usa.

  1. 1

    Aggiungi o incolla

    Scrivi una chiave e il suo valore, incolla righe KEY=valore in un campo chiave o importa un file .env.

  2. 2

    Salva

    Un solo salvataggio invia l’intera lista. I valori che la shell taglierebbe o espanderebbe partono tra virgolette.

  3. 3

    Riavvia

    Subito dopo il salvataggio, la dashboard ti propone il riavvio. L’applicazione parte con i nuovi valori, senza un nuovo upload.

I segreti restano nascosti sullo schermo

L’editor nelle impostazioni della tua applicazione nasconde ogni valore finché non lo chiedi e tiene vicine le chiavi correlate.

  • Valori nascosti

    I valori appaiono come puntini. Mostrane uno con l’occhio, copialo senza mostrarlo o fai clic per modificarlo.

    • Ogni modifica si conferma o si annulla a parte
    • Tieni premuto Shift per rimuovere una riga con un clic

  • Raggruppate per prefisso

    Le chiavi con lo stesso prefisso, come DB_HOST e DB_USER, sono elencate insieme, in ordine alfabetico.

    • Ricerca per chiave oltre le 15 variabili
    • Un avviso compare quando restano pochi posti

  • Predefinite di Square Cloud

    HOST, PORT e SQUARECLOUD_APP_ID arrivano con ogni applicazione, in sola lettura e con una nota su a cosa serve ciascuna.

    • HOST 0.0.0.0 e PORT 80 per l’HTTP
    • L’ID dell’applicazione, per il tuo codice
  • Fino a 256 variabili per applicazione
  • Chiavi fino a 1.024 caratteri, valori fino a 4.096
  • In un workspace, solo gli amministratori aprono l’editor
  • Incluso in tutti i piani

Porta il .env che hai già

Importa un file .env e controllalo prima che cambi qualcosa: chiavi nuove, chiavi che verrebbero sostituite e righe che non possono entrare, ognuna con il numero di riga e il motivo.

  • Incolla righe intere

    Incolla più righe KEY=valore in un campo chiave e ognuna diventa una riga. Una chiave che hai già prende il valore incollato.

    • Commenti e prefisso export sono supportati
    • Incollare in una riga compilata mantiene quella variabile

  • Impostale durante il deploy

    Anche il modulo di deploy accetta variabili e, quando il progetto ha un .env.example, ti propone quelle chiavi da compilare.

    • Legge anche .env.sample, .env.template e .env.dist
    • Lascia HOST e PORT a Square Cloud

  • Esporta o copia

    Scarica tutte le variabili come file di testo KEY=VALUE, oppure copiale tutte, per portarle in un’altra applicazione.

    • I valori escono tra virgolette, pronti da caricare
    • Le righe senza chiave restano fuori

I valori arrivano al codice come li hai scritti

La tua applicazione carica le variabili tramite una shell, dove uno spazio, un $ o un ; può troncare o cambiare un valore. L’editor mette questi valori tra virgolette per te.

  • Virgolette dove servono

    Un valore con spazi o caratteri come $, &, ;, | o ) va tra virgolette singole quando lo confermi, lo importi o salvi.

  • Virgolette rischiose rifiutate

    Le virgolette doppie attorno a un valore con $ lascerebbero alla shell la possibilità di espanderlo, quindi l’editor ti chiede di toglierle o di usare quelle singole.

  • Chiavi sempre valide

    Gli spazi in una chiave diventano trattini bassi, e una chiave non può ripetersi. In un import, la chiave deve iniziare con una lettera o _.

Dal terminale e dall’API

Le stesse variabili sono raggiungibili dalla CLI, dalla GitHub Action, dall’estensione VS Code e dall’API REST.

CLI di 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

Dalla versione 3.1.1, la CLI mette tra virgolette i valori con spazi o simboli. Scopri tutto quello che fa 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"

Invia i valori come la shell deve leggerli, tra virgolette singole se hanno spazi o simboli. Un riavvio li applica.

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

    Elenca le variabili d’ambiente dell’applicazione.

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

    Aggiunge variabili o modifica quelle esistenti. Le altre restano come sono.

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

    Sostituisce tutte le variabili con quelle che invii.

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

    Rimuove le variabili che indichi.

  • Le chiavi API possono essere limitate a envs:read o envs:write e a una sola applicazione.
Riferimento API

Domande sulle variabili d’ambiente

Cosa sono le variabili d’ambiente su Square Cloud?

Sono coppie chiave-valore salvate nelle impostazioni della tua applicazione e caricate all’avvio. Tengono token, password e stringhe di connessione fuori dal tuo codice e dai file che carichi. Ogni applicazione ha la sua lista, fino a 256 variabili.

Devo rifare il deploy dopo aver cambiato una variabile?

No. Salva la modifica e riavvia l’applicazione: parte con i nuovi valori, senza un nuovo upload. Fino al riavvio, il processo attuale mantiene i valori con cui è partito.

Quali variabili fornisce Square Cloud?

HOST (0.0.0.0), PORT (80) e SQUARECLOUD_APP_ID, l’ID dell’applicazione. Compaiono in sola lettura in cima all’editor. Un’applicazione web in ascolto su quell’host e quella porta è raggiungibile via HTTP.

Come salvo un valore con spazi, virgolette o un $?

Scrivilo così com’è. La dashboard e la CLI mettono questi valori tra virgolette singole, così la shell li carica senza modifiche. Tramite l’API, inviali già tra virgolette singole. Evita le virgolette doppie attorno a un valore con $: la shell lo espanderebbe.

Posso tenere un file .env nel progetto?

Puoi, ma meglio importarlo nella dashboard: le variabili impostate lì hanno la precedenza sui valori di quel file. Per tenere il file fuori dai tuoi upload, elencalo in squarecloud.ignore, che leggono la CLI e l’estensione VS Code.

Chi può vedere i valori?

Nel tuo account, solo tu. In un workspace, solo i membri con permesso di amministratore aprono l’editor. Una chiave API ha bisogno dello scope envs:read, o dell’accesso completo, per leggerli.

Quante variabili può avere un’applicazione?

Fino a 256, con chiavi fino a 1.024 caratteri e valori fino a 4.096. L’editor ti avvisa quando restano pochi posti e non salva oltre il limite.

I siti statici hanno variabili d’ambiente?

No. Un sito statico viene servito come file, senza un processo che le legga, quindi le sue impostazioni non hanno la scheda delle variabili. Servono alle applicazioni con un runtime, come Node.js, Python, Java, Go o Rust.

Un piano per ogni fase del tuo progetto

Inizia in piccolo e scala quando ne hai bisogno, senza contratti di permanenza.

Confronta tutti i piani

4,9 su 5 · 402 recensioni su Google + TrustpilotTrustpilot

Ospitato in un datacenter partner con certificazioni
Tier 3ISO 27001SOC 2 Type IIProtezione DDoS Always-On
Esplora la nostra infrastruttura

Pronto a scalare il tuo progetto?

Unisciti agli oltre 500.000 sviluppatori che hanno usato Square Cloud per ospitare i loro progetti.

Inizia ora su Square CloudVedi piani e prezzi
  • Prezzi prevedibili
  • Nessuna sorpresa in fattura
  • Deploy in pochi secondi
  • Alta disponibilità
  • Scala con stabilità
  • Riavvio automatico
  • SSL e sicurezza inclusi
  • Container isolati