跳至主要內容
翻譯頁面

本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。

如何讓 StackQL 向 Google Cloud 進行驗證

StackQL 使用服務帳戶金鑰向 Google Cloud 進行驗證,金鑰以 JSON 內容的形式透過 GOOGLE_CREDENTIALS 環境變數提供。

步驟​

  1. 建立服務帳戶並授予它目標專案上的角色(唯讀查詢只需 roles/viewer 即可),然後建立並下載 JSON 金鑰:
gcloud iam service-accounts keys create stackql-key.json \
--iam-account=stackql-sa@my-project.iam.gserviceaccount.com
  1. 匯出金鑰內容:
export GOOGLE_CREDENTIALS=$(cat ./stackql-key.json)

另一種做法是使用 --auth 旗標以路徑傳遞金鑰,這對伺服器與 MCP 部署很有用:

stackql shell \
--auth='{"google": {"type": "service_account", "credentialsfilepath": "/path/to/stackql-key.json"}}'
  1. 提取 Google Provider(僅首次使用時):
REGISTRY PULL google;
  1. 以查詢確認:
SELECT name, status, machineType
FROM google.compute.instances
WHERE project = 'my-project';

這會使用 aggregated_list 存取方法,它只需要 project,並傳回所有可用區域中的執行個體。可用區域層級的 list 方法需要 project 和 zone;SHOW METHODS IN google.compute.instances 會顯示每個方法的必要參數。

憑證的適用範圍​

相同的變數(或 --auth 物件)適用於 stackql shell、stackql exec、stackql srv 與 stackql mcp。對於 Claude Desktop 和類似的 MCP 用戶端,請在伺服器設定的 env 區塊中設定 GOOGLE_CREDENTIALS。在 CI 中,請從平台的祕密存放區取得金鑰,切勿提交金鑰。