Indirizzo IP in uscita statico

Per impostazione predefinita, un servizio Cloud Run si connette a endpoint esterni su internet utilizzando un pool di indirizzi IP dinamici. Se il servizio Cloud Run si connette a un endpoint esterno che richiede un indirizzo IP statico, ad esempio un database o un'API, utilizzando un firewall basato su indirizzo IP, devi configurare il servizio Cloud Run in modo da inoltrare le richieste utilizzando un indirizzo IP statico.

Questa pagina descrive come consentire a un servizio Cloud Run di inviare richieste utilizzando un indirizzo IP statico.

Ti consigliamo di configurare Cloud Run per inviare traffico a una rete VPC utilizzando l'uscita VPC diretta. Tuttavia, hai la possibilità di creare un connettore.

Panoramica delle attività

Per consentire a un servizio Cloud Run di inoltrare le richieste utilizzando un indirizzo IP statico, configura il traffico in uscita VPC del servizio Cloud Run in modo che inoltri tutto il traffico in uscita tramite una rete VPC con un gateway Cloud NAT configurato con l'indirizzo IP statico.

L'indirizzamento del traffico tramite Cloud NAT non causa un ulteriore hop nello stack di rete, poiché il gateway Cloud NAT e il router Cloud forniscono solo un piano di controllo e i pacchetti non passano attraverso il gateway NAT o il router Cloud.

Configura la Network Address Translation (NAT)

Se utilizzi il traffico VPC diretto in uscita o un connettore di accesso VPC serverless, le richieste del servizio Cloud Run arrivano alla rete VPC. Se vuoi inoltrare le richieste in uscita agli endpoint esterni utilizzando un indirizzo IP statico, configura un gateway Cloud NAT.

gcloud

  1. Crea un nuovo router Cloud per programmare un gateway Cloud NAT:

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

    Sostituisci i seguenti valori in questo comando:

    • ROUTER_NAME con un nome per la risorsa Cloud Router che vuoi creare.
    • NETWORK_NAME con il nome della rete VPC che hai trovato in precedenza.
    • REGION con la regione in cui vuoi creare un gateway Cloud NAT.
  2. Prenota un indirizzo IP statico. Una risorsa indirizzo IP riservato mantiene l'indirizzo IP sottostante quando la risorsa a cui è associata viene eliminata e ricreata:

    gcloud compute addresses create ORIGIN_IP_NAME --region=REGION

    Sostituisci i seguenti valori in questo comando:

    • ORIGIN_IP_NAME con il nome da assegnare alla risorsa indirizzo IP.
    • REGION con la regione in cui verrà eseguito il router Cloud NAT. Utilizza la stessa regione del servizio Cloud Run per ridurre al minimo la latenza e i costi di rete.
  3. Crea una configurazione del gateway Cloud NAT su questo router per indirizzare il traffico proveniente dalla rete VPC utilizzando l'indirizzo IP statico che hai creato:

    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

    Sostituisci i seguenti valori in questo comando:

    • NAT_NAME con un nome per la risorsa gateway Cloud NAT che vuoi creare.
    • ROUTER_NAME con il nome del tuo router Cloud.
    • REGION con la regione in cui vuoi creare un gateway Cloud NAT.
    • SUBNET_NAME con il nome della subnet.
    • ORIGIN_IP_NAME con il nome della risorsa indirizzo IP riservato che hai creato nel passaggio precedente.

Terraform

  1. Crea un nuovo router Cloud per programmare un gateway Cloud NAT:

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

    Sostituisci cr-static-ip-router con il nome della subnet.

  2. Prenota un indirizzo IP statico. Una risorsa indirizzo IP riservato mantiene l'indirizzo IP sottostante quando la risorsa a cui è associata viene eliminata e ricreata:

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

    Sostituisci cr-static-ip-addr con il nome della subnet.

  3. Crea una configurazione del gateway Cloud NAT su questo router per indirizzare il traffico proveniente dalla rete VPC utilizzando l'indirizzo IP statico che hai creato:

    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"]
      }
    }

    Sostituisci cr-static-nat con il nome del gateway Cloud NAT.

Instrada il traffico di Cloud Run attraverso la rete VPC

Dopo aver configurato Cloud NAT, esegui il deployment o l'aggiornamento del servizio Cloud Run con il traffico VPC diretto in uscita o il connettore Accesso VPC serverless e imposta il traffico VPC in uscita in modo da instradare tutto il traffico tramite la rete VPC:

gcloud

Uscita diretta VPC

Per eseguire il deployment o l'aggiornamento del servizio Cloud Run in modo che utilizzi l'uscita VPC diretto e instrada tutto il traffico in uscita, esegui il seguente comando:

gcloud run deploy SERVICE_NAME 
--image=IMAGE_URL
--network=NETWORK
--subnet=SUBNET
--region=REGION
--vpc-egress=all-traffic

Sostituisci i seguenti valori in questo comando:

  • SERVICE_NAME con il nome del servizio Cloud Run che vuoi eseguire.
  • IMAGE_URL con un riferimento all'immagine del container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL ha la forma LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG .
  • NETWORK con il nome della rete VPC.
  • SUBNET con il nome della subnet.
  • REGION con una regione per il tuo servizio.

Connettore di accesso VPC serverless

Per eseguire il deployment o l'aggiornamento del servizio Cloud Run in modo che utilizzi un connettore di accesso VPC serverless e indirizzi tutto il traffico in uscita, esegui il seguente comando:

gcloud run deploy SERVICE_NAME 
--image=IMAGE_URL
--vpc-connector=CONNECTOR_NAME
--region=REGION
--vpc-egress=all-traffic

Sostituisci i seguenti valori in questo comando: * SERVICE_NAME con il nome del servizio Cloud Run che vuoi implementare. * IMAGE_URL con un riferimento all'immagine del contenitore, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL ha la forma LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG . * CONNECTOR_NAME con il nome del connettore di accesso VPC serverless. * REGION con una regione per il tuo servizio.

YAML

Uscita diretta VPC

  1. Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica la relativa configurazione YAML:

    gcloud run services describe SERVICE --format export > service.yaml
  2. Aggiorna se necessario.

    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

    Sostituisci:

    • SERVICE con il nome del servizio Cloud Run.
    • NETWORK con il nome della rete VPC.
    • SUBNET con il nome della subnet.
    • IMAGE_URL con l'URL dell'immagine del container del servizio.
  3. Crea o aggiorna il servizio utilizzando il seguente comando:

    gcloud run services replace service.yaml

Connettore di accesso VPC serverless

  1. Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica la relativa configurazione YAML:

    gcloud run services describe SERVICE --format export > service.yaml
  2. Aggiorna se necessario.

    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

    Sostituisci:

    • SERVICE con il nome del servizio Cloud Run.
    • CONNECTOR_NAME con il nome della rete Accesso VPC serverless.
    • IMAGE_URL con l'URL dell'immagine del container del servizio.
  3. Crea o aggiorna il servizio utilizzando il seguente comando:

    gcloud run services replace service.yaml

Terraform

Questo servizio Cloud Run utilizza un connettore VPC e instrada tutto il traffico in uscita tramite questo connettore:

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"

}

Sostituisci us-docker.pkg.dev/cloudrun/container/hello con un riferimento all'immagine del contenitore.

Verifica l'indirizzo IP esterno statico

Dopo aver completato i passaggi precedenti, hai configurato Cloud NAT sulla tua rete VPC con un indirizzo IP statico predefinito e hai inoltrato tutto il traffico in uscita del servizio Cloud Run alla tua rete VPC. Le richieste del servizio Cloud Run passano per la rete VPC e raggiungono gli endpoint esterni utilizzando l'indirizzo IP statico.

Per verificare questo comportamento e confermare l'indirizzo IP di origine utilizzato dal tuo servizio, puoi inviare una richiesta a un'API o a un sito web come curlmyip.org che mostri l'indirizzo IP di origine.

Eliminazione dell'indirizzo IP esterno statico

Se non hai più bisogno di un indirizzo IP esterno statico, consulta la sezione Rilasciare un indirizzo IP esterno statico.