靜態外寄 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 位址資源會保留基礎 IP 位址：

   gcloud compute addresses create ORIGIN_IP_NAME --region=REGION

   請在這個指令中替換下列值：

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

3. 請在這個路由器上建立 Cloud NAT 閘道設定，以便使用您建立的靜態 IP 位址，將來自 VPC 網路的流量轉送：

   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 位址資源會保留基礎 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 位址，將來自 VPC 網路的流量轉送：

   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 與服務容器映像檔的網址。

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 替換為容器映像檔的參照。