Variabel environment.
Variabel Anda sendiri dan yang diatur Rivervo untuk Anda, production dan preview, mengganti nilai otomatis, serta kapan perubahan berlaku.
Kunci, password, dan pengaturan aplikasi Anda disimpan di tab Variabel. Semuanya disimpan dalam bentuk terenkripsi dan diteruskan ke aplikasi sebagai variabel environment biasa.
Menambahkan variabel sendiri
Variabel → Tambah variabel, isi NAMA dan nilainya, lalu Simpan.
- Nama terdiri dari huruf Latin, angka, dan
_, serta tidak diawali angka. Setiap nama harus unik. - Tips: tempel isi file
.envke kolom nama — setiap baris langsung ditambahkan sekaligus.
Variabel diteruskan ke aplikasi saat berjalan — bukan ke tahap build. Perubahan sampai ke aplikasi pada deploy berikutnya. Setelah menyimpan, panel menawarkan Deploy sekarang, yang men-deploy ulang versi yang sedang berjalan dengan variabel baru, tanpa build baru.
Production dan preview
Setiap variabel memiliki Environment:
| Environment | Diteruskan ke |
|---|---|
| Production dan preview | aplikasi live dan setiap preview branch (default) |
| Hanya production | hanya aplikasi live — misalnya kunci pembayaran live |
| Hanya preview | hanya preview branch — misalnya kunci pembayaran uji coba |
Preview hanya mendapat variabel yang diatur untuknya. Preview juga punya tab Variabel sendiri: di sana Anda melihat apa yang diterimanya Dari aplikasi, dan nilai Anda sendiri dengan nama yang sama akan menggantikannya khusus untuk preview tersebut.
Diatur otomatis
Daftar Diatur otomatis menampilkan apa yang disediakan Rivervo untuk aplikasi Anda dan selalu diperbarui. Anda tidak perlu menambahkannya sendiri:
| Variabel | Kapan |
|---|---|
PORT | selalu — port yang didengarkan aplikasi Anda |
DATABASE_URL, DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD | proyek memiliki database PostgreSQL atau MySQL |
PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD | database-nya PostgreSQL |
REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_CLIENT | proyek memiliki Valkey |
RIVERVO_<NAME>_URL | untuk setiap database, Valkey, dan read replica di proyek, berdasarkan nama layanannya |
RIVERVO_<NAME>_URL | untuk setiap web service lain di aplikasi — alamat internalnya, misalnya RIVERVO_API_URL=http://api:8080 (lihat Komunikasi antarlayanan) |
S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_KEY, S3_SECRET | proyek memiliki object storage |
APP_KEY, APP_ENV, APP_DEBUG, APP_URL, LOG_CHANNEL, SESSION_DRIVER, CACHE_STORE | aplikasi Laravel (lihat Laravel) |
Database pertama di proyek mendapat nama-nama yang biasa (DATABASE_URL, DB_*). Database kedua hanya menambahkan RIVERVO_<NAME>_URL miliknya sendiri, jadi tidak ada yang berpindah dengan sendirinya — lihat Database.
Mengganti nilai otomatis
Variabel Anda sendiri dengan nama yang sama akan menggantikan variabel otomatis; panel menandainya Nilai Anda yang dipakai. Gunakan ini untuk mengarahkan aplikasi ke tempat lain, misalnya DATABASE_URL ke database lain di proyek.
PORT satu-satunya pengecualian: variabel ini selalu dikelola oleh Rivervo.
Layanan dalam proyek
Setiap layanan dalam proyek — worker, tugas terjadwal, web service lain — mendapat variabel proyek, termasuk database-nya. Layanan juga bisa memiliki variabel sendiri, yang lebih diutamakan daripada variabel proyek. Web service selalu mendapat APP_URL sendiri. Setiap layanan kode juga mendapat alamat internal setiap web service lain sebagai RIVERVO_<NAME>_URL; setelah Anda menambah atau mengganti nama web service, deploy ulang layanan lain agar mereka mendapatkannya. Lihat Layanan dalam proyek.
Siapa yang bisa melihat nilainya
Nilai variabel terlihat oleh pemilik akun dan orang dengan peran Developer atau Administrator di aplikasi. Peran Viewer tidak bisa melihatnya. Lihat Akses ke aplikasi.