Zmienne środowiskowe.
Twoje własne zmienne i te, które Rivervo ustawia za ciebie, produkcja a podglądy, zastępowanie wartości automatycznej i kiedy zmiany zaczynają działać.
Klucze, hasła i ustawienia aplikacji trzymasz na karcie Zmienne. Są przechowywane w postaci zaszyfrowanej i trafiają do aplikacji jako zwykłe zmienne środowiskowe.
Dodawanie własnych zmiennych
Zmienne → Dodaj zmienną, wpisz NAZWĘ i wartość, potem Zapisz.
- Nazwa składa się z liter łacińskich, cyfr i
_i nie zaczyna się od cyfry. Każda nazwa musi być unikalna. - Wskazówka: wklej zawartość pliku
.envdo pola nazwy — wszystkie wiersze zostaną dodane naraz.
Zmienne trafiają do aplikacji w czasie działania — nie do etapu budowania. Zmiany docierają do aplikacji z następnym wdrożeniem. Po zapisaniu panel proponuje Wdróż teraz, co ponownie wdraża działającą wersję z nowymi zmiennymi, bez nowego budowania.
Produkcja i podglądy
Każda zmienna ma Środowisko:
| Środowisko | Dokąd trafia |
|---|---|
| Produkcja i podglądy | do aplikacji produkcyjnej i każdego podglądu gałęzi (domyślnie) |
| Tylko produkcja | tylko do aplikacji produkcyjnej — np. produkcyjny klucz płatności |
| Tylko podglądy | tylko do podglądów gałęzi — np. testowy klucz płatności |
Podglądy dostają tylko zmienne ustawione dla nich. Podgląd ma też własną kartę Zmienne: widzisz tam, co dostaje Z aplikacji, a twoja własna wartość o tej samej nazwie zastępuje je tylko w tym podglądzie.
Ustawiane automatycznie
Lista Ustawiane automatycznie pokazuje, co Rivervo zapewnia twojej aplikacji i aktualizuje na bieżąco. Tych zmiennych nie dodajesz sam:
| Zmienna | Kiedy |
|---|---|
PORT | zawsze — port, na którym nasłuchuje aplikacja |
DATABASE_URL, DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD | projekt ma bazę PostgreSQL lub MySQL |
PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD | baza danych to PostgreSQL |
REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_CLIENT | projekt ma Valkey |
RIVERVO_<NAME>_URL | dla każdej bazy danych, Valkey i repliki do odczytu w projekcie, według nazwy usługi |
RIVERVO_<NAME>_URL | dla każdej innej usługi webowej aplikacji — jej adres wewnętrzny, np. RIVERVO_API_URL=http://api:8080 (zobacz Komunikacja między usługami) |
S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_KEY, S3_SECRET | projekt ma magazyn obiektów |
APP_KEY, APP_ENV, APP_DEBUG, APP_URL, LOG_CHANNEL, SESSION_DRIVER, CACHE_STORE | aplikacja Laravel (zobacz Laravel) |
Pierwsza baza danych projektu dostaje zwykłe nazwy (DATABASE_URL, DB_*). Druga dodaje tylko własne RIVERVO_<NAME>_URL, więc nic nie przełącza się samo — zobacz Bazy danych.
Zastępowanie wartości automatycznej
Twoja własna zmienna o tej samej nazwie zajmuje miejsce automatycznej; panel oznacza ją jako Używana jest twoja wartość. Tak możesz skierować aplikację gdzie indziej, na przykład DATABASE_URL na inną bazę danych projektu.
Jedynym wyjątkiem jest PORT: zawsze zarządza nim Rivervo.
Usługi projektu
Każda usługa projektu — workery, zadania harmonogramu, inne usługi webowe — dostaje zmienne projektu, w tym jego bazę danych. Usługa może też mieć własne zmienne, które mają pierwszeństwo przed zmiennymi projektu. Usługa webowa zawsze dostaje własne APP_URL. Każda usługa z kodem dostaje też adres wewnętrzny każdej innej usługi webowej jako RIVERVO_<NAME>_URL; po dodaniu usługi webowej lub zmianie jej nazwy wdróż pozostałe usługi ponownie, żeby go dostały. Zobacz Usługi projektu.
Kto widzi wartości
Wartości widzi właściciel konta i osoby z rolą Programista lub Administrator w aplikacji. Rola Obserwator ich nie widzi. Zobacz Dostęp do aplikacji.