Uscita VPC diretta con una rete VPC condiviso

Console

1. Nella console Google Cloud , vai alla pagina Cloud Run:

   Vai a Cloud Run

2. Seleziona Servizi dal menu e fai clic su Esegui il deployment del contenitore per configurare un nuovo servizio. Se stai configurando ed eseguendo il deployment di un servizio esistente, fai clic sul servizio, quindi su Modifica ed esegui il deployment della nuova revisione.

3. Se stai configurando un nuovo servizio, compila la pagina iniziale delle impostazioni del servizio in base alle tue esigenze, quindi fai clic su Container, volumi, networking, sicurezza per espandere la pagina di configurazione del servizio.

4. Fai clic sulla scheda Networking.

5. Fai clic su Connettiti a un VPC per il traffico in uscita.

6. Fai clic su Invia il traffico direttamente a un VPC.

7. Seleziona Reti condivise con me.

8. Nel campo Rete, seleziona la rete VPC condiviso a cui vuoi inviare il traffico.

9. Nel campo Subnet, seleziona la subnet da cui il servizio riceve gli indirizzi IP.

10. (Facoltativo) Inserisci i nomi dei tag di rete che vuoi associare al tuo servizio o ai tuoi servizi. I tag di rete vengono specificati a livello di revisione. Ogni revisione del servizio può avere tag di rete diversi, ad esempio network-tag-2.

11. Per Routing del traffico, seleziona una delle seguenti opzioni:

    • Instrada solo le richieste a IP privati al VPC per inviare solo traffico agli indirizzi interni tramite la rete VPC condiviso.
    • Instrada al VPC tutto il traffico per inviare tutto il traffico in uscita tramite la reteVPC condivisoa.

12. Fai clic su Crea o Esegui il deployment.

13. Per verificare che il servizio si trovi nella rete VPC condiviso, fai clic sul servizio, quindi sulla scheda Networking. La rete e la subnet sono elencate nella scheda VPC.

Ora puoi inviare richieste dal tuo servizio Cloud Run a qualsiasi risorsa sulla rete VPC condiviso, come consentito dalle regole firewall.

gcloud

Per inserire il servizio nella subnet condivisa, specifica i nomi delle risorse completi per la reteVPC condivisoa e la subnet eseguendo il comando seguente:

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
  

Sostituisci quanto segue:

• SERVICE_NAME: il nome del tuo servizio Cloud Run.
• IMAGE_URL: l'URL dell'immagine del servizio.
• HOST_PROJECT_ID: l'ID del tuo progetto VPC condiviso.
• VPC_NETWORK: il nome della risorsa completo della tua rete VPC condiviso.
• REGION: la regione del servizio Cloud Run, che deve corrispondere alla regione della subnet.
• SUBNET_NAME: il nome della risorsa completo della tua subnet.
• (Facoltativo) NETWORK_TAG_NAMES con i nomi separati da virgole dei tag di rete che vuoi associare a un servizio. Per i servizi, i tag di rete vengono specificati a livello di revisione. Ogni revisione del servizio può avere tag di rete diversi, ad esempio network-tag-2.
• EGRESS_SETTING con un valore di impostazione di uscita:
  • all-traffic: invia tutto il traffico in uscita tramite la rete VPC condiviso.
  • private-ranges-only: invia il traffico solo agli indirizzi interni tramite la rete VPC condiviso.
• MAX: il numero massimo di istanze da utilizzare per la rete VPC condiviso. Il numero massimo di istanze consentite per i servizi è 100.

Per maggiori dettagli e argomenti facoltativi, consulta le informazioni di riferimento su gcloud.

YAML

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 i seguenti attributi:

   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

   Sostituisci:

   • SERVICE_NAME con il nome del tuo servizio Cloud Run. I nomi dei servizi devono contenere al massimo 49 caratteri e devono essere univoci per regione e progetto.
   • REGION con la regione del tuo servizio Cloud Run, che deve corrispondere alla regione della tua subnet.
   • NETWORK con il nome risorsa completo della tua reteVPC condivisoa.
   • SUBNET_NAME con il nome risorsa completo della tua subnet.
   • (Facoltativo) NETWORK_TAG_NAMES con i nomi dei tag di rete che vuoi associare a un servizio. Per i servizi, i tag di rete vengono specificati a livello di revisione. Ogni revisione del servizio può avere tag di rete diversi, ad esempio network-tag-2.
   • EGRESS_SETTING con un valore di impostazione di uscita:
     • all-traffic: invia tutto il traffico in uscita tramite la rete VPC condiviso.
     • private-ranges-only: invia il traffico solo agli indirizzi interni tramite la rete VPC condiviso.
   • IMAGE con l'URL dell'immagine container del servizio.

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

1. Aggiungi quanto segue al tuo file 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"]
         }
       }
     }
   }
   

Console

1. Nella console Google Cloud , vai alla pagina Cloud Run:

   Vai a Cloud Run

2. Se stai configurando un nuovo job, fai clic su Deploy container e seleziona Job per compilare il modulo iniziale Crea job in base alle esigenze. Se stai configurando un job esistente, fai clic sulla scheda Job, seleziona un job, quindi fai clic su Modifica.

3. Fai clic su Container, variabili e secret, connessioni, sicurezza per espandere la pagina delle proprietà del job.

4. Fai clic sulla scheda Connessioni.

5. Fai clic su Connettiti a un VPC per il traffico in uscita.

6. Fai clic su Invia il traffico direttamente a un VPC.

7. Seleziona Reti condivise con me.

8. Nel campo Rete, seleziona la rete VPC condiviso a cui vuoi inviare il traffico.

9. Nel campo Subnet, seleziona la subnet da cui il job riceve gli indirizzi IP.

10. (Facoltativo) Inserisci i nomi dei tag di rete che vuoi associare a un job. Per i job, i tag di rete vengono specificati a livello di esecuzione. Ogni esecuzione del job può avere tag di rete diversi, ad esempio network-tag-2.

11. Per Routing del traffico, seleziona una delle seguenti opzioni:

    • Instrada solo le richieste a IP privati al VPC per inviare solo traffico agli indirizzi interni tramite la rete VPC condiviso.
    • Instrada al VPC tutto il traffico per inviare tutto il traffico in uscita tramite la reteVPC condivisoa.

12. Fai clic su Crea o Aggiorna.

13. Per verificare che il job si trovi nella rete VPC condiviso, fai clic sul job e poi sulla scheda Configurazione. La rete e la subnet sono elencate nella scheda VPC.

Ora puoi eseguire il tuo job Cloud Run e inviare richieste dal job a qualsiasi risorsa sulla rete VPC condiviso, come consentito dalle regole firewall.

gcloud

Per inserire il job nella subnet condivisa, specifica i nomi delle risorse completi per la reteVPC condivisoa e la subnet eseguendo il seguente comando:

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 \
  

Sostituisci quanto segue:

• JOB_NAME: il nome del job Cloud Run.
• IMAGE_URL: l'URL dell'immagine del lavoro.
• HOST_PROJECT_ID: l'ID del progetto host VPC condiviso.
• VPC_NETWORK: il nome della risorsa completo della tua rete VPC condiviso.
• REGION: la regione del job Cloud Run, che deve corrispondere alla regione della subnet.
• SUBNET_NAME: il nome della risorsa completo della tua subnet.
• (Facoltativo) NETWORK_TAG_NAMES con i nomi separati da virgole dei tag di rete che vuoi associare a un job. Ogni esecuzione del job può avere tag di rete diversi, ad esempio network-tag-2.
• EGRESS_SETTING con un valore di impostazione di uscita:
  • all-traffic: invia tutto il traffico in uscita tramite la rete VPC condiviso.
  • private-ranges-only: invia il traffico solo agli indirizzi interni tramite la rete VPC condiviso.

Per maggiori dettagli e argomenti facoltativi, consulta le informazioni di riferimento su gcloud.

YAML

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

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

2. Aggiorna i seguenti attributi:

   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

   Sostituisci:

   • JOB_NAME con il nome del tuo job Cloud Run. I nomi dei job devono contenere al massimo 49 caratteri e devono essere univoci per regione e progetto.
   • REGION con la regione del tuo job Cloud Run, che deve corrispondere alla regione della tua subnet.
   • NETWORK con il nome risorsa completo della tua reteVPC condivisoa.
   • SUBNET con il nome risorsa completo della tua subnet.
   • (Facoltativo) NETWORK_TAG_NAMES con i nomi dei tag di rete che vuoi associare a un job. Per i job, i tag di rete vengono specificati a livello di esecuzione. Ogni esecuzione del job può avere tag di rete diversi, ad esempio network-tag-2.
   • EGRESS_SETTING con un valore di impostazione di uscita:
     • all-traffic: invia tutto il traffico in uscita tramite la rete VPC condiviso.
     • private-ranges-only: invia il traffico solo agli indirizzi interni tramite la rete VPC condiviso.
   • IMAGE con l'URL dell'immagine container del job.

3. Crea o aggiorna il job utilizzando il seguente comando:

   gcloud run jobs replace job.yaml

Console

• Per rimuovere il servizio dalla rete VPC condiviso:

  1. Nella console Google Cloud , vai alla pagina Cloud Run:

     Vai a Cloud Run

  2. Fai clic sul servizio che vuoi rimuovere, poi su Modifica ed esegui il deployment di una nuova revisione.

  3. Fai clic sulla scheda Networking.

  4. Deseleziona Connettiti a un VPC per il traffico in uscita.

  5. Fai clic su Esegui il deployment.

  6. Per verificare che il servizio non si trovi più nella rete VPC condiviso, fai clic sulla scheda Networking. La rete e la subnet non sono più elencate nella scheda VPC.

• Per rimuovere solo i tag di rete mantenendo il servizio connesso alla rete VPC condiviso:

  1. Fai clic sul servizio che contiene i tag di rete da rimuovere, poi fai clic su Modifica e implementa nuova revisione.

  2. Fai clic sulla scheda Networking.

  3. Cancella i nomi dei tag di rete che non vuoi più associare al tuo servizio.

  4. Fai clic su Esegui il deployment.

gcloud

• Per rimuovere il servizio dalla rete VPC condiviso, esegui questo comando:

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

• Per rimuovere solo i tag di rete mantenendo il servizio connesso alla rete VPC condiviso, esegui questo comando:

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

  Sostituisci quanto segue:

  • SERVICE_NAME: il nome del tuo servizio Cloud Run.
  • REGION: la regione del tuo servizio Cloud Run.

YAML

• Per rimuovere il servizio dalla rete VPC condiviso:

  1. Scarica la configurazione YAML del servizio:

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

  2. Rimuovi i seguenti contenuti dal file service.yaml:

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

     Dove

     • NETWORK: il nome della risorsa completo della tua rete VPC condiviso.
     • SUBNET: il nome della risorsa completo della tua subnet.
     • (Facoltativo) NETWORK_TAG_NAMES: i nomi dei tag di rete se li hai associati a un servizio.

  3. Aggiorna il servizio utilizzando il seguente comando:

     gcloud run services replace service.yaml

• Per rimuovere solo i tag di rete mantenendo il servizio connesso alla rete VPC condiviso:

  1. Scarica la configurazione YAML del servizio:

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

  2. Rimuovi la variabile tags dai contenuti del file service.yaml, lasciando le variabili network e subnetwork, come mostrato nell'esempio seguente:

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

     Sostituisci quanto segue:

     • NETWORK: il nome della risorsa completo della tua rete VPC condiviso.
     • SUBNET: il nome della risorsa completo della tua subnet.

  3. Aggiorna il servizio utilizzando il seguente comando:

     gcloud run services replace service.yaml

Console

• Per rimuovere il tuo progetto dalla rete VPC condiviso:

  1. Nella console Google Cloud , vai alla pagina Cloud Run:

     Vai a Cloud Run

  2. Fai clic sul job che vuoi rimuovere, poi su Modifica ed esegui il deployment di una nuova revisione.

  3. Fai clic sulla scheda Configuration (Configurazione).

  4. Deseleziona Connettiti a un VPC per il traffico in uscita.

  5. Fai clic su Aggiorna.

  6. Per verificare che il job non si trovi più nella rete VPC condiviso, fai clic sulla scheda Configurazione. La rete e la subnet non sono più elencate nella scheda VPC.

• Per rimuovere solo i tag di rete mantenendo il job connesso alla rete VPC condiviso:

  1. Fai clic sul job contenente i tag di rete da rimuovere, poi fai clic su Modifica e implementa nuova revisione.

  2. Fai clic sulla scheda Connessioni.

  3. Cancella i nomi dei tag di rete che non vuoi più associare al tuo job.

  4. Fai clic su Aggiorna.

gcloud

• Per rimuovere il job dalla rete VPC condiviso, esegui questo comando:

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

• Per rimuovere solo i tag di rete mantenendo il job connesso alla rete VPC condiviso, esegui questo comando:

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

  Sostituisci quanto segue:

  • JOB_NAME: il nome del job Cloud Run.
  • REGION: la regione per il tuo job Cloud Run.

YAML

• Per rimuovere il tuo progetto dalla rete VPC condiviso:

  1. Scarica la configurazione YAML del job:

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

  2. Rimuovi i seguenti contenuti dal file job.yaml:

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

     Dove

     • NETWORK: il nome della risorsa completo della tua rete VPC condiviso.
     • SUBNET: il nome della risorsa completo della tua subnet.
     • (Facoltativo) NETWORK_TAG_NAMES: i nomi dei tag di rete se li avevi associati a un lavoro.

  3. Aggiorna il job utilizzando il seguente comando:

     gcloud run jobs replace job.yaml

• Per rimuovere solo i tag di rete mantenendo il job connesso alla rete VPC condiviso:

  1. Scarica la configurazione YAML del job:

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

  2. Rimuovi i seguenti contenuti dal file job.yaml:

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

     Dove

     • NETWORK: il nome della risorsa completo della tua rete VPC condiviso.
     • SUBNET: il nome della risorsa completo della tua subnet.
     • (Facoltativo) NETWORK_TAG_NAMES: i nomi dei tag di rete se li avevi associati a un lavoro.

  3. Aggiorna il job utilizzando il seguente comando:

     gcloud run jobs replace job.yaml