Omgevingsvariabelen.
Je eigen variabelen en de variabelen die Rivervo voor je instelt, productie tegenover previews, een automatische waarde vervangen, en wanneer wijzigingen ingaan.
Sleutels, wachtwoorden en instellingen voor je applicatie staan op het tabblad Variabelen. Ze worden versleuteld opgeslagen en komen bij je applicatie aan als gewone omgevingsvariabelen.
Eigen variabelen toevoegen
Variabelen → Variabele toevoegen, vul een NAAM en een waarde in en klik op Opslaan.
- Een naam bestaat uit Latijnse letters, cijfers en
_, en begint niet met een cijfer. Elke naam moet uniek zijn. - Tip: plak de inhoud van een
.env-bestand in een naamveld — elke regel wordt in één keer toegevoegd.
Variabelen komen bij de applicatie aan als die draait — niet bij de build. Wijzigingen komen bij de applicatie aan met de volgende deploy. Na het opslaan biedt het paneel Nu deployen aan: dat deployt de draaiende versie opnieuw met de nieuwe variabelen, zonder nieuwe build.
Productie en previews
Elke variabele heeft een Omgeving:
| Omgeving | Waar hij terechtkomt |
|---|---|
| Productie en previews | de live applicatie en elke branch-preview (standaard) |
| Alleen productie | alleen de live applicatie — bijvoorbeeld een live betaalsleutel |
| Alleen previews | alleen branch-previews — bijvoorbeeld een testbetaalsleutel |
Previews krijgen alleen de variabelen die voor hen zijn ingesteld. Een preview heeft ook een eigen tabblad Variabelen: daar zie je wat hij Van de applicatie krijgt, en een eigen waarde met dezelfde naam neemt alleen voor die preview de plaats daarvan in.
Automatisch ingesteld
De lijst Automatisch ingesteld toont wat Rivervo voor je applicatie regelt en actueel houdt. Deze variabelen voeg je niet zelf toe:
| Variabele | Wanneer |
|---|---|
PORT | altijd — de poort waarop je applicatie luistert |
DATABASE_URL, DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD | het project heeft een PostgreSQL- of MySQL-database |
PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD | de database is PostgreSQL |
REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_CLIENT | het project heeft Valkey |
RIVERVO_<NAME>_URL | voor elke database, Valkey en leesreplica van het project, op basis van de dienstnaam |
RIVERVO_<NAME>_URL | voor elke andere webdienst van de applicatie — het interne adres, bijvoorbeeld RIVERVO_API_URL=http://api:8080 (zie Communicatie tussen diensten) |
S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_KEY, S3_SECRET | het project heeft objectopslag |
APP_KEY, APP_ENV, APP_DEBUG, APP_URL, LOG_CHANNEL, SESSION_DRIVER, CACHE_STORE | een Laravel-applicatie (zie Laravel) |
De eerste database van een project krijgt de gebruikelijke namen (DATABASE_URL, DB_*). Een tweede voegt alleen een eigen RIVERVO_<NAME>_URL toe, zodat er niets vanzelf overschakelt — zie Databases.
Een automatische waarde vervangen
Een eigen variabele met dezelfde naam neemt de plaats in van de automatische; het paneel markeert die met Jouw waarde wordt gebruikt. Zo laat je de applicatie ergens anders naar verwijzen, bijvoorbeeld DATABASE_URL naar een andere database van het project.
PORT is de enige uitzondering: die wordt altijd door Rivervo beheerd.
Diensten van een project
Elke dienst van een project — workers, geplande taken, andere webdiensten — krijgt de variabelen van het project, ook de database. Een dienst kan daarnaast eigen variabelen hebben, die voorgaan op die van het project. Een webdienst krijgt altijd een eigen APP_URL. Elke codedienst krijgt ook het interne adres van elke andere webdienst als RIVERVO_<NAME>_URL; deploy de andere diensten opnieuw nadat je een webdienst hebt toegevoegd of hernoemd, zodat ze het adres krijgen. Zie Diensten van een project.
Wie de waarden kan zien
De waarden zijn zichtbaar voor de accounteigenaar en voor mensen met de rol Ontwikkelaar of Beheerder in de applicatie. De rol Kijker ziet ze niet. Zie Toegang tot een applicatie.