使用共用虛擬私有雲網路的直接虛擬私有雲輸出

控制台

1. 前往 Google Cloud 控制台的「Cloud Run」頁面：

   前往 Cloud Run

2. 從選單中選取「Services」，然後按一下「Deploy container」，設定新服務。如果您要設定及部署現有服務，請按一下該服務，然後點選「編輯並部署新修訂版本」。

3. 如果您要設定新的服務，請視需要填寫初始服務設定頁面，然後按一下「容器、磁碟區、網路與安全性」，展開服務設定頁面。

4. 按一下 [網路] 分頁標籤。

5. 按一下「連線至虛擬私有雲，以傳出流量」。

6. 按一下「直接將流量傳送至虛擬私有雲」。

7. 選取「與我共用的網路」。

8. 在「Network」(網路) 欄位中，選取要傳送流量的 Shared VPC 網路。

9. 在「Subnet」(子網路)欄位中，選取服務接收 IP 位址的子網路。

10. 選用：輸入要與服務相關聯的網路標記名稱。網路標記是在修訂版本層級指定。每個服務修訂版本都可以有不同的網路標記，例如 network-tag-2。

11. 在「Traffic routing」(流量路由) 部分，選取下列其中一個選項：

    • 僅將要求轉送至虛擬私有雲的私人 IP，這樣就只會透過共用虛擬私有雲網路將流量傳送至內部位址。
    • 將所有流量轉送至虛擬私有雲，透過共用虛擬私有雲網路傳送所有傳出流量。

12. 按一下 [Create] (建立) 或 [Deploy] (部署)。

13. 如要確認服務是否位於共用虛擬私有雲網路中，請依序點選服務和「Networking」分頁標籤。網路和子網路會列在「VPC」VPC資訊卡中。

您現在可以根據防火牆規則，從 Cloud Run 服務傳送要求至共用虛擬私有雲網路上的任何資源。

gcloud

如要將服務置於共用子網路，請執行下列指令，為共用 VPC 網路和子網路指定完整的資源名稱：

gcloud run deploy SERVICE_NAME \
  --image IMAGE_URL \
  --network projects/HOST_PROJECT_ID/global/networks/VPC_NETWORK \
  --subnet projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME \
  --network-tags NETWORK_TAG_NAMES \
  --vpc-egress=EGRESS_SETTING \
  --region REGION \
  --max-instances MAX
  

更改下列內容：

• SERVICE_NAME：Cloud Run 服務名稱。
• IMAGE_URL：服務的圖片網址。
• HOST_PROJECT_ID：共用虛擬私有雲專案的 ID。
• VPC_NETWORK：共用虛擬私有雲網路的完整資源名稱。
• REGION：Cloud Run 服務的區域，必須與子網路的區域相符。
• SUBNET_NAME：子網路的完整資源名稱。
• 選用：NETWORK_TAG_NAMES 與您要與服務建立關聯的網路標記名稱 (以半形逗號分隔)。對於服務，網路標記是在修訂版本層級指定。每個服務修訂版本都可以有不同的網路標記，例如 network-tag-2。
• EGRESS_SETTING 搭配egress 設定值：
  • all-traffic：透過共用虛擬私有雲網路傳送所有出站流量。
  • private-ranges-only：只透過共用虛擬私有雲網路將流量傳送至內部位址。
• MAX：共用虛擬私有雲網路可使用的執行個體數量上限。服務允許的執行個體數量上限為 100 個。

如需更多詳細資料和選用引數，請參閱 gcloud 參考資料。

YAML

1. 如果您要建立新服務，請略過這個步驟。如果您要更新現有服務，請下載其 YAML 設定：

   gcloud run services describe SERVICE --format export > service.yaml

2. 更新下列屬性：

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE_NAME
     labels:
       cloud.googleapis.com/location: REGION
   spec:
     template:
       metadata:
         annotations:
           run.googleapis.com/network-interfaces: '[{"network":"NETWORK","subnetwork":"SUBNET","tags":"NETWORK_TAG_NAMES"}]'
           run.googleapis.com/vpc-access-egress: EGRESS_SETTING
       spec:
         containers:
         - image: IMAGE

   取代：

   • SERVICE_NAME 改為 Cloud Run 服務名稱。服務名稱長度不得超過 49 個字元，且每個區域和專案的服務名稱都必須是獨一無二的。
   • REGION 與 Cloud Run 服務的地區，必須與子網路的地區相符。
   • 將 NETWORK 替換為共用虛擬私人雲端網路的完整資源名稱。
   • SUBNET_NAME 與子網路的完整資源名稱。
   • 選用：NETWORK_TAG_NAMES 與您要與服務建立關聯的網路標記名稱。對於服務，網路標記是在修訂版本層級指定。每個服務修訂版本都可以有不同的網路標記，例如 network-tag-2。
   • EGRESS_SETTING 搭配egress 設定值：
     • all-traffic：透過共用虛擬私有雲網路傳送所有出站流量。
     • private-ranges-only：只透過共用虛擬私有雲網路將流量傳送至內部位址。
   • IMAGE 與服務容器映像檔的網址。

3. 使用下列指令建立或更新服務：

   gcloud run services replace service.yaml

Terraform

如要瞭解如何套用或移除 Terraform 設定，請參閱「基本 Terraform 指令」。

1. 請將以下內容新增到您的 main.tf 檔案中：

   /**
    * Copyright 2024 Google LLC
    *
    * Licensed under the Apache License, Version 2.0 (the "License");
    * you may not use this file except in compliance with the License.
    * You may obtain a copy of the License at
    *
    *      http://www.apache.org/licenses/LICENSE-2.0
    *
    * Unless required by applicable law or agreed to in writing, software
    * distributed under the License is distributed on an "AS IS" BASIS,
    * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    * See the License for the specific language governing permissions and
    * limitations under the License.
    */
   
   # Example configuration of a Cloud Run service with direct VPC
   
   resource "google_cloud_run_v2_service" "default" {
     name     = "cloudrun-service"
     location = "us-central1"
   
     deletion_protection = false # set to "true" in production
   
     template {
       containers {
         image = "us-docker.pkg.dev/cloudrun/container/hello"
       }
       vpc_access {
         network_interfaces {
           network    = "default"
           subnetwork = "default"
           tags       = ["tag1", "tag2", "tag3"]
         }
       }
     }
   }
   

控制台

1. 前往 Google Cloud 控制台的「Cloud Run」頁面：

   前往 Cloud Run

2. 如果您要設定新工作，請按一下「部署容器」，然後選取「工作」，視需要填寫初始的「建立工作」表單。如果您要設定現有的工作，請按一下「工作」分頁標籤，選取工作，然後按一下「編輯」。

3. 按一下「容器、變數和密鑰、連線、安全性」，展開工作屬性頁面。

4. 按一下「連線設定」分頁標籤。

5. 按一下「連線至虛擬私有雲，以傳出流量」。

6. 按一下「直接將流量傳送至虛擬私有雲」。

7. 選取「與我共用的網路」。

8. 在「Network」(網路) 欄位中，選取要傳送流量的 Shared VPC 網路。

9. 在「Subnet」(子網路) 欄位中，選取工作接收 IP 位址的子網路。

10. 選用：輸入要與工作建立關聯的網路代碼名稱。針對工作，網路標記是在執行層級指定。每個工作執行作業都可以有不同的網路標記，例如 network-tag-2。

11. 在「Traffic routing」(流量路由) 部分，選取下列其中一個選項：

    • 僅將要求轉送至虛擬私有雲的私人 IP，這樣就只會透過共用虛擬私有雲網路將流量傳送至內部位址。
    • 將所有流量轉送至虛擬私有雲，透過共用虛擬私有雲網路傳送所有傳出流量。

12. 按一下「建立」或「更新」。

13. 如要確認工作位於共用虛擬私有雲網路，請按一下工作，然後按一下「Configuration」分頁標籤。網路和子網路會列在 VPC 資訊卡中。

您現在可以執行 Cloud Run 工作，並根據防火牆規則，將工作中的要求傳送至共用虛擬私有雲網路中的任何資源。

gcloud

如要將工作置於共用子網路，請執行下列指令，為共用虛擬私有雲網路和子網路指定完整資源名稱：

gcloud run jobs create JOB_NAME \
  --image IMAGE_URL \
  --network projects/HOST_PROJECT_ID/global/networks/VPC_NETWORK \
  --subnet projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME \
  --network-tags NETWORK_TAG_NAMES \
  --vpc-egress=EGRESS_SETTING \
  --region REGION \
  

更改下列內容：

• JOB_NAME：Cloud Run 工作名稱。
• IMAGE_URL：工作圖片的網址。
• HOST_PROJECT_ID：共用虛擬私有雲主專案的 ID。
• VPC_NETWORK：共用虛擬私有雲網路的完整資源名稱。
• REGION：Cloud Run 作業的區域，必須與子網路的區域相符。
• SUBNET_NAME：子網路名稱的完整資源名稱。
• 選用：NETWORK_TAG_NAMES 使用半形逗號分隔的名稱，代表要與工作相關聯的網路標記。每個工作執行作業都可以有不同的網路標記，例如 network-tag-2。
• EGRESS_SETTING 搭配egress 設定值：
  • all-traffic：透過共用虛擬私有雲網路傳送所有出站流量。
  • private-ranges-only：只透過共用虛擬私有雲網路將流量傳送至內部位址。

如需更多詳細資料和選用引數，請參閱 gcloud 參考資料。

YAML

1. 如果您要建立新工作，請略過這個步驟。如果您要更新現有工作，請下載其 YAML 設定：

   gcloud run jobs describe JOB_NAME --format export > job.yaml

2. 更新下列屬性：

   apiVersion: run.googleapis.com/v1
   kind: Job
   metadata:
     name: JOB_NAME
     annotations:
       run.googleapis.com/launch-stage: BETA
     labels:
       cloud.googleapis.com/location: REGION
   spec:
     template:
       metadata:
         annotations:
           run.googleapis.com/network-interfaces: '[{"network":"NETWORK","subnetwork":"SUBNET","tags":"NETWORK_TAG_NAMES"}]'
           run.googleapis.com/vpc-access-egress: EGRESS_SETTING
       spec:
         containers:
         - image: IMAGE

   取代：

   • JOB_NAME 替換為 Cloud Run 作業的名稱。工作名稱長度不得超過 49 個半形字元，且每個區域和專案的名稱都必須不重複。
   • REGION 與 Cloud Run 工作所在的區域，該區域必須與子網路的區域相符。
   • 將 NETWORK 替換為共用虛擬私人雲端網路的完整資源名稱。
   • SUBNET 替換為子網路的完整資源名稱。
   • 選用：NETWORK_TAG_NAMES 可用來指定要與工作相關聯的網路標記名稱。針對工作，網路標記是在執行層級指定。每個工作執行作業都可以有不同的網路標記，例如 network-tag-2。
   • EGRESS_SETTING 搭配egress 設定值：
     • all-traffic：透過共用虛擬私有雲網路傳送所有出站流量。
     • private-ranges-only：只透過共用虛擬私有雲網路將流量傳送至內部位址。
   • IMAGE 與工作容器映像檔的網址。

3. 使用下列指令建立或更新工作：

   gcloud run jobs replace job.yaml

控制台

• 如要將服務從共用虛擬私有雲網路中移除，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「Cloud Run」頁面：

     前往 Cloud Run

  2. 按一下要移除的服務，然後點選「編輯及部署新的修訂版本」。

  3. 按一下 [網路] 分頁標籤。

  4. 清除「連線至虛擬私有雲，以傳出流量」。

  5. 按一下 [Deploy] (部署)。

  6. 如要確認服務已不再位於共用虛擬私有雲網路，請按一下「網路」分頁。網路和子網路不再列在 VPC 資訊卡中。

• 如要只移除網路標記，同時讓服務連線至共用 VPC 網路，請按照下列步驟操作：

  1. 按一下含有要移除的網路標記的服務，然後點選「編輯並部署新修訂版本」。

  2. 按一下 [網路] 分頁標籤。

  3. 清除不再想與服務建立關聯的網路標記名稱。

  4. 按一下 [Deploy] (部署)。

gcloud

• 如要從共用虛擬私有雲網路中移除服務，請執行下列指令：

  gcloud run services update SERVICE_NAME --region=REGION \
  --clear-network

• 如要只移除網路標記，同時讓服務連線至共用虛擬私有雲網路，請執行下列指令：

  gcloud run services update SERVICE_NAME --region=REGION \
  --clear-network-tags

  更改下列內容：

  • SERVICE_NAME：Cloud Run 服務名稱。
  • REGION：Cloud Run 服務的區域。

YAML

• 如要將服務從共用虛擬私有雲網路中移除，請按照下列步驟操作：

  1. 下載服務的 YAML 設定：

     gcloud run services describe SERVICE_NAME --format export > service.yaml

  2. 請從 service.yaml 檔案中移除下列內容：

     run.googleapis.com/network-interfaces: '[{"network":"NETWORK","subnetwork":"SUBNET","tags":"NETWORK_TAG_NAMES"}]'

     地點

     • NETWORK：共用虛擬私有雲網路的完整資源名稱。
     • SUBNET：子網路的完整資源名稱。
     • 選用：NETWORK_TAG_NAMES：如果您已將網路標記與服務建立關聯，則為網路標記的名稱。

  3. 使用下列指令更新服務：

     gcloud run services replace service.yaml

• 如要只移除網路標記，同時讓服務連線至共用 VPC 網路，請按照下列步驟操作：

  1. 下載服務的 YAML 設定：

     gcloud run services describe SERVICE_NAME --format export > service.yaml

  2. 從 service.yaml 檔案的內容中移除 tags 變數，保留 network 和 subnetwork 變數，如以下範例所示：

     run.googleapis.com/network-interfaces: '[{"network":"NETWORK","subnetwork":"SUBNET"}]'

     更改下列內容：

     • NETWORK：共用虛擬私有雲網路的完整資源名稱。
     • SUBNET：子網路的完整資源名稱。

  3. 使用下列指令更新服務：

     gcloud run services replace service.yaml

控制台

• 如要將工作移出共用虛擬私有雲網路，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「Cloud Run」頁面：

     前往 Cloud Run

  2. 按一下要移除的工作，然後點選「編輯及部署新的修訂版本」。

  3. 按一下 [設定] 標籤。

  4. 清除「連線至虛擬私有雲，以傳出流量」。

  5. 按一下「更新」。

  6. 如要確認工作已不再位於共用 VPC 網路，請按一下「Configuration」分頁。網路和子網路不再列在 VPC 資訊卡中。

• 如要只移除網路標記，同時讓工作連線至共用 VPC 網路，請按照下列步驟操作：

  1. 按一下含有要移除的網路標記的工作，然後按一下「編輯並部署新修訂版本」。

  2. 按一下「連線設定」分頁標籤。

  3. 清除不再想與工作建立關聯的網路標記名稱。

  4. 按一下「更新」。

gcloud

• 如要將工作從共用虛擬私有雲網路中移除，請執行下列指令：

  gcloud run jobs update JOB_NAME --region=REGION \
    --clear-network
    

• 如要只移除網路標記，同時讓工作與共用 VPC 網路保持連線，請執行下列指令：

  gcloud run jobs update JOB_NAME --region=REGION \
    --clear-network-tags
    

  更改下列內容：

  • JOB_NAME：Cloud Run 工作名稱。
  • REGION：Cloud Run 工作的區域。

YAML

• 如要將工作移出共用虛擬私有雲網路，請按照下列步驟操作：

  1. 下載工作YAML 設定：

     gcloud run jobs describe JOB_NAME --format export > job.yaml

  2. 請從 job.yaml 檔案中移除下列內容：

     run.googleapis.com/network-interfaces: '[{"network":"NETWORK","subnetwork":"SUBNET","tags":"NETWORK_TAG_NAMES"}]'

     地點

     • NETWORK：共用虛擬私有雲網路的完整資源名稱。
     • SUBNET：子網路的完整資源名稱。
     • 選用：NETWORK_TAG_NAMES：如果您已將網路標記與工作建立關聯，則為網路標記的名稱。

  3. 使用下列指令更新工作：

     gcloud run jobs replace job.yaml

• 如要只移除網路標記，同時讓工作連線至共用 VPC 網路，請按照下列步驟操作：

  1. 下載工作YAML 設定：

     gcloud run jobs describe JOB_NAME --format export > job.yaml

  2. 請從 job.yaml 檔案中移除下列內容：

     run.googleapis.com/network-interfaces: '[{"network":"NETWORK","subnetwork":"SUBNET","tags":"NETWORK_TAG_NAMES"}]'

     地點

     • NETWORK：共用虛擬私有雲網路的完整資源名稱。
     • SUBNET：子網路的完整資源名稱。
     • 選用：NETWORK_TAG_NAMES：如果您已將網路標記與工作建立關聯，則為網路標記的名稱。

  3. 使用下列指令更新工作：

     gcloud run jobs replace job.yaml