靜態外寄 IP 位址

gcloud

1. 建立新的 Cloud Router，以設定 Cloud NAT 閘道：

   gcloud compute routers create ROUTER_NAME \
     --network=NETWORK_NAME \
     --region=REGION

   更改下列內容：

   • ROUTER_NAME：您要建立的 Cloud Router 資源名稱。
   • NETWORK_NAME：您先前找到的虛擬私有雲網路名稱。
   • REGION：要在其中建立 Cloud NAT 閘道的區域。

2. 保留靜態 IP 位址。如果與預留 IP 位址資源相關聯的資源遭到刪除並重新建立，該資源會保留底層 IP 位址：

   gcloud compute addresses create ORIGIN_IP_NAME --region=REGION

   更改下列內容：

   • ORIGIN_IP_NAME：您要指派給 IP 位址資源的名稱。
   • REGION：將執行 Cloud NAT 路由器的區域。請使用與 Cloud Run 服務相同的區域，盡量縮短延遲時間並降低網路費用。

3. 在這個路由器上建立 Cloud NAT 閘道設定，使用您建立的靜態 IP 位址，轉送來自虛擬私有雲網路的流量：

   gcloud compute routers nats create NAT_NAME \
     --router=ROUTER_NAME \
     --region=REGION \
     --nat-custom-subnet-ip-ranges=SUBNET_NAME \
     --nat-external-ip-pool=ORIGIN_IP_NAME

   更改下列內容：

   • NAT_NAME：要建立的 Cloud NAT 閘道資源名稱。
   • ROUTER_NAME：Cloud Router 的名稱。
   • REGION：要在其中建立 Cloud NAT 閘道的區域。
   • SUBNET_NAME：子網路名稱。
   • ORIGIN_IP_NAME：您在上一個步驟中建立的保留 IP 位址資源名稱。

Terraform

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

1. 建立新的 Cloud Router，以設定 Cloud NAT 閘道：

   resource "google_compute_router" "default" {
     name    = "cr-static-ip-router"
     network = google_compute_network.default.name
     region  = google_compute_subnetwork.default.region
   }

   將 cr-static-ip-router 替換為子網路名稱。

2. 保留靜態 IP 位址。如果與預留 IP 位址資源相關聯的資源遭到刪除並重新建立，該資源會保留底層 IP 位址：

   resource "google_compute_address" "default" {
     name   = "cr-static-ip-addr"
     region = google_compute_subnetwork.default.region
   }

   將 cr-static-ip-addr 替換為子網路名稱。

3. 在這個路由器上建立 Cloud NAT 閘道設定，使用您建立的靜態 IP 位址，轉送來自虛擬私有雲網路的流量：

   resource "google_compute_router_nat" "default" {
     name   = "cr-static-nat"
     router = google_compute_router.default.name
     region = google_compute_subnetwork.default.region
   
     nat_ip_allocate_option = "MANUAL_ONLY"
     nat_ips                = [google_compute_address.default.self_link]
   
     source_subnetwork_ip_ranges_to_nat = "LIST_OF_SUBNETWORKS"
     subnetwork {
       name                    = google_compute_subnetwork.default.id
       source_ip_ranges_to_nat = ["ALL_IP_RANGES"]
     }
   }

   將 cr-static-nat 替換為 Cloud NAT 閘道名稱。

gcloud

直接虛擬私有雲輸出

如要部署或更新 Cloud Run 服務，以使用直接虛擬私有雲輸出，並透過該服務轉送所有輸出流量，請執行下列指令：

gcloud run deploy SERVICE_NAME 

    --image=IMAGE_URL 

    --network=NETWORK 

    --subnet=SUBNET 

    --region=REGION 

    --vpc-egress=all-traffic

更改下列內容：

• SERVICE_NAME：要部署的 Cloud Run 服務名稱。
• IMAGE_URL：容器映像檔的參照，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。如果您使用 Artifact Registry，則必須先建立存放區 REPO_NAME。網址格式為 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG 。
• NETWORK：虛擬私有雲網路的名稱。
• SUBNET：子網路名稱。
• REGION：服務的區域。

無伺服器虛擬私有雲存取連接器

如要部署或更新 Cloud Run 服務，以便使用無伺服器虛擬私有雲存取連接器，並透過該連接器路由所有輸出流量，請執行下列指令：

gcloud run deploy SERVICE_NAME 

    --image=IMAGE_URL 

    --vpc-connector=CONNECTOR_NAME 

    --region=REGION 

    --vpc-egress=all-traffic

更改下列內容：

• SERVICE_NAME：要部署的 Cloud Run 服務名稱。
• IMAGE_URL：容器映像檔的參照，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。如果您使用 Artifact Registry，則必須先建立存放區 REPO_NAME。網址格式為 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG 。
• CONNECTOR_NAME：無伺服器虛擬私有雲存取連接器的名稱。
• REGION：服務的區域。

YAML

直接虛擬私有雲輸出

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

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

2. 視需要更新。

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       metadata:
         annotations:
           run.googleapis.com/network-interfaces: '[{"network":"NETWORK","subnetwork":"SUBNET"}]'
           run.googleapis.com/vpc-access-egress: all-traffic
       spec:
         containers:
         - image: IMAGE_URL

   更改下列內容：

   • SERVICE：Cloud Run 服務的名稱。
   • NETWORK：虛擬私有雲網路的名稱。
   • SUBNET：子網路名稱。
   • IMAGE_URL：服務容器映像檔的網址。

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

   gcloud run services replace service.yaml

無伺服器虛擬私有雲存取連接器

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

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

2. 視需要更新。

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       metadata:
         annotations:
           run.googleapis.com/vpc-access-connector: CONNECTOR_NAME
       spec:
         containers:
         - image: IMAGE_URL

   更改下列內容：

   • SERVICE：Cloud Run 服務的名稱。
   • ：無伺服器虛擬私有雲存取網路的名稱。CONNECTOR_NAME
   • IMAGE_URL：容器映像檔的參照，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。如果您使用 Artifact Registry，則必須先建立存放區 REPO_NAME。網址格式為 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG 。

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

   gcloud run services replace service.yaml

Terraform

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

這項 Cloud Run 服務使用虛擬私有雲連接器，並透過該連接器轉送所有輸出流量：

resource "google_cloud_run_v2_service" "default" {
  name     = "cr-static-ip-service"
  location = google_compute_subnetwork.default.region

  deletion_protection = false # set to "true" in production

  template {
    containers {
      # Replace with the URL of your container
      #   gcr.io/<YOUR_GCP_PROJECT_ID>/<YOUR_CONTAINER_NAME>
      image = "us-docker.pkg.dev/cloudrun/container/hello"
    }
    scaling {
      max_instance_count = 5
    }
    vpc_access {
      connector = google_vpc_access_connector.default.id
      egress    = "ALL_TRAFFIC"
    }
  }
  ingress = "INGRESS_TRAFFIC_ALL"

}

將 us-docker.pkg.dev/cloudrun/container/hello 替換為容器映像檔的參照。