In questa pagina viene descritto come configurare l'accesso privato ai servizi. per la tua rete VPC.
L'accesso ai servizi privati è implementato come connessione in peering VPC tra la tua rete VPC e la rete VPC Google Cloud sottostante in cui risiede la tua istanza Cloud SQL. La connessione privata consente alle istanze VM nella rete VPC e ai servizi a cui accedi di comunicare esclusivamente mediante 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 anche:
- Aggiungi il tuo utente al progetto host.
- Assegna le stesse quattro autorizzazioni all'utente nel progetto host.
- Concedi all'utente l'autorizzazione IAM
compute.globalAddresses.list
.
Configurare l'accesso privato ai servizi per Cloud SQL
Il processo di configurazione dell'accesso privato ai servizi si compone di due parti:
- Selezione di un intervallo di indirizzi IP esistente o allocazione di un nuovo intervallo di indirizzi IP.
Hai anche la possibilità di consentire a Google di allocare l'intervallo per te. In questo caso, Google allocherà automaticamente un intervallo IP prefisso-lunghezza /20 e utilizzare il nome default-ip-range.
Se crei istanze in più regioni o per istanze tipi di database, devi disporre di un intervallo minimo di /24 di 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.
- Creazione di una connessione privata dalla rete VPC alla rete sottostante del producer di servizi.
Alloca un intervallo di indirizzi IP
Console
-
Nella console Google Cloud, vai alla pagina Reti VPC.
- Seleziona la rete VPC che vuoi utilizzare.
- Seleziona la scheda
Connessione privata ai servizi . - Seleziona la scheda
Intervalli IP allocati per i servizi . - Fai clic su
Alloca intervallo IP . - Per il campo
Nome dell'intervallo allocato, specificagoogle-managed-services-VPC_NETWORK_NAME
, doveVPC_NETWORK_NAME
è il nome della rete VPC che stai connettendo (ad ad esempiogoogle-managed-services-default
). La Ladescrizione è facoltativa. - Seleziona l'opzione
Personalizzata , quindi inserisci l'intervallo di indirizzi IP da allocare in notazione CIDR. - Fai clic su
Alloca 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
eprefix-length
. Ad esempio, per allocare il blocco CIDR192.168.0.0/16
, specifica192.168.0.0
per l'indirizzo e16
per la lunghezza del prefisso. - Per specificare solo la lunghezza del prefisso (subnet mask), utilizza il metodo
prefix-length
flag. Se ometti l'intervallo di indirizzi, Google Cloud selezionerà automaticamente un intervallo di indirizzi inutilizzato nella rete VPC. L'esempio seguente seleziona un intervallo di indirizzi IP non utilizzato con una lunghezza del prefisso di16
bit.
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
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 della rete VPC, ad esempio my-vpc-network
.
L'esempio seguente alloca un intervallo IP che consente alle risorse nell'
Rete VPC my-vpc-network
per connettersi a Cloud SQL
di Compute Engine 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.
Applica le modifiche
Per applicare la configurazione Terraform a un progetto Google Cloud, completa i passaggi nella le sezioni seguenti.
Prepara Cloud Shell
- Avvia Cloud Shell.
-
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 Terraform deve avere una directory dedicata (inoltre chiamato modulo principale).
-
In Cloud Shell, crea una directory e un nuovo
file al suo interno. Il nome del file deve contenere
.tf
, ad esempiomain.tf
. In questo tutorial, il file è denominatomain.tf
.mkdir DIRECTORY && cd DIRECTORY && touch main.tf
-
Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.
Copia il codice campione nel nuovo oggetto
main.tf
.Se vuoi, copia il codice da GitHub. Questa opzione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.
- Esamina e modifica i parametri di esempio da applicare al tuo ambiente.
- Salva le modifiche.
-
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
-
Rivedi la configurazione e verifica che le risorse che Terraform creerà o
che l'aggiornamento soddisfi le tue aspettative:
terraform plan
Apporta le correzioni necessarie alla configurazione.
-
Applica la configurazione di Terraform eseguendo il seguente comando e inserendo
yes
al prompt:terraform apply
Attendi che Terraform mostri il messaggio "Applicazione completata".
- Apri il progetto Google Cloud per visualizzare i risultati. Nella console Google Cloud, vai alle risorse nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.
Elimina le modifiche
Rimuovi le risorse applicate in precedenza con la configurazione Terraform eseguendo il seguente
comando e inserendo yes
al prompt:
terraform destroy
Crea una connessione privata
Console
-
Nella console Google Cloud, vai alla pagina Reti VPC.
- Seleziona la rete VPC che vuoi utilizzare.
- Seleziona la scheda Connessione privata ai servizi.
- Seleziona la scheda Connessioni private ai servizi.
- Fai clic su Crea connessione per creare una connessione privata tra i tuoi e un producer di servizi.
- Per Allocazione assegnata, seleziona una o più allocazioni esistenti utilizzati da altri producer di servizi.
- Fai clic su Connetti per creare la connessione.
gcloud
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 dell'istanza Cloud SQL a lunga esecuzione, restituisce un ID operazione.
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 tutte le forniti nell'ordine che hai specificato.
Terraform
Per creare una connessione privata, utilizza una risorsa Terraform.
A un account di servizio nel formato service-HOST_PROJECT_NUMBER@service-networking.iam.gserviceaccount.com
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:service-HOST_PROJECT_NUMBER@service-networking.iam.gserviceaccount.com \ --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 allocato:
Console
-
Nella console Google Cloud, vai alla pagina Reti VPC.
- Seleziona la rete VPC che vuoi utilizzare.
- Seleziona la scheda Connessione ai servizi privati.
- Seleziona la scheda Intervalli IP allocati per i servizi.
Seleziona il nome dell'intervallo che vuoi eliminare.
Fai clic su Rilascia.
Fai clic su Alloca intervallo IP.
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.
gcloud services vpc-peerings update \ --network=VPC_NETWORK_NAME \ --ranges=ALLOCATED_RANGES \ --service=servicenetworking.googleapis.com \ --force
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 la configurazione dell'accesso privato ai servizi della rete originale dell'istanza e sposta nuovamente l'istanza Cloud SQL nella rete originale.
Per passare a una rete VPC diversa, segui tutti i passaggi, tranne l'ultimo (spostamento dell'istanza), della procedura riportata di seguito. 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 non sia più visibile
nella console Google Cloud.
Se l'istanza Cloud SQL è ospitata in una rete VPC condiviso,
VPC_NETWORK_NAME
utilizzate nelle seguenti istruzioni devono essere quelle del progetto host
Nomi delle reti VPC. Specifica una rete con un VPC condiviso
utilizza l'URL completo
rete, ad esempio projects/HOST_PROJECT/global/networks/NETWORK_NAME
.
Console
-
Nella console Google Cloud, vai alla pagina Reti VPC.
- Crea una rete VPC temporanea.
- Crea un'allocazione IP nella rete VPC temporanea.
- Crea una connessione privata nella rete VPC temporanea.
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
Modifica la configurazione dell'accesso privato ai servizi in rete originale per aggiungere un nuovo intervallo allocato o eliminare quelli esistenti.
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