本文說明如何使用 Cloud Run 部署跨區域內部應用程式負載平衡器。如要進行這項設定,請為負載平衡器使用無伺服器 NEG 後端。
雖然本文說明 Cloud Run 設定,但 Cloud Run 的無伺服器 NEG 可以指向 Cloud Run 資源或 Cloud Run functions (第 2 代) 資源。
無伺服器 NEG 可讓您搭配負載平衡器使用 Cloud Run 服務。使用無伺服器 NEG 後端設定負載平衡器後,系統會將負載平衡器的要求轉送至 Cloud Run 後端。
跨區域負載平衡提供備援功能,因此如果無法連上某個區域,系統會自動將流量導向至其他區域。系統會根據 Envoy 的位置,將 Proxy 流量分配給 Cloud Run 服務,如下所示:
- 如果多地區 Cloud Run 服務與 Envoy 位於相同區域,系統會優先使用與 Envoy 位於相同區域的 NEG。只有在啟用離群值偵測功能,且本機 NEG 狀態不佳時,流量才會傳送至容錯移轉區域。
- 如果多區域 Cloud Run 服務與 Envoy 不在同一個區域,流量會平均分配到所有 NEG。系統不會優先選擇距離較近的 NEG。
- 如果啟用 Identity-Aware Proxy,則僅支援單一無伺服器 NEG。不過,您可以設定其他 Cloud Run 服務,但負載平衡器不會將任何流量傳送至這些服務。
事前準備
在您依循這份指南操作之前,請先熟悉以下概念:
部署 Cloud Run 服務
本頁的操作說明假設您已執行 Cloud Run 服務。
如要使用本頁面的範例,您可以使用任一 Cloud Run 快速入門導覽課程,部署 Cloud Run 服務。
如要禁止透過網際網路存取 Cloud Run 服務,請將 Ingress 限制為 internal
。來自內部應用程式負載平衡器的流量視為內部流量。
將 Cloud Run 服務放在多個區域,有助於避免單一區域發生故障。如要在 REGION_A
和 REGION_B
區域中部署 Cloud Run 服務,請執行下列指令:
gcloud
gcloud run deploy CLOUD_RUN_SERVICE_NAMEA \ --platform=managed \ --allow-unauthenticated \ --ingress=internal \ --region=REGION_A \ --image=IMAGE_URLA
gcloud run deploy CLOUD_RUN_SERVICE_NAMEB \ --platform=managed \ --allow-unauthenticated \ --ingress=internal \ --region=REGION_B \ --image=IMAGE_URLB
請記下您建立的服務名稱。本頁面接下來會說明如何設定負載平衡器,將要求轉送至這項服務。
設定 SSL 憑證資源
按照下列步驟建立 Certificate Manager SSL 憑證資源:
建議使用 Google 代管的憑證。
權限
如要依照本指南的說明操作,您必須能在專案中建立執行個體與修改網路。您必須是專案擁有者或編輯者,或是必須具有以下所有 Compute Engine 身分與存取權管理角色。
工作 | 必要角色 |
---|---|
建立網路、子網路和負載平衡器元件 | Compute 網路管理員 |
新增與移除防火牆規則 | Compute 安全管理員 |
建立執行個體 | Compute 執行個體管理員 |
詳情請參閱下列指南:
設定總覽
您可以按照下圖所示設定跨區域內部應用程式負載平衡器:
如圖所示,這個範例會在虛擬私有雲網路中建立跨區域內部應用程式負載平衡器,其中具有一個後端服務,以及 REGION_A
和 REGION_B
地區的兩個 Cloud Run 部署作業。
跨區域內部應用程式負載平衡器設定如下:
具有下列子網路的虛擬私有雲網路:
- 子網路
SUBNET_A
和REGION_A
中的僅限 Proxy 子網路。 - 子網路
SUBNET_B
和REGION_B
中的僅限 Proxy 子網路。
您必須在使用跨區域內部應用程式負載平衡器的虛擬私有雲網路的每個區域中,建立僅限 Proxy 的子網路。該地區的僅限 Proxy 子網路會在該地區的所有跨區域內部應用程式負載平衡器之間共用。系統會從僅限 Proxy 的子網路中,分配從負載平衡器傳送至服務後端之封包的來源位址。在本範例中,區域
REGION_A
的僅限 Proxy 子網路主要 IP 位址範圍為10.129.0.0/23
,而REGION_B
的主要 IP 位址範圍為10.130.0.0/23
,這是建議的子網路大小。- 子網路
允許僅限 Proxy 的子網路流量在網路中流動的防火牆規則。也就是說,新增一個規則,允許來自
10.129.0.0/23
和10.130.0.0/23
的 TCP 通訊埠80
、443
和8080
流量 (這個範例中的僅限 Proxy 的子網路範圍)。健康狀態檢查探測器的另一項防火牆規則。
高可用性設定,在
REGION_A
和REGION_B
區域中,為 Cloud Run 部署作業提供無伺服器後端。如果某個地區的後端發生故障,流量會容錯移轉至其他地區。監控後端使用情況和健康狀態的全域後端服務。請務必在後端服務上啟用離群值偵測。
全域網址對應,這項服務會剖析要求的網址,並根據要求網址的主機和路徑,將要求轉送至特定的後端服務。
通用目標 HTTP 或 HTTPS Proxy,這項服務會接收來自使用者的要求,並將其轉送至網址對應。如為 HTTPS,請設定地區安全資料傳輸層 (SSL) 憑證資源。如果您設定了 HTTPS 負載平衡,目標 Proxy 會使用 SSL 憑證解密 SSL 流量。目標 Proxy 可透過 HTTP 或 HTTPS 將流量轉送至您的執行個體。
具有負載平衡器內部 IP 位址的全域轉送規則,可將每個傳入要求轉送至目標 Proxy。
與轉送規則相關聯的內部 IP 位址可來自相同網路和區域中的任何子網路。請注意下列條件:
- IP 位址可以 (但不必) 來自與後端執行個體群組相同的子網路。
- IP 位址不得來自
--purpose
旗標設為GLOBAL_MANAGED_PROXY
的保留僅限 Proxy 子網路。 - 如要透過多個轉送規則使用相同的內部 IP 位址,請將 IP 位址
--purpose
標記設為SHARED_LOADBALANCER_VIP
。
選用:設定
GEO
類型的 DNS 轉送政策,將用戶端流量轉送至最接近用戶端的地區中的負載平衡器 VIP。
設定網路和子網路
在虛擬私有雲網路中,為設定後端的每個區域設定子網路。此外,請在要設定負載平衡器的每個區域中,設定 proxy-only-subnet
。
這個範例會使用以下虛擬私人雲端網路、地區和子網路:
電視網。網路為名為
NETWORK
的自訂模式虛擬私有雲網路。後端的子網路。
REGION_A
地區中名為SUBNET_A
的子網路使用10.1.2.0/24
做為其主要 IP 範圍。REGION_B
地區中名為SUBNET_B
的子網路使用10.1.3.0/24
做為其主要 IP 範圍。Proxy 的子網路。
REGION_A
地區中名為PROXY_SN_A
的子網路使用10.129.0.0/23
做為其主要 IP 範圍。REGION_B
地區中名為PROXY_SN_B
的子網路使用10.130.0.0/23
做為其主要 IP 範圍。
虛擬私有雲中的任何區域都能存取跨區域內部應用程式負載平衡器。因此任何區域的用戶端都能從全球存取負載平衡器後端。
設定後端子網路
主控台
在 Google Cloud 控制台中,前往「VPC networks」(虛擬私有雲網路) 頁面。
按一下「建立虛擬私有雲網路」。
提供網路的「名稱」。
在「Subnets」(子網路) 區段,將「Subnet creation mode」(子網路建立模式) 設為「Custom」(自訂)。
為負載平衡器的後端建立子網路。在「New subnet」(新的子網路) 區段中,輸入以下資訊:
- 提供這個子網路的 [Name] (名稱)。
- 選取「區域」:REGION_A
- 輸入 IP 位址範圍:
10.1.2.0/24
按一下 [完成]。
按一下 [新增子網路]。
為負載平衡器的後端建立子網路。在「New subnet」(新的子網路) 區段中,輸入以下資訊:
- 提供這個子網路的 [Name] (名稱)。
- 選取「區域」:REGION_B
- 輸入 IP 位址範圍:
10.1.3.0/24
按一下 [完成]。
點選「建立」。
gcloud
使用
gcloud compute networks create
指令建立自訂虛擬私有雲網路:gcloud compute networks create NETWORK --subnet-mode=custom
使用
gcloud compute networks subnets create
指令,在NETWORK
網路的REGION_A
地區中建立子網路:gcloud compute networks subnets create SUBNET_A \ --network=NETWORK \ --range=10.1.2.0/24 \ --region=REGION_A
使用
gcloud compute networks subnets create
指令,在NETWORK
網路的REGION_B
地區中建立子網路:gcloud compute networks subnets create SUBNET_B \ --network=NETWORK \ --range=10.1.3.0/24 \ --region=REGION_B
API
對 networks.insert
方法發出 POST
要求。將 PROJECT_ID
替換為您的專案 ID。
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks { "routingConfig": { "routingMode": "regional" }, "name": "NETWORK", "autoCreateSubnetworks": false }
對 subnetworks.insert
方法發出 POST
要求。將 PROJECT_ID
替換為您的專案 ID。
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_A/subnetworks { "name": "SUBNET_A", "network": "projects/PROJECT_ID/global/networks/NETWORK", "ipCidrRange": "10.1.2.0/24", "region": "projects/PROJECT_ID/regions/REGION_A", }
對 subnetworks.insert
方法發出 POST
要求。將 PROJECT_ID
替換為您的專案 ID。
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_B/subnetworks { "name": "SUBNET_B", "network": "projects/PROJECT_ID/global/networks/NETWORK", "ipCidrRange": "10.1.3.0/24", "region": "projects/PROJECT_ID/regions/REGION_B", }
設定僅限 Proxy 的子網路
僅限 Proxy 的子網路提供一組 IP 位址, Google Cloud 會代表您執行 Envoy Proxy。Proxy 會終止來自用戶端的連線,並建立與後端的連線。
這個僅限 Proxy 的子網路,會由與虛擬私有雲網路位於相同區域的所有 Envoy 型區域負載平衡器使用。每個地區和每個網路只能有一個活動的僅限 Proxy 子網路,用於特定用途。
控制台
如果您使用 Google Cloud 控制台,可以稍後在「Load balancing」(負載平衡) 頁面中建立僅限 Proxy 的子網路。
如要立即建立僅限 Proxy 的子網路,請按照下列步驟操作:
在 Google Cloud 控制台中,前往「VPC networks」(虛擬私有雲網路) 頁面。
- 按一下虛擬私有雲網路的名稱。
- 在「子網路」分頁中,按一下「新增子網路」。
- 提供僅限 Proxy 子網路的「名稱」。
- 在「Region」(區域) 清單中選取「REGION_A」。
- 在「Purpose」(用途) 清單中,選取「Cross-region Managed Proxy」(跨區域受管理 Proxy)。
- 在「IP address range」(IP 位址範圍) 欄位中,輸入
10.129.0.0/23
。 - 按一下「新增」。
在 REGION_B 中建立僅限 Proxy 的子網路
- 按一下 [新增子網路]。
- 提供僅限 Proxy 子網路的「名稱」。
- 在「Region」(區域) 清單中選取「REGION_B」。
- 在「Purpose」(用途) 清單中,選取「Cross-region Managed Proxy」(跨區域受管理 Proxy)。
- 在「IP address range」(IP 位址範圍) 欄位中,輸入
10.130.0.0/23
。 - 按一下「新增」。
gcloud
使用
gcloud compute networks subnets create
指令,建立僅限 Proxy 的子網路。
gcloud compute networks subnets create PROXY_SN_A \ --purpose=GLOBAL_MANAGED_PROXY \ --role=ACTIVE \ --region=REGION_A \ --network=NETWORK \ --range=10.129.0.0/23
gcloud compute networks subnets create PROXY_SN_B \ --purpose=GLOBAL_MANAGED_PROXY \ --role=ACTIVE \ --region=REGION_B \ --network=NETWORK \ --range=10.130.0.0/23
API
使用
subnetworks.insert
方法建立僅限 Proxy 的子網路,並將 PROJECT_ID
替換為您的專案 ID。
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_A/subnetworks { "name": "PROXY_SN_A", "ipCidrRange": "10.129.0.0/23", "network": "projects/PROJECT_ID/global/networks/NETWORK", "region": "projects/PROJECT_ID/regions/REGION_A", "purpose": "GLOBAL_MANAGED_PROXY", "role": "ACTIVE" }
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_B/subnetworks { "name": "PROXY_SN_B", "ipCidrRange": "10.130.0.0/23", "network": "projects/PROJECT_ID/global/networks/NETWORK", "region": "projects/PROJECT_ID/regions/REGION_B", "purpose": "GLOBAL_MANAGED_PROXY", "role": "ACTIVE" }
建立無伺服器 NEG
為 Cloud Run 服務建立無伺服器 NEG:
gcloud compute network-endpoint-groups create gl7ilb-serverless-neg-a \ --region=REGION_A \ --network-endpoint-type=serverless \ --cloud-run-service=CLOUD_RUN_SERVICE_NAMEA
gcloud compute network-endpoint-groups create gl7ilb-serverless-neg-b \ --region=REGION_B \ --network-endpoint-type=serverless \ --cloud-run-service=CLOUD_RUN_SERVICE_NAMEB
設定負載平衡器
從負載平衡器傳送至無伺服器 NEG 後端的流量,會使用在 VPC 外部定義的特殊路徑,不受防火牆規則限制。因此,如果負載平衡器只有無伺服器 NEG 後端,則不需要建立防火牆規則,允許流量從僅限 Proxy 的子網路傳送至無伺服器後端。
主控台
選取負載平衡器類型
前往 Google Cloud 控制台的「Load balancing」(負載平衡)頁面。
- 點選「建立負載平衡器」。
- 在「Type of load balancer」(負載平衡器類型) 部分,選取「Application Load Balancer (HTTP/HTTPS)」(應用程式負載平衡器 (HTTP/HTTPS)),然後點選「Next」(下一步)。
- 在「公開或內部」部分,選取「內部」,然後點選「下一步」。
- 在「Cross-region or single region deployment」(跨區域或單一區域部署) 部分,選取「Best for cross-region workloads」(最適合跨區域工作負載),然後點選「Next」(下一步)。
- 按一下 [設定]。
基本設定
- 在「Name」(名稱) 中輸入負載平衡器的名稱。
- 在「Network」(網路) 中選取 NETWORK。
設定前端,並使用兩項轉送規則
HTTP:
- 按一下「前端設定」。
- 提供轉送規則的「Name」(名稱)。
- 在「子網路區域」清單中選取「REGION_A」。
保留僅限 Proxy 子網路
- 在「Subnetwork」(子網路) 清單中選取「SUBNET_A」。
- 在「IP address」(IP 位址) 清單中,按一下「Create IP address」(建立 IP 位址)。 系統會開啟「保留靜態內部 IP 位址」頁面。
- 提供靜態 IP 位址的「名稱」。
- 在「Static IP address」(靜態 IP 位址) 清單中,選取「Let me choose」(自行選擇)。
- 在「Custom IP address」(自訂 IP 位址) 欄位中,輸入
10.1.2.99
。 - 選取「預訂」。
- 按一下 [完成]。
- 如要新增第二條轉送規則,請按一下「新增前端 IP 和通訊埠」。
- 提供轉送規則的「Name」(名稱)。
- 在「子網路區域」清單中選取「REGION_B」。
保留僅限 Proxy 子網路
- 在「Subnetwork」(子網路) 清單中選取「SUBNET_B」。
- 在「IP address」(IP 位址) 清單中,按一下「Create IP address」(建立 IP 位址)。 系統會開啟「保留靜態內部 IP 位址」頁面。
- 提供靜態 IP 位址的「名稱」。
- 在「Static IP address」(靜態 IP 位址) 清單中,選取「Let me choose」(自行選擇)。
- 在「Custom IP address」(自訂 IP 位址) 欄位中,輸入
10.1.3.99
。 - 選取「預訂」。
- 按一下 [完成]。
如果是 HTTPS:
如果您在用戶端與負載平衡器間使用的是 HTTPS,則需要有一個或多個 SSL 憑證資源才能設定 Proxy。如要建立 all-regions
Google 代管的憑證,請參閱下列說明文件:
建立 Google 代管憑證後, 直接將憑證附加至目標 Proxy。跨區域內部應用程式負載平衡器不支援憑證對應。
如要建立all-regions
自行管理的憑證,請參閱下列說明文件:
部署區域性自行管理的憑證。
- 按一下「前端設定」。
- 提供轉送規則的「Name」(名稱)。
- 在「Protocol」(通訊協定) 欄位中,選取「
HTTPS (includes HTTP/2)
」。 - 確認「Port」(通訊埠) 已設為
443
。 - 在「子網路區域」清單中選取「REGION_A」。
保留僅限 Proxy 子網路
- 在「Subnetwork」(子網路) 清單中選取「SUBNET_A」。
- 在「IP address」(IP 位址) 清單中,按一下「Create IP address」(建立 IP 位址)。 系統會開啟「保留靜態內部 IP 位址」頁面。
- 提供靜態 IP 位址的「名稱」。
- 在「Static IP address」(靜態 IP 位址) 清單中,選取「Let me choose」(自行選擇)。
- 在「Custom IP address」(自訂 IP 位址) 欄位中,輸入
10.1.3.99
。 - 選取「預訂」。
- 在「新增憑證」部分中,選取憑證。
- 選用:如要新增主要 SSL 憑證以外的憑證,請按照下列步驟操作:
- 按一下「新增憑證」。
- 從清單中選取憑證。
- 從「SSL policy」(SSL 政策) 清單中選取 SSL 政策。如果您尚未建立任何 SSL 政策,系統會套用預設 Google Cloud SSL 政策。
- 按一下 [完成]。
- 提供前端設定的「名稱」。
- 在「Protocol」(通訊協定) 欄位中,選取「
HTTPS (includes HTTP/2)
」。 - 確認「Port」(通訊埠) 已設為
443
。 - 在「子網路區域」清單中選取「REGION_B」。
保留僅限 Proxy 子網路
- 在「Subnetwork」(子網路) 清單中選取「SUBNET_B」。
- 在「IP address」(IP 位址) 清單中,按一下「Create IP address」(建立 IP 位址)。 系統會開啟「保留靜態內部 IP 位址」頁面。
- 提供靜態 IP 位址的「名稱」。
- 在「Static IP address」(靜態 IP 位址) 清單中,選取「Let me choose」(自行選擇)。
- 在「Custom IP address」(自訂 IP 位址) 欄位中,輸入
10.1.3.99
。 - 選取「預訂」。
- 在「新增憑證」部分中,選取憑證。
- 選用:如要新增主要 SSL 憑證以外的憑證,請按照下列步驟操作:
- 按一下「新增憑證」。
- 從清單中選取憑證。
- 從「SSL policy」(SSL 政策) 清單中選取 SSL 政策。如果您尚未建立任何 SSL 政策,系統會套用預設 Google Cloud SSL 政策。
- 按一下 [完成]。
- 按一下「後端設定」。
- 在「建立或選取後端服務」清單中,按一下「建立後端服務」。
- 提供後端服務的「Name」(名稱)。
- 在「通訊協定」部分選取「HTTP」。
- 在「Named Port」(已命名的通訊埠) 輸入
http
。 - 在「Backend type」(後端類型) 清單中,選取「無伺服器網路端點群組」。
- 在「New backend」(新後端) 部分中:
- 在「無伺服器網路端點群組」清單中,選取
gl7ilb-serverless-neg-a
。 - 按一下 [完成]。
- 如要新增其他後端,請按一下「新增後端」。
- 在「無伺服器網路端點群組」清單中,選取
gl7ilb-serverless-neg-b
。 - 按一下 [完成]。
- 按一下「轉送規則」。
- 在「模式」中,選取「簡易型主機與路徑規則」。
- 確認任何不相符主機和路徑只有一個後端服務。
- 按一下「檢查並完成」。
- 查看負載平衡器配置設定。
- 點選「建立」。
新增第二個前端設定:
設定轉送規則
檢查設定
gcloud
使用
gcloud compute backend-services create
指令定義後端服務。gcloud compute backend-services create gil7-backend-service \ --load-balancing-scheme=INTERNAL_MANAGED \ --protocol=HTTP \ --global
使用
gcloud compute backend-services add-backend
指令,將後端新增到後端服務。gcloud compute backend-services add-backend gil7-backend-service \ --network-endpoint-group=gl7ilb-serverless-neg-a \ --network-endpoint-group-region=REGION_A \ --global
gcloud compute backend-services add-backend gil7-backend-service \ --network-endpoint-group=gl7ilb-serverless-neg-b \ --network-endpoint-group-region=REGION_B \ --global
使用
gcloud compute url-maps create
指令建立網址對應。gcloud compute url-maps create gil7-map \ --default-service=gil7-backend-service \ --global
建立目標 Proxy。
HTTP:
使用
gcloud compute target-http-proxies create
指令建立目標 Proxy。gcloud compute target-http-proxies create gil7-http-proxy \ --url-map=gil7-map \ --global
HTTPS:
如要建立 Google 代管的憑證,請參閱下列說明文件:
建立 Google 代管憑證後,請直接將憑證附加至目標 Proxy。跨區域內部應用程式負載平衡器不支援憑證對應。
如要建立自行管理的憑證,請參閱下列說明文件:
將檔案路徑指派給變數名稱。
export LB_CERT=PATH_TO_PEM_FORMATTED_FILE
export LB_PRIVATE_KEY=PATH_TO_LB_PRIVATE_KEY_FILE
使用
gcloud certificate-manager certificates create
指令建立全區域 SSL 憑證。gcloud certificate-manager certificates create gilb-certificate \ --private-key-file=$LB_PRIVATE_KEY \ --certificate-file=$LB_CERT \ –-scope=all-regions
使用 SSL 憑證,透過
gcloud compute target-https-proxies create
指令建立目標 Proxygcloud compute target-https-proxies create gil7-https-proxy \ --url-map=gil7-map \ --certificate-manager-certificates=gilb-certificate
建立兩項轉送規則:一項規則的 VIP (
10.1.2.99
) 位於REGION_B
區域,另一項規則的 VIP (10.1.3.99
) 位於REGION_A
區域。如果是自訂網路,您必須參照轉送規則中的子網路。請注意,這是虛擬機器 (VM) 執行個體子網路,而不是 Proxy 子網路。
HTTP:
使用加上正確旗標的
gcloud compute forwarding-rules create
指令。gcloud compute forwarding-rules create gil7-forwarding-rule-a \ --load-balancing-scheme=INTERNAL_MANAGED \ --network=NETWORK \ --subnet=SUBNET_B \ --subnet-region=REGION_B \ --address=10.1.3.99 \ --ports=80 \ --target-http-proxy=gil7-http-proxy \ --global
gcloud compute forwarding-rules create gil7-forwarding-rule-b \ --load-balancing-scheme=INTERNAL_MANAGED \ --network=NETWORK \ --subnet=SUBNET_A \ --subnet-region=REGION_A \ --address=10.1.2.99 \ --ports=80 \ --target-http-proxy=gil7-http-proxy \ --global
HTTPS:
使用加上正確旗標的
gcloud compute forwarding-rules create
指令建立轉送規則。gcloud compute forwarding-rules create gil7-forwarding-rule-a \ --load-balancing-scheme=INTERNAL_MANAGED \ --network=NETWORK \ --subnet=SUBNET_B \ --address=10.1.3.99 \ --ports=443 \ --target-https-proxy=gil7-https-proxy \ --global
gcloud compute forwarding-rules create gil7-forwarding-rule-b \ --load-balancing-scheme=INTERNAL_MANAGED \ --network=NETWORK \ --subnet=SUBNET_A \ --address=10.1.2.99 \ --ports=443 \ --target-https-proxy=gil7-https-proxy \ --global
API
對 backendServices.insert
方法發出 POST
要求,建立全域後端服務,並將 PROJECT_ID
替換為您的專案 ID。
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices { "name": "gil7-backend-service", "backends": [ { "group": "projects/PROJECT_ID/zones/ZONE_A/instanceGroups/gl7ilb_serverless_negwest", "balancingMode": "UTILIZATION" }, { "group": "projects/PROJECT_ID/zones/ZONE_B/instanceGroups/gl7ilb_serverless_negeast", } ], "loadBalancingScheme": "INTERNAL_MANAGED" }
向 urlMaps.insert
方法發出 POST
要求,並將 PROJECT_ID
替換為您的專案 ID,即可建立網址對應。
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/urlMaps { "name": "l7-ilb-map", "defaultService": "projects/PROJECT_ID/global/backendServices/gil7-backend-service" }
HTTP:
對 targetHttpProxies.insert
方法發出 POST
要求,建立目標 HTTP Proxy,並將 PROJECT_ID
替換為您的專案 ID。
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetHttpProxy { "name": "l7-ilb-proxy", "urlMap": "projects/PROJECT_ID/global/urlMaps/l7-ilb-map" }
對 globalforwardingRules.insert
方法發出 POST
要求,建立轉送規則,並將 PROJECT_ID
替換為您的專案 ID。
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/forwardingRules { "name": "gil7-forwarding-rule-a", "IPAddress": "10.1.2.99", "IPProtocol": "TCP", "portRange": "80-80", "target": "projects/PROJECT_ID/global/targetHttpProxies/l7-ilb-proxy", "loadBalancingScheme": "INTERNAL_MANAGED", "subnetwork": "projects/PROJECT_ID/regions/REGION_A/subnetworks/SUBNET_A", "network": "projects/PROJECT_ID/global/networks/NETWORK", "networkTier": "PREMIUM" }
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/forwardingRules { "name": "gil7-forwarding-rule-b", "IPAddress": "10.1.3.99", "IPProtocol": "TCP", "portRange": "80-80", "target": "projects/PROJECT_ID/global/targetHttpProxies/l7-ilb-proxy", "loadBalancingScheme": "INTERNAL_MANAGED", "subnetwork": "projects/PROJECT_ID/regions/REGION_B/subnetworks/SUBNET_B", "network": "projects/PROJECT_ID/global/networks/NETWORK", "networkTier": "PREMIUM" }
HTTPS:
讀取憑證和私密金鑰檔案,然後建立 SSL 憑證。以下範例說明如何使用 Python 執行這項操作。
對 targetHttpsProxies.insert
方法發出 POST
要求,建立目標 HTTPS Proxy,並將 PROJECT_ID
替換為您的專案 ID。
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetHttpsProxy { "name": "l7-ilb-proxy", "urlMap": "projects/PROJECT_ID/global/urlMaps/l7-ilb-map", "sslCertificates": /projects/PROJECT_ID/global/sslCertificates/SSL_CERT_NAME }
對 globalForwardingRules.insert
方法發出 POST
要求,建立轉送規則,並將 PROJECT_ID
替換為您的專案 ID。
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/forwardingRules { "name": "gil7-forwarding-rule-a", "IPAddress": "10.1.2.99", "IPProtocol": "TCP", "portRange": "80-80", "target": "projects/PROJECT_ID/global/targetHttpsProxies/l7-ilb-proxy", "loadBalancingScheme": "INTERNAL_MANAGED", "subnetwork": "projects/PROJECT_ID/regions/REGION_A/subnetworks/SUBNET_A", "network": "projects/PROJECT_ID/global/networks/NETWORK", "networkTier": "PREMIUM" }
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/forwardingRules { "name": "gil7-forwarding-rule-b", "IPAddress": "10.1.3.99", "IPProtocol": "TCP", "portRange": "80-80", "target": "projects/PROJECT_ID/global/targetHttpsProxies/l7-ilb-proxy", "loadBalancingScheme": "INTERNAL_MANAGED", "subnetwork": "projects/PROJECT_ID/regions/REGION_B/subnetworks/SUBNET_B", "network": "projects/PROJECT_ID/global/networks/NETWORK", "networkTier": "PREMIUM" }
測試負載平衡器
負載平衡服務已開始運作,您可以將流量傳送至轉送規則,並觀察流量是否分散到不同的執行個體。
設定防火牆規則
這個範例需要測試用戶端 VM 的 fw-allow-ssh
防火牆規則。
fw-allow-ssh
是適用於測試用戶端 VM 的輸入規則,允許在 TCP 通訊埠 22
上來自任何位址的連入 SSH 連線。您可以為這項規則選擇較嚴格的來源 IP 位址範圍;例如,您可以僅指定要從其中啟動 SSH 工作階段之系統的 IP 位址範圍。本範例使用目標標記 allow-ssh
。
gcloud
建立
fw-allow-ssh
防火牆規則,允許與具有allow-ssh
網路標記的 VM 建立 SSH 連線。若省略source-ranges
,Google Cloud 會將規則解讀為任何來源。gcloud compute firewall-rules create fw-allow-ssh \ --network=NETWORK \ --action=allow \ --direction=ingress \ --target-tags=allow-ssh \ --rules=tcp:22
建立 VM 執行個體來測試連線能力
建立用戶端 VM:
gcloud compute instances create l7-ilb-client-a \ --image-family=debian-12 \ --image-project=debian-cloud \ --network=NETWORK \ --subnet=SUBNET_A \ --zone=ZONE_A \ --tags=allow-ssh
gcloud compute instances create l7-ilb-client-b \ --image-family=debian-12 \ --image-project=debian-cloud \ --network=NETWORK \ --subnet=SUBNET_B \ --zone=ZONE_B \ --tags=allow-ssh
使用 SSH 連線至每個用戶端執行個體。
gcloud compute ssh l7-ilb-client-a \ --zone=ZONE_A
gcloud compute ssh l7-ilb-client-b \ --zone=ZONE_B
確認 IP 位址是否提供主機名稱。
確認用戶端 VM 可以連上這兩個 IP 位址。指令會成功執行,並傳回處理要求的後端 VM 名稱:
HTTP 測試:
curl 10.1.2.99
curl 10.1.3.99
HTTPS 測試:
curl -k -s 'https://DOMAIN_NAME:443' --connect-to DOMAIN_NAME:443:10.1.2.99:443
curl -k -s 'https://DOMAIN_NAME:443' --connect-to DOMAIN_NAME:443:10.1.3.99:443
將 DOMAIN_NAME 替換為您的應用程式網域名稱,例如
test.example.com
。-k
旗標會讓 curl 略過憑證驗證。選用:使用設定的 DNS 記錄解析 IP 位址。
curl service.example.com
執行 100 個要求並確認它們可達到負載平衡
HTTP:
{ RESULTS= for i in {1..100} do RESULTS="$RESULTS:$(curl --silent 10.1.2.99)" done echo "" echo " Results of load-balancing to 10.1.2.99: " echo "***" echo "$RESULTS" | tr ':' '\n' | grep -Ev "^$" | sort | uniq -c echo }
{ RESULTS= for i in {1..100} do RESULTS="$RESULTS:$(curl --silent 10.1.3.99)" done echo "" echo " Results of load-balancing to 10.1.3.99: " echo "***" echo "$RESULTS" | tr ':' '\n' | grep -Ev "^$" | sort | uniq -c echo }
HTTPS:
將 DOMAIN_NAME 替換為您的應用程式網域名稱,例如 test.example.com
。
{ RESULTS= for i in {1..100} do RESULTS="$RESULTS:$(curl -k -s 'https://DOMAIN_NAME:443' --connect-to DOMAIN_NAME:443:10.1.2.99:443)" done echo "" echo " Results of load-balancing to 10.1.2.99: " echo "***" echo "$RESULTS" | tr ':' '\n' | grep -Ev "^$" | sort | uniq -c echo }
{ RESULTS= for i in {1..100} do RESULTS="$RESULTS:$(curl -k -s 'https://DOMAIN_NAME:443' --connect-to DOMAIN_NAME:443:10.1.3.99:443)" done echo "" echo " Results of load-balancing to 10.1.3.99: " echo "***" echo "$RESULTS" | tr ':' '\n' | grep -Ev "^$" | sort | uniq -c echo }
測試容錯移轉
確認當
REGION_B
區域中的後端健康狀態不良或無法連線時,系統會容錯移轉至REGION_A
區域中的後端。我們從REGION_B
移除所有後端,模擬這個情況:gcloud compute backend-services remove-backend gil7-backend-service \ --network-endpoint-group=gl7ilb-serverless-neg-b \ --network-endpoint-group-zone=ZONE_B
使用 SSH 連線至
REGION_B
中的用戶端 VM。gcloud compute ssh l7-ilb-client-b \ --zone=ZONE_B
將要求傳送至
REGION_B
區域中達到負載平衡的 IP 位址。指令輸出內容會顯示後端 VM 的回應,如REGION_A
所示。將 DOMAIN_NAME 替換為您的應用程式網域名稱,例如
test.example.com
。{ RESULTS= for i in {1..100} do RESULTS="$RESULTS:$(curl -k -s 'https://DOMAIN_NAME:443' --connect-to DOMAIN_NAME:443:10.1.3.99:443)" done echo "***" echo "*** Results of load-balancing to 10.1.3.99: " echo "***" echo "$RESULTS" | tr ':' '\n' | grep -Ev "^$" | sort | uniq -c echo }
額外設定選項
本節會延伸說明設定範例,並提供替代和其他設定選項。所有工作都是選擇性的。您可以按任何順序執行這些工作。
使用網址遮罩
建立無伺服器 NEG 時,您可以不選取特定 Cloud Run 服務,改用網址遮罩指向在相同網域提供服務的多個服務。網址遮罩是網址結構定義的範本。無伺服器 NEG 會使用這個範本,從傳入要求網址中擷取服務名稱,並將要求對應至適當的服務。
如果您的服務對應至自訂網域,而非 Google Cloud 為已部署服務提供的預設位址,網址遮罩就特別實用。即使應用程式使用自訂網址模式,您也能透過網址遮罩,使用單一規則指定多個服務和版本。
如果尚未閱讀,請務必先參閱無伺服器 NEG 總覽:網址遮罩。
建構網址遮罩
如要為負載平衡器建構網址遮罩,請先從服務的網址開始。本範例使用在 https://example.com/login
執行的範例無伺服器應用程式。這是應用程式 login
服務的放送網址。
- 從網址中移除
http
或https
。你還能產生example.com/login
組存取碼。 - 將服務名稱替換為網址遮罩的預留位置。
- Cloud Run:將 Cloud Run 服務名稱替換為預留位置
<service>
。如果 Cloud Run 服務有相關聯的標記,請將標記名稱替換為預留位置<tag>
。在本範例中,您最後會得到example.com/<service>
這個網址遮罩。
- Cloud Run:將 Cloud Run 服務名稱替換為預留位置
選用:如果可以從網址的路徑部分擷取服務名稱,則可以省略網域。網址遮蓋路徑部分是以第一個斜線 (
/
) 字元做為區別。如果網址遮罩中沒有斜線 (/
),系統會將遮罩解讀為只代表主機。因此,在這個範例中,網址遮罩可以縮減為/<service>
。同樣地,如果
<service>
可以從網址的主機部分擷取,您就可以從網址遮罩中完全省略路徑。您也可以省略第一個預留位置之前的所有主機或子網域元件,以及最後一個預留位置之後的所有路徑元件。在這種情況下,預留位置會擷取元件所需的資訊。
以下列舉更多範例,說明這些規則:
下表假設您有一個名為 example.com
的自訂網域,且所有 Cloud Run 服務都對應至這個網域。
服務、標記名稱 | Cloud Run 自訂網域網址 | 網址遮罩 |
---|---|---|
服務:登入 | https://login-home.example.com/web | <service>-home.example.com |
服務:登入 | https://example.com/login/web | example.com/<service> 或 /<service> |
service: login, tag: test | https://test.login.example.com/web | <tag>.<service>.example.com |
service: login, tag: test | https://example.com/home/login/test | example.com/home/<service>/<tag> 或 /home/<service>/<tag> |
service: login, tag: test | https://test.example.com/home/login/web | <tag>.example.com/home/<service> |
使用網址遮罩建立無伺服器 NEG
主控台
如果是新的負載平衡器,您可以按照本文先前所述,使用相同的端對端程序。設定後端服務時,請輸入網址遮罩,而非選取特定服務。
如果您有現有的負載平衡器,可以編輯後端設定,讓無伺服器 NEG 指向網址遮罩,而非特定服務。
如要將以網址遮罩為基礎的無伺服器 NEG 新增至現有後端服務,請按照下列步驟操作:
- 前往 Google Cloud 控制台的「Load balancing」(負載平衡)頁面。
前往「Load balancing」(負載平衡) - 按一下要編輯後端服務的負載平衡器名稱。
- 在「Load balancer details」(負載平衡器詳細資料) 頁面中,按一下 「Edit」(編輯)。
- 在「Edit global external Application Load Balancer」(編輯全域外部應用程式負載平衡器) 頁面上,點選「Backend configuration」(後端設定)。
- 在「Backend configuration」(後端設定) 頁面上,針對要修改的後端服務,點選「Edit」(編輯) 。
- 點選「新增後端」。
- 選取「建立無伺服器網路端點群組」。
- 在「Name」中輸入
helloworld-serverless-neg
。 - 「Region」下方會顯示負載平衡器的區域。
- 在「無伺服器網路端點群組類型」下方,只有「Cloud Run」是支援的網路端點群組類型。
- 選取「使用網址遮罩」。
- 輸入網址遮罩。如要瞭解如何建立網址遮罩,請參閱建構網址遮罩。
- 點選「建立」。
- 在「New backend」(新增後端) 中,按一下「Done」(完成)。
- 按一下「更新」。
gcloud
如要使用網址遮罩範例 example.com/<service>
建立無伺服器 NEG,請按照下列步驟操作:
gcloud compute network-endpoint-groups create SERVERLESS_NEG_MASK_NAME \ --region=REGION \ --network-endpoint-type=serverless \ --cloud-run-url-mask="example.com/<service>"
在多個內部轉送規則之間使用相同的 IP 位址
如要讓多個內部轉送規則共用同一個內部 IP 位址,您必須保留該 IP 位址,並將其 --purpose
旗標設為 SHARED_LOADBALANCER_VIP
。
gcloud
gcloud compute addresses create SHARED_IP_ADDRESS_NAME \ --region=REGION \ --subnet=SUBNET_NAME \ --purpose=SHARED_LOADBALANCER_VIP
設定 DNS 轉送政策
如果用戶端位於多個區域,您可能需要使用這些區域的 VIP,讓跨區域內部應用程式負載平衡器可供存取。這種多區域設定可將延遲時間和網路傳輸費用降至最低。此外,您也可以設定以 DNS 為基礎的全域負載平衡解決方案,防範區域性服務中斷。詳情請參閱「管理 DNS 轉送政策和健康狀態檢查」。
gcloud
如要建立 TTL 為 30 秒的 DNS 項目,請使用 gcloud dns record-sets create
指令。
gcloud dns record-sets create DNS_ENTRY --ttl="30" \ --type="A" --zone="service-zone" \ --routing-policy-type="GEO" \ --routing-policy-data="REGION_A=gil7-forwarding-rule-a@global;REGION_B=gil7-forwarding-rule-b@global" \ --enable-health-checking
更改下列內容:
DNS_ENTRY
:記錄集的 DNS 或網域名稱例如
service.example.com
。REGION_A
和REGION_B
: 您已設定負載平衡器的區域
API
對 ResourceRecordSets.create
方法發出 POST
要求,即可建立 DNS 記錄。將 PROJECT_ID 替換為您的專案 ID。
POST https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/SERVICE_ZONE/rrsets { "name": "DNS_ENTRY", "type": "A", "ttl": 30, "routingPolicy": { "geo": { "items": [ { "location": "REGION_A", "healthCheckedTargets": { "internalLoadBalancers": [ { "loadBalancerType": "globalL7ilb", "ipAddress": "IP_ADDRESS", "port": "80", "ipProtocol": "tcp", "networkUrl": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/lb-network", "project": "PROJECT_ID" } ] } }, { "location": "REGION_B", "healthCheckedTargets": { "internalLoadBalancers": [ { "loadBalancerType": "globalL7ilb", "ipAddress": "IP_ADDRESS_B", "port": "80", "ipProtocol": "tcp", "networkUrl": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/lb-network", "project": "PROJECT_ID" } ] } } ] } } }
啟用離群值偵測
您可以在全域後端服務上啟用離群值偵測,找出不正常的無伺服器 NEG,並減少傳送至不正常無伺服器 NEG 的要求數量。
您可以使用下列其中一種方法,在後端服務上啟用離群值偵測功能:
consecutiveErrors
方法 (outlierDetection.consecutiveErrors
),其中5xx
系列 HTTP 狀態碼會視為錯誤。consecutiveGatewayFailure
方法 (outlierDetection.consecutiveGatewayFailure
),其中只有502
、503
和504
HTTP 狀態碼符合錯誤資格。
請按照下列步驟,為現有後端服務啟用離群值偵測功能。請注意,即使啟用離群值偵測功能,部分要求仍可能會傳送至不健康的服務,並向用戶端傳回 5xx
狀態碼。如要進一步降低錯誤率,您可以為離群值偵測參數設定更積極的值。詳情請參閱outlierDetection
欄位。
主控台
前往 Google Cloud 控制台的「Load balancing」(負載平衡)頁面。
按一下您要編輯後端服務的負載平衡器名稱。
在「Load balancer details」(負載平衡器詳細資料) 頁面中,按一下「Edit」(編輯)。
在「Edit cross-region internal Application Load Balancer」(編輯跨區域內部應用程式負載平衡器) 頁面上,按一下「Backend configuration」(後端設定)。
在「Backend configuration」(後端設定) 頁面上,針對要修改的後端服務,點選「Edit」(編輯)
。向下捲動並展開「進階設定」部分。
在「Outlier detection」(離群值偵測) 專區中,選取「Enable」(啟用) 核取方塊。
按一下「編輯」
,設定離群值偵測。確認下列選項已設為指定的值:
屬性 值 連續錯誤 5 間隔 1000 基礎排除時間 30000 排除百分比上限 50 強制執行連續錯誤 100 在本例中,離群值偵測分析每秒執行一次。如果 Envoy Proxy 連續收到五個以上的 HTTP
5xx
狀態碼,後端端點就會從該 Envoy Proxy 的負載平衡集區中移除 30 秒。如果強制執行百分比設為 100%,每當異常情況偵測分析執行時,後端服務就會強制從這些特定 Envoy Proxy 的負載平衡集區中,排除健康狀態不良的端點。如果符合排除條件,最多可從負載平衡集區排除 50% 的後端端點。按一下 [儲存]。
如要更新後端服務,請按一下「更新」。
如要更新負載平衡器,請在「Edit cross-region internal Application Load Balancer」(編輯跨區域內部應用程式負載平衡器) 頁面上,按一下「Update」(更新)。
gcloud
將後端服務匯出至 YAML 檔案。
gcloud compute backend-services export BACKEND_SERVICE_NAME \ --destination=BACKEND_SERVICE_NAME.yaml --global
將
BACKEND_SERVICE_NAME
改為後端服務名稱。編輯後端服務的 YAML 設定,在
outlierDetection
區段中新增離群值偵測的欄位,如下列 YAML 設定中醒目顯示的部分:在本例中,離群值偵測分析每秒執行一次。如果 Envoy Proxy 連續收到五個以上的 HTTP
5xx
狀態碼,後端端點就會從該 Envoy Proxy 的負載平衡集區中移除 30 秒。如果強制執行百分比設為 100%,每當異常情況偵測分析執行時,後端服務就會強制從這些特定 Envoy Proxy 的負載平衡集區中,排除健康狀態不良的端點。如果符合排除條件,最多可從負載平衡集區排除 50% 的後端端點。name: BACKEND_SERVICE_NAME backends: - balancingMode: UTILIZATION capacityScaler: 1.0 group: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_A/networkEndpointGroups/SERVERLESS_NEG_NAME - balancingMode: UTILIZATION capacityScaler: 1.0 group: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_B/networkEndpointGroups/SERVERLESS_NEG_NAME_2 outlierDetection: baseEjectionTime: nanos: 0 seconds: 30 consecutiveErrors: 5 enforcingConsecutiveErrors: 100 interval: nanos: 0 seconds: 1 maxEjectionPercent: 50 port: 80 selfLink: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/BACKEND_SERVICE_NAME sessionAffinity: NONE timeoutSec: 30 ...
更改下列內容:
BACKEND_SERVICE_NAME
:後端服務的名稱PROJECT_ID
:您的專案 IDREGION_A
和REGION_B
: 已設定負載平衡器的區域。SERVERLESS_NEG_NAME
:第一個無伺服器 NEG 的名稱SERVERLESS_NEG_NAME_2
:第二個無伺服器 NEG 的名稱
匯入最新設定,更新後端服務。
gcloud compute backend-services import BACKEND_SERVICE_NAME \ --source=BACKEND_SERVICE_NAME.yaml --global
後端服務現已啟用離群值偵測功能。
刪除無伺服器 NEG
如果已將網路端點群組附加至後端服務,則無法予以刪除。刪除 NEG 之前,請確保已將其從後端服務卸離。
主控台
gcloud
如要從後端服務移除無伺服器 NEG,您必須指定建立 NEG 的區域。
gcloud compute backend-services remove-backend BACKEND_SERVICE_NAME \ --network-endpoint-group=SERVERLESS_NEG_NAME \ --network-endpoint-group-region=REGION \ --region=REGION
如要刪除無伺服器 NEG:
gcloud compute network-endpoint-groups delete SERVERLESS_NEG_NAME \ --region=REGION