特殊變數

「特殊變數」指 Zeabur 幫你預先定義好、可以直接使用的環境變數。 Git 和 Prebuilt 服務均可使用。

引用方式

• 在 Zeabur 內的環境變數輸入框：使用 ${變數} 格式插入特殊變數。
• 在自己的應用程式：如同一般的環境變數引用方式 (process.env.VARIABLE)。

變數優先順序

服務間變數的展開優先順序如下：

• 目前服務定義的環境變數會是第一個取的值。
• 假如沒有定義，其他服務暴露 (Expose) 的環境變數會是第二取的值。
• 假如沒有定義，特殊變數會是第三取的值。

變數清單

Hostname / Port 類

• ${ZEABUR_[連線埠名稱]_URL}：某個 Port 對應的 URL。

  • 如 https://test.zeabur.app。

  • 這個 URL 是你在「網域」裡面設定的：

    

• ${ZEABUR_[連線埠名稱]_DOMAIN}：某個 Port 對應的網域。

  • 如 test.zeabur.app。
  • 這個 URL 是你在「網域」裡面設定的。

• ${CONTAINER_HOSTNAME}: 目前服務在 Zeabur 專案內的主機名稱 (hostname)。

  • 通常我們會建立一個有 Expose（向專案曝露）屬性的環境變數（如 ${MYSQL_HOST}）， 然後將 ${CONTAINER_HOSTNAME} 的值填入這個環境變數。
  • 不過假如你是要在 Zeabur 內引用其他服務的 Hostname，我們會更推薦使用 Zeabur 未來推出的 DNS 功能。

• ${[連線埠名稱]_PORT}：在 Prebuilt 服務裡面定義的連線埠。

  • 比如你設定了 database / 3306 / TCP，則 DATABASE_PORT 會是 3306。
  • 僅目前服務內可見。

Zeabur 資訊類

這裡的變數不常用到，但假如你需要目前 Zeabur 服務 / 專案的唯一識別碼， 則這裡的變數會很有幫助。

• ${ZEABUR_SERVICE_ID}：服務 ID
• ${ZEABUR_PROJECT_ID}：專案 ID
• ${ZEABUR_ENVIRONMENT_ID}：服務環境 ID
• ${ZEABUR_USER_ID}：建立這個專案的使用者 ID

Git 資訊類

這裡的變數只會出現在 Git 服務的編譯階段。

• ${ZEABUR_GIT_COMMIT_SHA}：目前部署所屬的 Git 提交 SHA 值。
• ${ZEABUR_GIT_AUTHOR}：目前部署所屬的 Git 提交作者 ID。
• ${ZEABUR_GIT_BRANCH}：目前部署所屬的 Git 分支名稱。
• ${ZEABUR_GIT_REPO_NAME}：目前部署所屬的 Git 版本庫名稱。
• ${ZEABUR_GIT_REPO_OWNER}：目前部署所屬的 Git 版本庫擁有者 ID。
• ${ZEABUR_GIT_COMMIT_MESSAGE}：目前部署所屬的 Git 提交訊息。

工具類

• ${PASSWORD}：Zeabur 為每個服務產生的隨機密碼。