GCP BYOS（自帶訂閱）

將你自己的 GCP 專案連結到 Zeabur，讓 Zeabur 直接在你的 GCP 專案中建立 GKE 叢集、管理服務。

準備一個已綁定 billing 的 GCP 專案

選一個你想讓 Zeabur 使用的 GCP 專案，或建立一個新的。確認專案已綁定 billing account——沒綁 billing 的話 GKE 無法運作。

設定 connector service account

Zeabur 會在你的專案裡用一個叫 zeabur-connector 的 service account 管理 GKE 叢集，並透過 [email protected] 進行 impersonation。下面三種設定方式擇一即可。

在專案的 API 程式庫中啟用 Kubernetes Engine API 與 Cloud Resource Manager API。
進到 IAM 與管理 → 服務帳戶，建立一個名為 zeabur-connector 的 service account。
進到 IAM 與管理 → IAM，點 授予存取權，把 zeabur-connector@<PROJECT_ID>.iam.gserviceaccount.com 加為主體並賦予 roles/container.admin 角色。
回到 服務帳戶，點開 zeabur-connector，切到權限分頁，點 授予存取權，把 [email protected] 加為主體並賦予 roles/iam.serviceAccountTokenCreator 角色。

開啟 Cloud Shell（或任何已驗證 gcloud 的終端機），設定 PROJECT_ID 後執行：

export PROJECT_ID=your-gcp-project-id
 
gcloud services enable \
  container.googleapis.com \
  cloudresourcemanager.googleapis.com \
  --project=$PROJECT_ID
 
gcloud iam service-accounts create zeabur-connector --project=$PROJECT_ID
 
gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:zeabur-connector@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/container.admin"
 
gcloud iam service-accounts add-iam-policy-binding \
  zeabur-connector@$PROJECT_ID.iam.gserviceaccount.com \
  --member="serviceAccount:[email protected]" \
  --role="roles/iam.serviceAccountTokenCreator" \
  --project=$PROJECT_ID

把以下 prompt 貼到 Claude Code 或 Codex CLI——AI agent 會幫你跑完所有指令並回報你需要的資訊：

Set up Zeabur BYOS for GKE on a GCP project. Use gcloud (assume I'm authenticated).

1. Ask me which GCP project to use, or create a new one.
2. Make sure the project is linked to a billing account.
3. Run these commands (substitute PROJECT_ID):
   - gcloud services enable container.googleapis.com cloudresourcemanager.googleapis.com --project=PROJECT_ID
   - gcloud iam service-accounts create zeabur-connector --project=PROJECT_ID
   - gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:zeabur-connector@PROJECT_ID.iam.gserviceaccount.com" --role="roles/container.admin"
   - gcloud iam service-accounts add-iam-policy-binding zeabur-connector@PROJECT_ID.iam.gserviceaccount.com --member="serviceAccount:[email protected]" --role="roles/iam.serviceAccountTokenCreator" --project=PROJECT_ID

When done, print the project ID and the connector service account email so I can paste them into Zeabur's Bind GCP Service Account form.

將專案綁定到 Zeabur

前往 https://zeabur.com/account/byos，點擊 綁定 GCP Service Account，填入以下資訊後送出：

Service Account Email：zeabur-connector@<PROJECT_ID>.iam.gserviceaccount.com
專案 ID：你的 GCP 專案 ID

購買專屬叢集

Service account 綁定完成後，前往購買叢集頁面。你會看到一個新的 provider 選項 GCP - <專案名稱>。選它，Zeabur 就會直接在你的 GCP 專案中建立一個新的 GKE 叢集。

AWS AI Hub