Biến môi trường.
Biến của bạn và biến Rivervo đặt sẵn, môi trường production và bản xem trước, thay giá trị tự động, và khi nào thay đổi có hiệu lực.
Khóa, mật khẩu và cài đặt của ứng dụng nằm trong tab Variables. Chúng được lưu ở dạng mã hóa và đến ứng dụng dưới dạng biến môi trường thông thường.
Thêm biến của bạn
Variables → Add a variable, nhập NAME và giá trị, rồi nhấn Save.
- Tên gồm chữ Latin, chữ số và
_, không bắt đầu bằng chữ số. Mỗi tên phải là duy nhất. - Mẹo: dán nội dung tệp
.envvào ô tên — mọi dòng sẽ được thêm cùng lúc.
Biến được truyền cho ứng dụng khi chạy — không phải cho bước build. Thay đổi đến ứng dụng ở lần triển khai tiếp theo. Sau khi lưu, panel đề xuất Deploy now để triển khai lại phiên bản đang chạy với biến mới mà không cần build lại.
Production và bản xem trước
Mỗi biến có một Environment:
| Môi trường | Được truyền tới |
|---|---|
| Production and previews | ứng dụng đang chạy và mọi bản xem trước của nhánh (mặc định) |
| Production only | chỉ ứng dụng đang chạy — ví dụ khóa thanh toán thật |
| Previews only | chỉ bản xem trước của nhánh — ví dụ khóa thanh toán thử nghiệm |
Bản xem trước chỉ nhận các biến được đặt cho nó. Mỗi bản xem trước cũng có tab Variables riêng: tại đó bạn thấy những gì nó nhận From the application, và giá trị của bạn cùng tên sẽ thay thế chúng chỉ cho bản xem trước đó.
Biến tự động
Danh sách Set automatically cho thấy những gì Rivervo cung cấp cho ứng dụng và luôn cập nhật. Bạn không cần tự thêm các biến này:
| Biến | Khi nào |
|---|---|
PORT | luôn có — cổng mà ứng dụng lắng nghe |
DATABASE_URL, DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD | dự án có cơ sở dữ liệu PostgreSQL hoặc MySQL |
PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD | cơ sở dữ liệu là PostgreSQL |
REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_CLIENT | dự án có Valkey |
RIVERVO_<NAME>_URL | cho mỗi cơ sở dữ liệu, Valkey và read replica của dự án, theo tên dịch vụ |
RIVERVO_<NAME>_URL | cho mỗi web service khác của ứng dụng — địa chỉ nội bộ của nó, ví dụ RIVERVO_API_URL=http://api:8080 (xem Giao tiếp giữa các dịch vụ) |
S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_KEY, S3_SECRET | dự án có object storage |
APP_KEY, APP_ENV, APP_DEBUG, APP_URL, LOG_CHANNEL, SESSION_DRIVER, CACHE_STORE | ứng dụng Laravel (xem Laravel) |
Cơ sở dữ liệu đầu tiên của dự án nhận các tên quen thuộc (DATABASE_URL, DB_*). Cơ sở dữ liệu thứ hai chỉ thêm RIVERVO_<NAME>_URL của riêng nó, nên không có gì tự chuyển sang — xem Cơ sở dữ liệu.
Thay giá trị tự động
Biến của bạn có cùng tên sẽ thay thế biến tự động; panel đánh dấu là Your value is used. Dùng cách này để trỏ ứng dụng tới nơi khác, ví dụ DATABASE_URL tới một cơ sở dữ liệu khác của dự án.
PORT là ngoại lệ duy nhất: biến này luôn do Rivervo quản lý.
Các dịch vụ của dự án
Mọi dịch vụ của dự án — worker, tác vụ định kỳ, các web service khác — đều nhận biến của dự án, kể cả cơ sở dữ liệu. Dịch vụ cũng có thể có biến riêng, được ưu tiên hơn biến của dự án. Web service luôn nhận APP_URL riêng. Mỗi dịch vụ chạy mã cũng nhận địa chỉ nội bộ của từng web service khác dưới dạng RIVERVO_<NAME>_URL; sau khi thêm hoặc đổi tên web service, hãy triển khai lại các dịch vụ khác để chúng nhận được biến này. Xem Các dịch vụ của dự án.
Ai xem được giá trị
Giá trị hiển thị với chủ tài khoản và những người có vai trò Developer hoặc Administrator trong ứng dụng. Vai trò Viewer không xem được. Xem Quyền truy cập ứng dụng.