容器執行個體收到要求時,Cloud Run 會將這些要求從 HTTP/2 降級為 HTTP/1,但原生 gRPC 流量除外,因為這類流量需要 HTTP/2 才能正常運作。本頁面說明如何設定服務,使用端對端 HTTP/2,防止 Cloud Run 將要求降級為 HTTP1。
如要進一步瞭解如何使用 HTTP 叫用服務,請參閱「透過 HTTPS 要求叫用」。
設定前
Cloud Run 服務必須以 HTTP/2 明文 (h2c) 格式處理要求。Google 的前端服務基礎架構會終止 TLS,然後透過加密通道將 h2c 流量轉送至 Cloud Run 和容器。
如要確認服務支援 h2c 要求,請使用下列 curl 指令在本機測試服務:
curl -i --http2-prior-knowledge http://localhost:PORT
必要的角色
如要取得設定及部署 Cloud Run 服務所需的權限,請要求管理員授予您下列 IAM 角色:
- Cloud Run 服務的 Cloud Run 開發人員 (
roles/run.developer) - 服務身分的服務帳戶使用者 (
roles/iam.serviceAccountUser)
如果您是從原始碼部署服務或函式,則必須在專案和 Cloud Build 服務帳戶中,取得額外角色。
如要查看與 Cloud Run 相關聯的 IAM 角色和權限清單,請參閱「Cloud Run IAM 角色」和「Cloud Run IAM 權限」。如果 Cloud Run 服務與Google Cloud API (例如 Cloud 用戶端程式庫) 互動,請參閱服務身分設定指南。如要進一步瞭解如何授予角色,請參閱「部署權限」和「管理存取權」。
支援的 HTTP/2 服務
HTTP/2 適合多種應用程式。常見用途包括:
- gRPC 服務:建構高效能、低延遲的微服務,並使用 gRPC 進行通訊。
- 高處理量 API:如果應用程式需要有效率地處理大量小型要求,或需要將資料推送至用戶端,可減少這類應用程式的負擔。
設定及更新 HTTP/2 端對端
任何設定變更都會建立新的修訂版本。除非您明確更新設定,否則後續修訂版本也會自動套用這項設定。
建立新服務或部署新修訂版本時,您可以使用 Google Cloud 控制台、Google Cloud CLI 或 YAML,指定使用 HTTP/2 端對端:
控制台
前往 Google Cloud 控制台的「Cloud Run」頁面:
從 Cloud Run 導覽選單中選取「Services」(服務):
如要設定新服務,請按一下「Deploy container」(部署容器),然後填寫初始服務設定頁面。然後按一下「Containers, Networking, Security」(容器、網路、安全性),展開服務設定頁面。
如要設定現有服務,請按一下該服務。
按一下 [網路] 分頁標籤。
勾選「Use HTTP/2 end-to-end」(使用 HTTP/2 端對端) 旁的核取方塊。請確認自訂容器映像檔支援 HTTP/2 要求。
按一下「建立」,建立新服務。依序點選「查看差異並重新部署」和「部署變更」,即可更新現有服務。
gcloud
您可以使用下列指令,更新特定服務,改用 HTTP/2:
gcloud run services update SERVICE --use-http2
將 SERVICE 改為您的服務名稱。
您也可以在部署期間,使用下列指令將服務設為使用 HTTP/2:
gcloud run deploy --image IMAGE_URL --use-http2
將 IMAGE_URL 替換為支援 HTTP/2 要求的自訂容器映像檔參照。
YAML
如要建立新服務,請略過這個步驟。如要更新現有服務,請下載其 YAML 設定:
gcloud run services describe SERVICE --format export > service.yaml
將
ports更新為名稱h2c,並將containerPort更新為您選擇的通訊埠,如以下範例所示:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: template: metadata: name: REVISION spec: containers: - image: IMAGE_URL ports: - name: h2c containerPort: 8080
更改下列內容:
- SERVICE:Cloud Run 服務名稱
- IMAGE_URL:參照支援 HTTP/2 要求的自訂容器映像檔
REVISION:新的修訂版本名稱,或刪除該名稱 (如有)。如果您提供新的修訂版本名稱,則必須符合下列條件:- 開頭為「
SERVICE-」 - 只能使用小寫英文字母、數字和
- - 結尾不是
- - 不超過 63 個字元
- 開頭為「
使用下列指令建立或更新服務:
gcloud run services replace service.yaml
gcloud run services replace指令預設會使用service.yaml檔案 (如有)。
Terraform
如要瞭解如何套用或移除 Terraform 設定,請參閱「基本 Terraform 指令」。
在 Terraform 設定中,將下列內容新增至google_cloud_run_v2_service 資源: resource "google_cloud_run_v2_service" "default" {
name = "cloudrun-service-h2c"
location = "us-central1"
deletion_protection = false # set to "true" in production
template {
containers {
image = IMAGE_URL
# Enable HTTP/2
ports {
name = "h2c"
container_port = 8080
}
}
}
}
將 IMAGE_URL 替換為支援 HTTP/2 要求的自訂容器映像檔參照。
如果容器透過 8080 以外的通訊埠監聽 HTTP 要求,請將 8080 替換為該通訊埠編號。
查看 HTTP/2 設定
如要查看 Cloud Run 服務目前的 HTTP/2 設定,請按照下列步驟操作:
控制台
在 Google Cloud 控制台中,前往 Cloud Run 的「Services」(服務) 頁面:
按一下您感興趣的服務,開啟「Service details」(服務詳細資料) 頁面。
按一下「網路」分頁標籤查看設定。
gcloud
使用下列指令:
gcloud run services describe SERVICE
在傳回的設定中找出 HTTP/2 設定。
在負載平衡器後方使用 HTTP/2
如果設定為監聽 HTTP/2,Cloud Run 會自動處理來自應用程式負載平衡器的 HTTP/2 或 gRPC 流量。負載平衡器的後端服務不需要任何特定設定。
如要將 Cloud Run 設為使用 HTTP/2 或 gRPC,請採用下列其中一種方法:
- 設定及更新 HTTP/2 端對端
- 設定外部應用程式負載平衡器,並將 Cloud Run 服務設為後端。