Questa pagina è stata tradotta dall'API Cloud Translation.

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 che utilizza un firewall basato su indirizzi IP, devi configurare il servizio Cloud Run per instradare le richieste utilizzando un indirizzo IP statico.

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

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

Panoramica dell'attività

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

In questo tutorial configurerai Cloud NAT in modalità manuale e gli assegnerai un singolo indirizzo IP statico. Se i tuoi carichi di lavoro Cloud Run vengono scalati fino a numeri elevati, potresti dover assegnare più indirizzi IP statici a Cloud NAT. Scopri di più su come i gateway Cloud NAT utilizzano indirizzi IP e porte.

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

Configura la Network Address Translation (NAT)

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

gcloud

Crea un nuovo router Cloud per programmare un gateway Cloud NAT:
```
gcloud compute routers create ROUTER_NAME \
  --network=NETWORK_NAME \
  --region=REGION
```
Sostituisci quanto segue:
- ROUTER_NAME: un nome per la risorsa router Cloud che vuoi creare.
- NETWORK_NAME: il nome della rete VPC che hai trovato in precedenza.
- REGION: la regione in cui vuoi creare un gateway Cloud NAT.
Prenota un indirizzo IP statico. Una risorsa indirizzo IP riservato conserva l'indirizzo IP sottostante quando la risorsa a cui è associata viene eliminata e ricreata:
```
gcloud compute addresses create ORIGIN_IP_NAME --region=REGION
```
Sostituisci quanto segue:
- ORIGIN_IP_NAME: il nome che vuoi assegnare alla risorsa dell'indirizzo IP.
- REGION: la regione in cui verrà eseguito il router Cloud NAT. Utilizza la stessa regione del tuo servizio Cloud Run per ridurre al minimo la latenza e i costi di rete.
Crea una configurazione del gateway Cloud NAT su questo router per instradare 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 quanto segue:
- NAT_NAME: un nome per la risorsa gateway Cloud NAT che vuoi creare.
- ROUTER_NAME: il nome del tuo router Cloud.
- REGION: la regione in cui vuoi creare un gateway Cloud NAT.
- SUBNET_NAME: il nome della subnet.
- ORIGIN_IP_NAME: il nome della risorsa dell'indirizzo IP riservato che hai creato nel passaggio precedente.

Terraform

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

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 tua subnet.

Prenota un indirizzo IP statico. Una risorsa indirizzo IP riservato conserva 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 tua subnet.

Crea una configurazione del gateway Cloud NAT su questo router per instradare 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 tuo gateway Cloud NAT.

Instrada il traffico Cloud Run attraverso la rete VPC

Dopo aver configurato Cloud NAT, esegui il deployment o aggiorna il servizio Cloud Run con il traffico VPC diretto in uscita o il connettore accesso VPC serverless e imposta il traffico VPC in uscita su instrada tutto il traffico attraverso la rete VPC:

gcloud

VPC diretto in uscita

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

gcloud run deploy SERVICE_NAME 

    --image=IMAGE_URL 

    --network=NETWORK 

    --subnet=SUBNET 

    --region=REGION 

    --vpc-egress=all-traffic

Sostituisci quanto segue:

SERVICE_NAME: il nome del servizio Cloud Run che vuoi eseguire il deployment.
IMAGE_URL: un riferimento all'immagine 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 segue il formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG .
NETWORK: il nome della tua rete VPC.
SUBNET: il nome della subnet.
REGION: una regione per il 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 instradi tutto il traffico in uscita, esegui questo comando:

gcloud run deploy SERVICE_NAME 

    --image=IMAGE_URL 

    --vpc-connector=CONNECTOR_NAME 

    --region=REGION 

    --vpc-egress=all-traffic

Sostituisci quanto segue:

SERVICE_NAME: il nome del servizio Cloud Run che vuoi eseguire il deployment.
IMAGE_URL: un riferimento all'immagine 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 segue il formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG .
CONNECTOR_NAME: il nome del connettore di accesso VPC serverless.
REGION: una regione per il servizio.

YAML

VPC diretto in uscita

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
```

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 quanto segue:

SERVICE: il nome del servizio Cloud Run.
NETWORK: il nome della tua rete VPC.
SUBNET: il nome della subnet.
IMAGE_URL: l'URL dell'immagine del contenitore del servizio.

Crea o aggiorna il servizio utilizzando il seguente comando:
```
gcloud run services replace service.yaml
```

Connettore di accesso VPC serverless

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
```
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 quanto segue:
- SERVICE: il nome del servizio Cloud Run.
- CONNECTOR_NAME: il nome della tua rete di accesso VPC serverless.
- IMAGE_URL: un riferimento all'immagine 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 segue il formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG .
Crea o aggiorna il servizio utilizzando il seguente comando:
```
gcloud run services replace service.yaml
```

Terraform

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Questo servizio Cloud Run utilizza un connettore VPC e instrada tutto il traffico in uscita attraverso di esso:

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 container.

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 indirizzato tutto il traffico in uscita del tuo servizio Cloud Run nella tua rete VPC. Le richieste dal tuo servizio Cloud Run attraversano la tua 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 effettuare una richiesta a un'API o a un sito web come curlmyip.org che mostra l'indirizzo IP di origine.

Eliminazione dell'indirizzo IP esterno statico

Se non hai più bisogno di un indirizzo IP esterno statico, consulta Rilascia un indirizzo IP esterno statico.

Indirizzo IP in uscita statico Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Panoramica dell'attività

Configura la Network Address Translation (NAT)

gcloud

Terraform

Instrada il traffico Cloud Run attraverso la rete VPC

gcloud

YAML

Terraform

Verifica l'indirizzo IP esterno statico

Eliminazione dell'indirizzo IP esterno statico

Indirizzo IP in uscita statico