您可以設定 Looker (Google Cloud Core) 正式版或非正式版執行個體,使用私人連線和私人服務存取權。
使用私人服務存取權,Looker (Google Cloud Core) 執行個體就能直接與虛擬私有雲 (VPC) 中的其他資源通訊,不必經過公開網際網路或使用外部 IP 位址。這項設定可限制攻擊向量、防止來自公開網際網路的傳入流量,並降低網路延遲。
私人連線可讓您使用 VPC Service Controls 等功能。不過,私人連線與部分 Looker (Google Cloud Core) 功能不相容。詳情請參閱功能相容性表格。
Looker (Google Cloud Core) 支援企業版或嵌入版執行個體的私人連線 (PSA)。
必要角色和權限
如要設定私人連線 (PSA) 執行個體,您必須具備下列 IAM 權限:
- 如要建立 Looker (Google Cloud Core) 執行個體,您必須具備 Looker 管理員 (
roles/looker.Admin) 角色。 -
如要取得建立分配 IP 位址範圍及管理私人連線所需的權限,請要求管理員授予您專案的Compute 網路管理員 (
roles/compute.networkAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。這個預先定義的角色具備建立分配 IP 位址範圍和管理私人連線所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
您必須具備下列權限,才能建立分配的 IP 位址範圍及管理私人連線:
-
在「Network」(網路) 下拉式選單中查看可用的網路:
-
compute.addresses.list -
compute.globalAddresses.list -
compute.networks.list -
compute.globalAddresses.list
-
-
建立新的虛擬私有雲網路:
-
compute.addresses.create -
compute.globalAddresses.create -
serviceusage.services.enable
-
-
分配私人 IP 範圍,並設定私人服務存取連線:
compute.networks.addPeering
如果您使用的是已設定的私人網路,則不需要這些權限。
-
在「Network」(網路) 下拉式選單中查看可用的網路:
您可能也需要其他 IAM 角色,才能設定員工身分聯盟、VPC Service Controls 或客戶自行管理的加密金鑰 (CMEK)。詳情請參閱「使用員工身分聯盟進行 Looker (Google Cloud Core) 使用者驗證」、「Looker (Google Cloud Core) 的 VPC Service Controls 支援」或「啟用 Looker (Google Cloud Core) 的 CMEK」。
事前準備
- 與銷售團隊合作,確保年約已完成,且專案已分配配額。
- 請確認您已為 Google Cloud 專案啟用計費功能。
- 在 Google Cloud 控制台的專案選取器頁面中,建立 Google Cloud 專案,或前往要建立 Looker (Google Cloud Core) 執行個體的現有專案。
- 在 Google Cloud 控制台中,為專案啟用 Looker API。啟用 API 時,您可能需要重新整理控制台頁面,確認 API 已啟用。
- 在 Google Cloud 控制台中,為專案啟用 Service Networking API。啟用 API 時,您可能需要重新整理控制台頁面,確認 API 已啟用。
- 在 Google Cloud 控制台中,為專案啟用 Compute Engine API。啟用 API 後,您可能需要重新整理控制台頁面,確認 API 已啟用。
- 如果您使用 Google OAuth 進行主要或次要驗證,或使用 Google Cloud CLI 建立執行個體,但未停用 Google 驗證,請設定 OAuth 用戶端並建立授權憑證。如果只設定員工身分聯盟,並停用 Google 驗證,則不必設定 OAuth 用戶端。
建立及設定虛擬私有雲網路
您必須先建立及設定虛擬私有雲 (VPC) 網路,才能建立私人連線。Looker (Google Cloud Core) 支援在同一個虛擬私有雲中,建立多個私人連線 (PSA) 執行個體,無論這些執行個體是否位於相同區域。
- 在專案中建立虛擬私有雲網路。或者,如果您使用Shared VPC,而非建立新的虛擬私有雲網路,請完成下一節「在 Shared VPC 中建立執行個體」中的步驟,並完成本節中其餘的 Shared VPC 步驟。
- 在虛擬私有雲中分配 IPv4 IP 範圍 (CIDR 區塊),用於 Looker (Google Cloud Core) 的私人服務存取連線。
- 分配範圍前,請先考量限制。
- 設定 IP 位址範圍大小時,請注意大小下限為
/22區塊。 - Looker (Google Cloud Core) 支援 RFC 1918 內的所有 IPv4 範圍,該標準指定了指派給內部 (即組織內) 使用的 IP 位址,且不會在網際網路上轉送。具體來說,這些是:
10.0.0.0/8172.16.0.0/12192.168.0.0/16- 如 RFC 5735 和 RFC 1112 所述,E 類 IPv4 範圍 (
240.0.0.0/4) 預留供日後使用,Looker (Google Cloud Core) 不支援。 - 使用上一步為「指派的分配項目」分配的 IP 範圍,將私人服務存取權連線新增至虛擬私有雲網路。
- 建立虛擬私有雲網路後,返回 Google Cloud 專案的「Create Looker instance」(建立 Looker 執行個體) 頁面。您可能需要重新整理頁面,系統才會辨識出虛擬私有雲網路。
/26 範圍子網路,該子網路是您建立 Looker (Google Cloud Core) 執行個體時保留的 /22 子網路。在相同虛擬私有雲和區域中,任何後續的私人連線 (PSA) Looker (Google Cloud Core) 執行個體,都會使用相同的僅限 Proxy 子網路。
完成上述步驟後,請按照「建立 Looker (Google Cloud Core) 執行個體」說明文件頁面的步驟操作,從「事前準備」一節開始,建立執行個體。
同一個虛擬私有雲中有多個私人連線執行個體
如果兩個以上的私人連線 Looker (Google Cloud Core) 執行個體位於相同區域和虛擬私有雲,且您刪除在該區域建立的第一個 Looker (Google Cloud Core) 執行個體,則僅限 Proxy 子網路不會釋出,因為其他執行個體仍在使用該子網路。如果您嘗試建立新的私人連線 (PSA) Looker (Google Cloud Core) 執行個體,並使用與已刪除執行個體相同的位址範圍 (包含僅限 Proxy 子網路的 IP 位址範圍),執行個體建立作業就會失敗,並顯示「IP ranges exhausted」錯誤。如要確認 IP 範圍是否在使用中,請檢查 Service Networking 的虛擬私有雲對等互連,並查看匯入路徑是否使用您感興趣的 IP 範圍。
在 Shared VPC 中建立執行個體
如要在Shared VPC中建立 Looker (Google Cloud Core) 執行個體,請在 Shared VPC 的主機專案中完成下列步驟:
- 在 Google Cloud 控制台,前往 Shared VPC 的主專案啟用 Looker API。啟用 API 後,您可能需要重新整理控制台頁面,確認 API 已啟用。
使用 gcloud
services identity create指令,在 Shared VPC 的主機專案中建立服務帳戶:gcloud beta services identity create --service=looker.googleapis.com \ --project=SHARED_HOST_PROJECT_ID
將 SHARED_HOST_PROJECT_ID 替換為 Shared VPC 的主專案 ID。
授予共用虛擬私有雲主專案中的服務帳戶 IAM 角色,該角色包含
compute.globalAddresses.getIAM 權限。接著,執行add-iam-policy-binding指令:gcloud projects add-iam-policy-binding SHARED_HOST_PROJECT_ID \ --member=serviceAccount:SA_EMAIL --role=ROLE_NAME
更改下列內容:
SHARED_HOST_PROJECT_ID:Shared VPC 的主機專案 ID。SA_EMAIL:您在 Shared VPC 主機專案中建立的服務帳戶電子郵件地址。ROLE_NAME:包含compute.globalAddresses.get權限的角色名稱。請使用下列其中一種格式:- 預先定義的角色:
roles/SERVICE.IDENTIFIER - 專案層級自訂角色:
projects/PROJECT_ID/roles/IDENTIFIER - 組織層級的自訂角色:
organizations/ORG_ID/roles/IDENTIFIER
如需預先定義角色的清單,請參閱「瞭解角色」。
- 預先定義的角色:
建立服務帳戶並授予 IAM 權限後,請稍候幾分鐘,讓服務帳戶和權限生效。
此外,請在共用虛擬私有雲中分配 IPv4 IP 範圍,並將私人服務存取連線新增至共用虛擬私有雲,如上一節「建立及設定虛擬私有雲網路」所述。
建立私人連線執行個體
Looker (Google Cloud Core) 大約需要 60 分鐘才能產生新的執行個體。
如要建立私人連線 (PSA) 執行個體,請使用 Google Cloud CLI 或 Terraform,並在建立時將執行個體設為私人連線 (PSA)。執行個體建立後,就無法新增或移除私人連線。
如要使用 Google Cloud CLI 建立私人連線 (PSA) 執行個體,請按照下列步驟操作:
- 如果您使用CMEK,請先按照操作說明建立服務帳戶、金鑰環和金鑰,再建立 Looker (Google Cloud Core) 執行個體。
使用
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 \ --private-ip-enabled \ --consumer-network=CONSUMER_NETWORK --reserved-range=RESERVED_RANGE \ [--no-public-ip-enabled]\ [--public-ip-enabled]\ [--release-channel=RELEASE_CHANNEL]
更改下列內容:
INSTANCE_NAME:Looker (Google Cloud Core) 執行個體的名稱,與執行個體網址無關。PROJECT_ID:您要建立 Looker (Google Cloud Core) 執行個體的 Google Cloud 專案名稱。OAUTH_CLIENT_ID和OAUTH_CLIENT_SECRET:設定 OAuth 用戶端時建立的 OAuth 用戶端 ID 和用戶端密鑰。只要執行個體啟用 Google 驗證,gcloud CLI 就需要這些旗標,包括未指定任何驗證旗標時的預設情況。如果停用 Google 驗證 (例如僅設定員工身分聯盟),則可省略這些旗標。如果您設定 Google OAuth,請在建立執行個體後,在 OAuth 用戶端的「Authorized redirect URIs」(已授權的重新導向 URI) 部分輸入執行個體網址。REGION:託管 Looker (Google Cloud Core) 執行個體的區域。選取與訂閱合約相符的區域。如要查看可用區域,請參閱「Looker (Google Cloud Core) 位置」說明文件頁面。EDITION:版本、環境類型 (正式版或非正式版),以及這是否為執行個體的試用版。如果是私人連線 (PSA) 執行個體,則應為core-enterprise-annual、core-embed-annual、nonprod-core-enterprise-annual、nonprod-core-embed-annual、core-trial-enterprise或core-trial-embed。請務必選擇年約中列出的版本類型,並確認您已分配配額。執行個體建立後即無法變更版本。如要變更版本,可以使用匯入和匯出功能,將 Looker (Google Cloud Core) 執行個體資料,移至設定為其他版本的新執行個體。CONSUMER_NETWORK:虛擬私有雲網路或 Shared VPC 網路,格式為projects/PROJECT_ID/global/networks/NETWORK_NAME。如要建立私人連線 (PSA) 執行個體,就必須設定這個項目。RESERVED_RANGE:虛擬私有雲中的 IP 位址範圍,Google 會在該範圍內為 Looker (Google Cloud Core) 執行個體佈建子網路。RELEASE_CHANNEL:執行個體的發布管道。可用值為rapid、regular和no-channel。預先發布版期間的預設值為no-channel。如未在create指令中加入這個旗標,系統會使用預設管道建立執行個體。這項功能為預先發布版。
您可以加入下列標記:
--private-ip-enabled會啟用私人連線 (PSA)。必須加入這個參數,才能建立私人連線 (PSA) 執行個體。--public-ip-enabled會啟用公開 IP。--no-public-ip-enabled會停用公開 IP。- 建議您在建立 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旗標。
執行個體建立期間,您可以在控制台的「執行個體」頁面查看狀態。您也可以按一下 Google Cloud 控制台選單中的通知圖示,查看執行個體建立活動。
如果您在設定執行個體時選擇混合式連線,可以透過執行個體的網址設定傳入存取權。您可以在 Google Cloud 控制台的「Instances」(執行個體) 頁面找到該網址,如果您設定了自訂網域,也可以在執行個體詳細資料頁面的「Custom domain」(自訂網域) 分頁找到該網址。您可以設定 IP 許可清單,限制傳入連線只能來自特定 IP 位址。如果建立僅限私人連線 (PSA) 的執行個體,「執行個體」頁面不會顯示網址。如要進一步瞭解如何設定私人連線 (PSA) 執行個體的存取權,請參閱下方的「在建立後存取私人服務連線執行個體」一節。
建立後存取私人服務存取權執行個體
如果建立的執行個體僅啟用私人連線,您不會收到執行個體的網址。如要存取執行個體,您必須為執行個體設定自訂網域,並將該自訂網域新增至執行個體的 OAuth 憑證。請按照「使用私人服務存取權存取 Looker (Google Cloud Core) 執行個體」說明文件頁面的指示,建立及存取自訂網域。
如果您建立的執行個體採用混合式網路設定,請按照「為使用公開連線的 Looker (Google Cloud Core) 執行個體設定自訂網域」說明文件頁面的指示,建立及存取自訂網域。
疑難排解執行個體建立問題
如需疑難排解協助,請參閱「排解 Looker (Google Cloud Core) 執行個體建立失敗問題」說明文件頁面。
後續步驟
- 如果您使用混合連線,請設定 IP 許可清單,將傳入流量限制在特定 IP 位址。
- 如果您使用混合連線或公開連線,請設定自訂網域。