Variabili d'ambiente.
Le tue variabili e quelle che Rivervo imposta per te, produzione e anteprime, come sostituire un valore automatico e quando le modifiche hanno effetto.
Chiavi, password e impostazioni della tua applicazione si trovano nella scheda Variabili. Sono conservate cifrate e arrivano all'applicazione come normali variabili d'ambiente.
Aggiungere le tue
Variabili → Aggiungi una variabile, inserisci un NOME e un valore, poi Salva.
- Un nome contiene lettere latine, cifre e
_e non inizia con una cifra. Ogni nome deve essere unico. - Suggerimento: incolla il contenuto di un file
.envin un campo del nome e tutte le righe vengono aggiunte in una volta.
Le variabili arrivano all'applicazione quando è in esecuzione, non durante la build. Le modifiche arrivano all'applicazione con il deploy successivo. Dopo il salvataggio il pannello propone Esegui il deploy ora, che ripubblica la versione in esecuzione con le nuove variabili, senza una nuova build.
Produzione e anteprime
Ogni variabile ha un Ambiente:
| Ambiente | Dove arriva |
|---|---|
| Produzione e anteprime | l'applicazione live e ogni anteprima di branch (predefinito) |
| Solo produzione | solo l'applicazione live, ad esempio una chiave di pagamento reale |
| Solo anteprime | solo le anteprime dei branch, ad esempio una chiave di pagamento di test |
Le anteprime ricevono solo le variabili impostate per loro. Anche un'anteprima ha la sua scheda Variabili: lì vedi cosa riceve Dall'applicazione, e un tuo valore con lo stesso nome prende il loro posto solo per quell'anteprima.
Impostate automaticamente
L'elenco Impostate automaticamente mostra cosa fornisce Rivervo alla tua applicazione e mantiene aggiornato. Queste non le aggiungi tu:
| Variabile | Quando |
|---|---|
PORT | sempre: la porta su cui ascolta la tua applicazione |
DATABASE_URL, DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD | il progetto ha un database PostgreSQL o MySQL |
PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD | il database è PostgreSQL |
REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_CLIENT | il progetto ha Valkey |
RIVERVO_<NAME>_URL | per ogni database, Valkey e replica di lettura del progetto, in base al nome del servizio |
RIVERVO_<NAME>_URL | per ogni altro servizio web dell'applicazione: il suo indirizzo interno, ad esempio RIVERVO_API_URL=http://api:8080 (vedi Comunicazione tra servizi) |
S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_KEY, S3_SECRET | il progetto ha l'object storage |
APP_KEY, APP_ENV, APP_DEBUG, APP_URL, LOG_CHANNEL, SESSION_DRIVER, CACHE_STORE | un'applicazione Laravel (vedi Laravel) |
Il primo database di un progetto riceve i nomi abituali (DATABASE_URL, DB_*). Un secondo aggiunge solo la propria RIVERVO_<NAME>_URL, così nulla cambia da solo: vedi Database.
Sostituire un valore automatico
Una tua variabile con lo stesso nome prende il posto di quella automatica; il pannello la segna con Viene usato il tuo valore. Usalo per indirizzare l'applicazione altrove, ad esempio DATABASE_URL verso un altro database del progetto.
PORT è l'unica eccezione: è sempre gestita da Rivervo.
Servizi di un progetto
Ogni servizio di un progetto (worker, attività pianificate, altri servizi web) riceve le variabili del progetto, compreso il suo database. Un servizio può avere anche variabili proprie, che prevalgono su quelle del progetto. Un servizio web riceve sempre il proprio APP_URL. Ogni servizio con codice riceve anche l'indirizzo interno di ciascun altro servizio web come RIVERVO_<NAME>_URL; dopo aver aggiunto o rinominato un servizio web, rifai il deploy degli altri servizi perché lo ricevano. Vedi Servizi di un progetto.
Chi può vedere i valori
I valori sono visibili al proprietario dell'account e alle persone con il ruolo di Sviluppatore o Amministratore nell'applicazione. Il ruolo Osservatore non li vede. Vedi Accesso a un'applicazione.