環境變數。
您自己的變數與 Rivervo 為您設定的變數、正式環境與預覽的區別、取代自動設定的值,以及變更何時生效。
應用程式的金鑰、密碼與設定都放在 變數 分頁中。這些值會加密儲存,並以一般環境變數的形式提供給您的應用程式。
新增自己的變數
變數 → 新增變數,輸入 名稱 與值,然後按 儲存。
- 名稱由拉丁字母、數字與
_組成,且不能以數字開頭。每個名稱都必須唯一。 - 提示: 將
.env檔案的內容貼到名稱欄位中——每一行都會一次新增。
變數是在應用程式執行時提供,而不是在建置階段。變更會 在下一次部署時 生效。儲存後,控制台會提供 立即部署,以新的變數重新部署目前執行的版本,不需重新建置。
正式環境與預覽
每個變數都有一個 環境:
| 環境 | 套用範圍 |
|---|---|
| 正式環境與預覽 | 線上應用程式與每個分支預覽(預設) |
| 僅正式環境 | 僅線上應用程式——例如正式的付款金鑰 |
| 僅預覽 | 僅分支預覽——例如測試用的付款金鑰 |
預覽只會取得為其設定的變數。預覽也有自己的 變數 分頁:您可以在那裡看到它 來自應用程式 的變數,而您自訂的同名值會僅在該預覽中取代它們。
自動設定
自動設定 清單顯示 Rivervo 為您的應用程式提供並保持更新的變數。這些不需要您自行新增:
| 變數 | 何時提供 |
|---|---|
PORT | 一律提供——您的應用程式監聽的連接埠 |
DATABASE_URL、DB_CONNECTION、DB_HOST、DB_PORT、DB_DATABASE、DB_USERNAME、DB_PASSWORD | 專案有 PostgreSQL 或 MySQL 資料庫 |
PGHOST、PGPORT、PGDATABASE、PGUSER、PGPASSWORD | 資料庫為 PostgreSQL |
REDIS_URL、REDIS_HOST、REDIS_PORT、REDIS_PASSWORD、REDIS_CLIENT | 專案有 Valkey |
RIVERVO_<NAME>_URL | 專案中的每個資料庫、Valkey 與唯讀副本,依服務名稱提供 |
RIVERVO_<NAME>_URL | 應用程式的其他每個 Web 服務——其內部位址,例如 RIVERVO_API_URL=http://api:8080(請參閱 服務間通訊) |
S3_ENDPOINT、S3_REGION、S3_BUCKET、S3_KEY、S3_SECRET | 專案有物件儲存 |
APP_KEY、APP_ENV、APP_DEBUG、APP_URL、LOG_CHANNEL、SESSION_DRIVER、CACHE_STORE | Laravel 應用程式(請參閱 Laravel) |
專案的第一個資料庫會取得常用名稱(DATABASE_URL、DB_*)。第二個資料庫只會新增自己的 RIVERVO_<NAME>_URL,因此不會自動切換——請參閱 資料庫。
取代自動設定的值
您自訂的同名變數會 取代 自動設定的變數;控制台會標示為 使用您的值。您可以藉此讓應用程式指向其他位置,例如讓 DATABASE_URL 指向專案中的另一個資料庫。
唯一的例外是 PORT:它一律由 Rivervo 管理。
專案的服務
專案中的每個服務——背景工作、排程工作、其他 Web 服務——都會取得專案的變數,包括其資料庫。服務也可以有自己的變數,並優先於專案的變數。Web 服務一律取得自己的 APP_URL。每個程式碼服務也會以 RIVERVO_<NAME>_URL 取得其他每個 Web 服務的內部位址;新增或重新命名 Web 服務後,請重新部署其他服務,讓它們取得新位址。請參閱 專案的服務。
誰能看到這些值
帳戶擁有者,以及在應用程式中擁有 開發人員 或 管理員 角色的人可以看到這些值。檢視者 角色看不到。請參閱 應用程式的存取權限。