本頁面說明如何佈建 Looker (Google Cloud Core) 正式版或非正式版執行個體,並設定公開安全連線。
如要建立私人連線執行個體,必須在建立執行個體時指派設定。如要瞭解如何建立私人連線執行個體,請按照「建立 Looker (Google Cloud Core) Private Service Connect 執行個體」或「建立私人連線 (私人服務存取權) Looker (Google Cloud Core) 執行個體」說明文件頁面中的程序操作,而非下列程序。
事前準備
- 與銷售團隊合作,確保年約已完成,且專案已分配配額。
- 請確認您已為 Google Cloud 專案啟用計費功能。
- 在 Google Cloud 控制台的專案選取器頁面,建立 Google Cloud 專案或前往現有專案。
- 在 Google Cloud 控制台中,為專案啟用 Looker API。啟用 API 時,您可能需要重新整理控制台頁面,確認 API 已啟用。
- 如要使用 VPC Service Controls,您必須建立私人連線 (私人服務存取權) 執行個體,而非公開安全連線執行個體。
必要的角色
如要取得建立 Looker (Google Cloud Core) 執行個體所需的權限,請要求管理員針對執行個體所在的專案,授予您 Looker 管理員 (roles/looker.admin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
您可能也需要其他 IAM 角色,才能設定員工身分聯盟或客戶自行管理的加密金鑰 (CMEK)。如要進一步瞭解這些功能,請參閱「使用員工身分聯盟進行 Looker (Google Cloud Core) 使用者驗證」或「為 Looker (Google Cloud Core) 啟用 CMEK」說明文件頁面。
建立 Looker (Google Cloud Core) 執行個體
Looker (Google Cloud Core) 大約需要 60 分鐘才能產生新的執行個體。
如要建立 Looker (Google Cloud Core) 執行個體,請選取下列其中一個選項:
主控台
- 在 Google Cloud 控制台的專案中,前往 Looker (Google Cloud Core) 產品頁面。如果您已在這個專案中建立 Looker (Google Cloud Core) 執行個體,系統會開啟「Instances」(執行個體) 頁面。
- 點選「建立執行個體」。
- 在「執行個體名稱」部分,提供 Looker (Google Cloud Core) 執行個體的名稱。Looker (Google Cloud Core) 執行個體建立後,執行個體名稱不會與網址建立關聯。執行個體建立後,即無法變更名稱。
- 在「區域」部分,從下拉式選單選取適當選項,託管 Looker (Google Cloud Core) 執行個體。選取與訂閱合約相符的區域,因為會在這裡分配專案配額。如要查看可用區域,請參閱 Looker (Google Cloud Core) 位置說明文件頁面。執行個體建立後,即無法變更區域。
在「Edition」(版本) 部分,依據組織需求設定執行個體版本。版本類型會影響執行個體可用的部分功能。請務必選擇年約中列出的版本類型,並確認您已獲派該版本類型的配額。版本選項如下:
- Standard:Looker (Google Cloud Core) 平台,適合使用者不到 50 人的小型機構或團隊
- Enterprise:Looker (Google Cloud Core) 平台,具備強化版安全防護功能,適用於多種內部商業智慧 (BI) 和數據分析用途
- Embed:Looker (Google Cloud Core) 平台,適合大規模部署及維護可靠的外部數據分析和自訂應用程式
- 非正式環境版本:如需測試環境,請選取其中一個非正式環境版本。詳情請參閱「非正式環境執行個體」說明文件。
- 試用版:試用版的功能支援與對應的正式版相同,但試用版的有效期限為 90 天。
執行個體建立後即無法變更版本。如要變更版本,可以使用匯入和匯出功能,將 Looker (Google Cloud Core) 執行個體資料,移至設定為其他版本的新執行個體。
在「自訂執行個體」部分,按一下「顯示設定選項」,即可顯示一組可為執行個體自訂的其他設定。
在「連線」部分,選取「使用公開安全連線」。公開安全連線設定會指派可透過網際網路存取的外部 IP 位址,適用於所有版本類型。
-
在「Authentication」(驗證) 部分,選取執行個體的主要驗證方式。所有 Looker (Google Cloud Core) 執行個體都必須採用主要驗證方式。可用的主要驗證選項如下:
- Google OAuth:如果使用者透過 Google 帳戶 (Google Workspace 或 Cloud Identity) 進行驗證,請使用這個方法。這是預設選項。
- 員工身分聯盟 (SAML/OIDC):如果使用者透過外部識別資訊提供者 (例如 Okta、Microsoft Entra ID 或 Ping Identity) 驗證,且您想使用單一登入 (SSO) 搭配 IAM 存取控管,而不管理個別 Google 帳戶,請使用這個方法。
在「Release Channel」(發布管道) 區段中,選取最符合需求的發布管道:
- 快速:最早可使用功能。建議非正式環境執行個體採用的預設值。
- 一般:穩定性適中。建議您對正式環境的執行個體採用這項做法,
- 不使用發布管道:不使用發布管道。預覽期間,預設值為「無管道」。
如果您建立的是企業版或嵌入版執行個體,就會看到「加密」部分。在「Encryption」(加密) 部分,您可以選取要用於執行個體的加密類型。可用的加密選項如下:
- Google-managed encryption key:這是預設選項,不需額外設定。
- 客戶自行管理的加密金鑰 (CMEK):請參閱「搭配使用客戶自行管理的加密金鑰與 Looker (Google Cloud Core)」說明文件頁面,進一步瞭解 CMEK,以及如何在建立執行個體時設定 CMEK。執行個體建立後,即無法變更加密類型。
- 啟用通過 FIPS 140-3 1 級驗證的加密機制:請參閱「在 Looker (Google Cloud Core) 執行個體上啟用 FIPS 140-3 1 級法規遵循」說明文件頁面,進一步瞭解 Looker (Google Cloud Core) 對 FIPS 140-3 1 級的支援。
在「維護期間」部分,您可以視需要指定 Looker (Google Cloud Core) 排定維護作業的星期幾和小時。
在「拒絕維護期」部分,您可以指定 Looker (Google Cloud Core) 不安排維護作業的日期範圍。如果您同時將執行個體註冊至快速發布管道,或搭配一般發布管道使用加速安全性修補程式 (ASP) 設定旗標,就無法設定拒絕維護期。
在「Gemini in Looker」部分,您可以選擇為 Looker (Google Cloud Core) 執行個體啟用 Gemini in Looker 功能。如要啟用 Gemini in Looker,請依序選取「Gemini」和「早鳥測試者功能」。啟用早鳥測試者功能後,使用者就能存取 Gemini in Looker 的早鳥測試者功能。如需非公開的「早鳥測試者」專屬功能,請用 Gemini in Looker 預先發布版表單,為需要這些功能的使用者分別提出存取權要求。您必須啟用這項設定,才能在正式發布前預先發布版期間使用 Gemini。您也可以選取「早鳥測試者」資料使用。啟用這項設定,即表示您同意 Google 依據《Gemini for Google Cloud 早鳥測試者計畫條款》運用您的資料。如要停用 Looker (Google Cloud Core) 執行個體的 Gemini,請清除「Gemini」Gemini設定。
在「Knowledge Catalog 整合」部分,如果不希望 Looker (Google Cloud Core) 與 Knowledge Catalog 整合,可以勾選「停用 Knowledge Catalog 整合功能」核取方塊。Looker (Google Cloud Core) 和 Knowledge Catalog 預設為整合。
點選「建立」。
gcloud
- 如果您使用CMEK,請先建立 Looker 服務帳戶,並按照操作說明設定客戶自行管理的加密金鑰。
使用
gcloud looker instances create指令建立執行個體:gcloud looker instances create INSTANCE_NAME \ --project=PROJECT_ID \ [--oauth-client-id=OAUTH_CLIENT_ID \ --oauth-client-secret=OAUTH_CLIENT_SECRET] \ --region=REGION \ --edition=EDITION \ [--release-channel=RELEASE_CHANNEL]\ --public-ip-enabled \ --async
更改下列內容:
INSTANCE_NAME:Looker (Google Cloud Core) 執行個體的名稱,與執行個體網址無關。PROJECT_ID:您要建立 Looker (Google Cloud Core) 執行個體的 Google Cloud 專案名稱。OAUTH_CLIENT_ID和OAUTH_CLIENT_SECRET:設定 OAuth 用戶端時建立的 OAuth 用戶端 ID 和用戶端密鑰。只要執行個體啟用 Google 驗證,Google Cloud CLI 就需要這些旗標,包括您未指定任何驗證旗標時的預設情況。如果停用 Google 驗證 (例如僅設定員工身分聯盟),則可省略這些旗標。如果您設定 Google OAuth,請在建立執行個體後,在 OAuth 用戶端的「Authorized redirect URIs」(已授權的重新導向 URI) 部分輸入執行個體網址。REGION:託管 Looker (Google Cloud Core) 執行個體的區域。選取與訂閱合約相符的區域。如要查看可用區域,請參閱 Looker (Google Cloud Core) 位置說明文件頁面。執行個體建立後,即無法變更區域。EDITION:版本、環境類型 (正式版或非正式版),以及這是否為執行個體的試用版。可用值為core-standard-annual、core-enterprise-annual、core-embed-annual、nonprod-core-standard-annual、nonprod-core-enterprise-annual、nonprod-core-embed-annual、core-trial-standard、core-trial-enterprise和core-trial-embed。執行個體建立後即無法變更版本。如要變更版本,可以使用匯入和匯出功能,將 Looker (Google Cloud Core) 執行個體資料,移至設定為其他版本的新執行個體。RELEASE_CHANNEL:執行個體的發布管道。可用值為rapid、regular和no-channel。預先發布版期間的預設值為no-channel。如未在create指令中加入這個旗標,系統會使用預設管道建立執行個體。這項功能為預先發布版。
也請加入下列旗標:
--public-ip-enabled用於啟用公開安全連線。- 建議您在建立 Looker (Google Cloud Core) 執行個體時,使用
--async。
您可以新增更多參數,套用其他執行個體設定:
[--maintenance-window-day=MAINTENANCE_WINDOW_DAY --maintenance-window-time=MAINTENANCE_WINDOW_TIME] [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE --deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE --deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--kms-key=KMS_KEY_ID] [--accelerated-security-patch-enabled] [--no-accelerated-security-patch-enabled] [--fips-enabled] [--catalog-integration-enabled] [--no-catalog-integration-enabled] [--workforce-auth-enabled] [--google-auth-enabled] [--no-google-auth-enabled]更改下列內容:
MAINTENANCE_WINDOW_DAY:必須是下列其中一項:friday、monday、saturday、sunday、thursday、tuesday、wednesday。如要進一步瞭解維護期間設定,請參閱「管理 Looker (Google Cloud Core) 的維護政策」說明文件頁面。MAINTENANCE_WINDOW_TIME和DENY_MAINTENANCE_PERIOD_TIME:必須採用世界標準時間的 24 小時制格式 (例如 13:00、17:45)。DENY_MAINTENANCE_PERIOD_START_DATE和DENY_MAINTENANCE_PERIOD_END_DATE:必須採用YYYY-MM-DD格式。如果您同時將執行個體註冊至快速發布管道,或搭配一般發布管道使用加速安全性修補程式 (ASP) 設定旗標,就無法設定拒絕維護期。KMS_KEY_ID:必須是設定客戶自行管理的加密金鑰 (CMEK) 時建立的金鑰。
下列標記可啟用其他設定:
--accelerated-security-patch-enabled和--no-accelerated-security-patch-enabled:如果執行個體位於regular管道,且您想每兩週接收或停用安全性修補程式,請加入其中一個旗標。這項功能為預先發布版。--fips-enabled:啟用 FIPS 140-3 第 1 級法規遵循。- 將
--catalog-integration-enabled旗標替換為--no-catalog-integration-enabled旗標,即可停用 Looker (Google Cloud Core) 和 Knowledge Catalog 整合。
所有 Looker (Google Cloud Core) 執行個體都必須採用主要驗證方式。使用下列旗標,為執行個體設定主要驗證方式:
--google-auth-enabled和--no-google-auth-enabled:啟用或停用 Google OAuth 驗證。如果使用者透過 Google 帳戶 (Google Workspace 或 Cloud Identity) 進行驗證,請使用這個方法。在 gcloud CLI 中,如果未指定驗證旗標,系統預設會啟用 Google 驗證。只要啟用 Google 驗證,就必須加入--oauth-client-id和--oauth-client-secret。設定員工身分聯盟時,請加入--google-auth-enabled和 OAuth 旗標,支援 Google OAuth 做為次要驗證方式,或加入--no-google-auth-enabled明確停用 Google 驗證。--workforce-auth-enabled:將員工身分聯盟 (SAML/OIDC) 設為主要驗證方式。如果使用者透過外部識別資訊提供者 (例如 Okta、Microsoft Entra ID 或 Ping Identity) 進行驗證,且您希望透過 IAM 存取控管機制進行單一登入 (SSO),而不必管理個別 Google 帳戶,請使用這個方法。如果指定--workforce-auth-enabled,但不指定--google-auth-enabled,系統會停用 Google 驗證,因此不需要--oauth-client-id和--oauth-client-secret旗標。
Terraform
使用下列 Terraform 資源,佈建具備基本功能的標準 Looker (Google Cloud Core) 執行個體:
使用下列 Terraform 資源佈建標準 Looker (Google Cloud Core) 執行個體,並套用其他設定:
使用下列 Terraform 資源,佈建具有私人網路連線的企業版 Looker (Google Cloud Core) 執行個體:
如要瞭解如何套用或移除 Terraform 設定,請參閱「基本 Terraform 指令」。
執行個體建立作業一旦啟動,就無法暫停或終止。Terraform 資源佈建成功後,終端機會顯示下列訊息:
Creation complete after XmXs [id=projects/PROJECT-ID/locations/REGION/instances/my-instance-randomly-generated-name] Apply complete! Resources: X added, X changed, X destroyed.
執行個體建立期間,您可以在控制台的「執行個體」頁面查看狀態。您也可以按一下 Google Cloud 控制台選單中的通知圖示,查看執行個體建立活動。
建立公開安全連線執行個體後,執行個體的公開網址會顯示在「執行個體」頁面的「執行個體網址」欄中。
執行個體建立完成後,請前往「執行個體」頁面顯示的執行個體網址,然後使用 Google 帳戶登入,即可查看執行個體。
如要編輯執行個體設定 (包括視需要新增手動 OAuth 憑證),請前往執行個體詳細資料頁面,然後按一下「Edit」(編輯)。
疑難排解執行個體建立問題
如需疑難排解協助,請參閱「排解 Looker (Google Cloud Core) 執行個體建立失敗問題」說明文件頁面。