Configurazione dell'accesso privato ai servizi

MySQL   |  PostgreSQL   |  SQL Server

Questa pagina descrive come configurare l'accesso privato ai servizi nella tua rete VPC.

L'accesso privato ai servizi viene implementato come Connessione in peering VPC tra Rete VPC e VPC di Google Cloud sottostante in cui si trova l'istanza Cloud SQL. La connessione privata abilita le istanze VM nella tua rete VPC e i servizi a cui accedi comunicano esclusivamente tramite indirizzi IP interni. Le istanze VM non hanno bisogno Accesso a internet o indirizzi IP esterni per raggiungere i servizi disponibili mediante accesso privato ai servizi.

Prima di iniziare

Cloud SQL richiede l'accesso privato ai servizi per ogni rete VPC utilizzata per le connessioni IP private. Per gestire un di accesso privato ai servizi, l'utente deve avere quanto segue Autorizzazioni IAM:

• compute.networks.list
• compute.addresses.create
• compute.addresses.list
• servicenetworking.services.addPeering

Se non disponi di queste autorizzazioni, potresti ricevere errori relativi a autorizzazioni insufficienti.

Se utilizzi una rete VPC condivisa: devi inoltre:

• Aggiungi l'utente al progetto host.
• Assegna le stesse quattro autorizzazioni all'utente nel progetto host.
• Concedi l'autorizzazione IAM compute.globalAddresses.list all'utente.

Se utilizzi gcloud per allocare un intervallo di indirizzi IP, non devi assegnare all'utente l'autorizzazione compute.globalAddresses.list.

Configurare l'accesso privato ai servizi per Cloud SQL

Importante: quando crei una connessione privata tra il tuo VPC di rete e il servizio Cloud SQL, diventa disponibile per l'uso qualsiasi servizio Google che supporti l'accesso privato ai servizi. Se in un secondo momento elimini la connessione privata, rimuovi la connettività privata alle tue istanze Cloud SQL e a qualsiasi altro servizio che utilizza questa connessione. La rimozione della connessione privata non comporta l'eliminazione o eseguire il deprovisioning delle risorse.

La procedura di configurazione dell'accesso privato ai servizi è composta da due parti:

• Seleziona un intervallo di indirizzi IP esistente o allocane uno nuovo.

  Hai anche la possibilità di consentire a Google di allocare l'intervallo per te. In questo caso, Google allocherà automaticamente un intervallo IP con lunghezza del prefisso pari a /20 e utilizzerà il nome default-ip-range.

  Se intendi creare istanze in più regioni o per diversi tipi di database, devi disporre di un intervallo minimo di 24 indirizzi IP per ogni regione o tipo di database. Sono incluse altre applicazioni come Filestore o Memorystore. Per una nuova regione o un nuovo tipo di database, Cloud SQL deve avere un intervallo /24 libero.

• Crea una connessione privata dalla tua rete VPC alla rete del producer di servizi sottostante.

Alloca un intervallo di indirizzi IP

Console

1. Nella console Google Cloud, vai alla pagina Reti VPC.

   Vai a Reti VPC

2. Seleziona la rete VPC che vuoi utilizzare.
3. Seleziona la scheda Connessione ai servizi privati.
4. Seleziona la scheda Intervalli IP allocati per i servizi.
5. Fai clic su Assegna intervallo IP.
6. Per il campo Nome dell'intervallo allocato, specifica google-managed-services-VPC_NETWORK_NAME, dove VPC_NETWORK_NAME è il nome della rete VPC che stai connettendo (ad ad esempio google-managed-services-default). La La descrizione è facoltativa.
7. Seleziona l'opzione Personalizzato, quindi inserisci l'intervallo di indirizzi IP da allocare, in notazione CIDR.
8. Fai clic su Assegna per creare l'intervallo allocato.

gcloud

Esegui una di queste operazioni:

• Per specificare un intervallo di indirizzi e una lunghezza del prefisso (subnet mask), utilizza i flag addresses e prefix-length. Ad esempio, per allocare il blocco CIDR192.168.0.0/16, specifica 192.168.0.0 per l'indirizzo e 16 per la lunghezza del prefisso.

        gcloud compute addresses create google-managed-services-VPC_NETWORK_NAME \
        --global \
        --purpose=VPC_PEERING \
        --addresses=192.168.0.0 \
        --prefix-length=16 \
        --network=projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME
        

• Per specificare solo la lunghezza del prefisso (subnet mask), utilizza il metodo prefix-length flag. Se ometti l'intervallo di indirizzi, Google Cloud seleziona automaticamente un intervallo di indirizzi non utilizzato nel VPC in ogni rete. L'esempio seguente seleziona un intervallo di indirizzi IP inutilizzato con un Lunghezza del prefisso di 16 bit.

        gcloud compute addresses create google-managed-services-VPC_NETWORK_NAME \
        --global \
        --purpose=VPC_PEERING \
        --prefix-length=16 \
        --network=projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME
        

Sostituisci VPC_NETWORK_NAME con il nome del tuo VPC ad esempio my-vpc-network.

L'esempio seguente alloca un intervallo IP che consente alle risorse della rete VPC my-vpc-network di connettersi alle istanze Cloud SQL utilizzando l'IP privato.

    gcloud compute addresses create google-managed-services-my-vpc-network \
    --global \
    --purpose=VPC_PEERING \
    --prefix-length=16 \
    --network=projects/myprojectid/global/networks/myvpcnetwork \
    --project=my-project
    

Terraform

Per allocare un intervallo di indirizzi IP, utilizza una risorsa Terraform.

resource "google_compute_global_address" "private_ip_address" {
  name          = "private-ip-address"
  purpose       = "VPC_PEERING"
  address_type  = "INTERNAL"
  prefix_length = 16
  network       = google_compute_network.peering_network.id
}

Applica le modifiche

Per applicare la configurazione Terraform a un progetto Google Cloud, completa i passaggi nella le sezioni seguenti.

Prepara Cloud Shell

1. Avvia Cloud Shell.

2. Imposta il progetto Google Cloud predefinito in cui vuoi applicare le configurazioni Terraform.

   Devi eseguire questo comando una sola volta per progetto e puoi farlo in qualsiasi directory.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Le variabili di ambiente vengono sostituite se imposti valori espliciti nel file di configurazione di Terraform.

Prepara la directory

Ogni file di configurazione di Terraform deve avere una propria directory (chiamata anche modulo principale).

1. In Cloud Shell, crea una directory e un nuovo all'interno di quella directory. Il nome file deve avere l'estensione .tf, ad esempio main.tf. In questo tutorial, il file è denominato main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Se stai seguendo un tutorial, puoi copiare il codice di esempio in ogni sezione o passaggio.

   Copia il codice di esempio nel file main.tf appena creato.

   Se vuoi, copia il codice da GitHub. Opzione consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.

3. Esamina e modifica i parametri di esempio da applicare al tuo ambiente.
4. Salva le modifiche.
5. Inizializza Terraform. Devi eseguire questa operazione una sola volta per directory.

   terraform init

   Facoltativamente, per utilizzare la versione più recente del provider Google, includi -upgrade :

   terraform init -upgrade

Applica le modifiche

1. Rivedi la configurazione e verifica che le risorse che Terraform sta per creare o aggiornare corrispondano alle tue aspettative:

   terraform plan

   Apporta le correzioni necessarie alla configurazione.

2. Applica la configurazione di Terraform eseguendo il seguente comando e inserendo yes al prompt:

   terraform apply

   Attendi finché Terraform non visualizzi il messaggio "Applicazione completata!". per creare un nuovo messaggio email.

3. Apri il tuo progetto Google Cloud per visualizzare i risultati. Nella console Google Cloud, vai alle risorse nella UI per assicurarti create o aggiornate da Terraform.

Nota: in genere i sample di Terraform presuppongono che le API richieste siano attivate nel progetto Google Cloud.

Elimina le modifiche

Rimuovi le risorse applicate in precedenza con la tua configurazione Terraform eseguendo questo comando e inserendo yes al prompt:

terraform destroy

Crea una connessione privata

Console

1. Nella console Google Cloud, vai alla pagina Reti VPC.

   Vai alle reti VPC

2. Seleziona la rete VPC che vuoi utilizzare.
3. Seleziona la scheda Connessione privata ai servizi.
4. Seleziona la scheda Connessioni private ai servizi.
5. Fai clic su Crea connessione per creare una connessione privata tra i tuoi e un producer di servizi.
6. Per l'allocazione assegnata, seleziona uno o più intervalli allocati esistenti che non sono utilizzati da altri produttori di servizi.
7. Fai clic su Connetti per creare la connessione.

gcloud

1. Crea una connessione privata.

   gcloud services vpc-peerings connect \
   --service=servicenetworking.googleapis.com \
   --ranges=google-managed-services-VPC_NETWORK_NAME \
   --network=VPC_NETWORK_NAME \
   --project=PROJECT_ID

   Il comando avvia un'operazione a lunga esecuzione su un'istanza Cloud SQL restituendo un ID operazione.

2. Controlla se l'operazione è andata a buon fine.

   gcloud services vpc-peerings operations describe \
   --name=OPERATION_ID

Puoi specificare più di un intervallo allocato quando crei un connessione. Ad esempio, se un intervallo è esaurito, puoi assegnare aggiuntivi allocati. Il servizio utilizza gli indirizzi IP di tutti gli intervalli forniti nell'ordine da te specificato.

Terraform

Per creare una connessione privata, utilizza una risorsa Terraform.

resource "google_service_networking_connection" "default" {
  network                 = google_compute_network.peering_network.id
  service                 = "servicenetworking.googleapis.com"
  reserved_peering_ranges = [google_compute_global_address.private_ip_address.name]
}

A un account di servizio nel formato [e-mail] viene concesso il ruolo servicenetworking.serviceAgent mentre viene creata la connessione privata perché il provisioning dell'account viene eseguito just in time.

Se viene visualizzato un errore relativo all'autorizzazione compute.globalAddresses.list o l'autorizzazione compute.projects.get per il progetto, esegui questo comando gcloud:

gcloud projects add-iam-policy-binding HOST_PROJECT_NAME \
    --member=serviceAccount:[e-mail] \
    --role=roles/servicenetworking.serviceAgent

Modifica la configurazione dell'accesso privato ai servizi

Puoi modificare l'intervallo di indirizzi allocati di una connessione ai servizi privati senza modificare le istanze Cloud SQL esistenti. Per modificare l'indirizzo IP privato di un'istanza Cloud SQL esistente, segui questi passaggi.

Per modificare l'intervallo di indirizzi allocati:

Console

1. Nella console Google Cloud, vai alla pagina Reti VPC.

   Vai alle reti VPC

2. Seleziona la rete VPC che vuoi utilizzare.
3. Seleziona la scheda Connessione privata ai servizi.
4. Seleziona la scheda Intervalli IP allocati per i servizi.

5. Seleziona il nome dell'intervallo da eliminare.

   Nota: prima di eliminare l'intervallo, prendine nota del nome. Questo nome ti servirà in una parte successiva della procedura.

6. Fai clic su Rilascia.

7. Fai clic su Alloca intervallo IP.

8. Crea un nuovo intervallo con lo stesso nome e un nuovo intervallo
   

   Il nome è importante perché la connessione privata è già stata stabilita utilizzando il nome dell'indirizzo.

Nota: dopo aver modificato o rimosso un intervallo di indirizzi allocato, aggiorna i peering VPC. Usa il seguente comando e assicurati di usare il metodo --force argomento:

gcloud services vpc-peerings update \
--network=VPC_NETWORK_NAME \
--ranges=ALLOCATED_RANGES \
--service=servicenetworking.googleapis.com \
--force

Cloud SQL non elimina automaticamente la vecchia sottorete con il vecchio intervallo IP. L'intervallo è contrassegnato come inutilizzabile e non può essere utilizzato nuovamente nel progetto. In questo modo, le istanze esistenti rimangono nella subnet. A rimuovere definitivamente la subnet, per tutte le istanze Cloud SQL che utilizzano un indirizzo è necessario eliminare l'intervallo. La subnet viene eliminata quattro giorni dopo l'ultima di Compute Engine nella subnet.

Modificare l'indirizzo IP privato di un'istanza Cloud SQL esistente

Per modificare l'indirizzo IP privato di un'istanza Cloud SQL esistente, sposta dall'istanza dalla rete originale a un VPC temporaneo in ogni rete. Quindi, modifica l'accesso privato ai servizi. della rete originale dell'istanza e sposta all'istanza Cloud SQL per tornare alla rete originale.

Per passare a un'altra rete VPC, segui tutto tranne l'ultimo passaggio (spostando nuovamente l'istanza) nella procedura seguente. In questo caso, TEMPORARY_VPC_NETWORK_NAME è la nuova rete VPC. Inoltre, elimina la vecchia connessione privata. Potrebbero essere necessari alcuni giorni prima che la connessione privata eliminata scompaia dalla console Google Cloud.

Se l'istanza Cloud SQL è ospitata in una rete VPC condivisa, le variabili VPC_NETWORK_NAME utilizzate nelle istruzioni seguenti devono essere i nomi della rete VPC del progetto host. Per specificare una rete con una rete VPC condivisa, utilizza l'URL completo della rete, ad esempio projects/HOST_PROJECT/global/networks/NETWORK_NAME.

Console

1. Nella console Google Cloud, vai alla pagina Reti VPC.

   Vai a Reti VPC

2. Crea una rete VPC temporanea.
3. Crea un'allocazione IP nella rete VPC temporanea.
4. Crea una connessione privata nella rete VPC temporanea.

5. Sposta l'istanza Cloud SQL nella rete VPC temporanea.

   gcloud beta sql instances patch INSTANCE_ID \
     --project=PROJECT_ID \
     --network=projects/PROJECT_ID/global/networks/TEMPORARY_VPC_NETWORK_NAME \
     --no-assign-ip

6. Modifica la configurazione dell'accesso ai servizi privati nella rete originale per aggiungere un nuovo intervallo allocato o eliminare quelli esistenti.

7. Ripristina l'istanza Cloud SQL al VPC originale in ogni rete.

   gcloud beta sql instances patch INSTANCE_ID \
     --project=PROJECT_ID \
     --network=projects/PROJECT_ID/global/networks/ORIGINAL_VPC_NETWORK_NAME \
     --no-assign-ip