Un cluster privato è un cluster nativo di Virtual Private Cloud (VPC) che dipende solo dagli indirizzi IP interni. Ciò significa che i nodi e i pod sono isolati da Internet per impostazione predefinita. Questa pagina spiega come utilizzare Cloud Code per connettersi ai cluster privati con e senza accesso agli endpoint pubblici e consentire ai cluster privati di accedere alle risorse esterne a Google Cloud.
Per informazioni sui cluster privati, consulta Cluster privati. Per i passaggi per configurare cluster privati, consulta Creazione di un cluster privato.
Aggiungi un cluster GKE privato a KubeConfig
L'aggiunta di un cluster privato in Cloud Code ha il seguente comportamento:
Per i cluster in cui è abilitato l'endpoint pubblico, l'aggiunta del cluster imposta l'indirizzo del cluster in KubeConfig sull'IP esterno.
Per i cluster in cui l'endpoint pubblico è disattivato, l'aggiunta del cluster ne imposta l'indirizzo in KubeConfig come IP VPC interno del cluster.
Per aggiungere una rete autorizzata a un cluster esistente, assicurati di disporre di una connessione a una rete autorizzata, in quanto questo cluster ha le reti autorizzate abilitate.
Per saperne di più sulla connessione a VM senza indirizzi IP esterni, consulta Connessione sicura a istanze VM. Per gestire/eliminare le istanze che hai creato, consulta Istanze VM.
Per connettersi correttamente al cluster privato, Cloud Code deve essere in esecuzione su una macchina nella rete del cluster o essere in grado di accedere alla rete del cluster, ad esempio utilizzando un server proxy, Cloud Interconnect o Cloud VPN.
Per i passaggi per creare cluster GKE in Cloud Code e aggiungere cluster GKE esistenti a Cloud Code, consulta Creare e configurare un cluster GKE. Cloud Code apre la console Google Cloud per creare il cluster.
Dopo aver creato il cluster, configura Cloud NAT per abilitare le connessioni a Internet in uscita dal cluster, se non è stato configurato durante la creazione del cluster. Per gestire/eliminare le reti che hai creato, consulta Reti VPC.
Risolvere i problemi di connessione ai cluster privati
Se l'ambiente di sviluppo non è configurato correttamente per accedere a un cluster privato, nei seguenti contesti vengono visualizzati suggerimenti su come risolvere il problema:
Nella sezione Kubernetes espansa, i cluster che non possono essere connessi a Cloud Code vengono visualizzati con un'icona di errore accanto al nome del cluster. Per visualizzare le possibili soluzioni alternative e una spiegazione più lunga del potenziale problema, fai clic sul nome del cluster.
Quando provi a eseguire operazioni su un cluster inaccessibile a causa di potenziali problemi con la configurazione del cluster privato, una notifica mostra un messaggio di errore con una spiegazione più dettagliata del potenziale problema e delle possibili soluzioni.
Configura un server proxy per un cluster
Se l'API del piano di controllo non è disponibile pubblicamente, ad esempio in un cluster GKE con l'endpoint pubblico disattivato, puoi configurare Cloud Code per le richieste proxy al piano di controllo tramite un server proxy sulla stessa rete o VPC del cluster:
- Configura un server proxy sulla stessa rete del cluster, se non l'hai già fatto. Per i passaggi per configurare una VM Compute Engine come server proxy di base, consulta Accedere da remoto a un cluster privato utilizzando un bastion host. Per ulteriori dettagli, consulta Creazione di cluster privati Google Kubernetes Engine con proxy di rete per l'accesso al controller.
- Fai clic con il tasto destro del mouse sul nome di un cluster che hai
aggiunto a Cloud Code, quindi fai clic su
Configura il proxy Kubectl per il cluster. Segui le istruzioni per inserire il nome del tuo server proxy, che viene memorizzato nel campo
proxy-urldel cluster. La visualizzazione Kubernetes si ricarica per visualizzare il cluster connesso.
Annulla proxy Kubernetes
Fai clic con il tasto destro del mouse sul nome del cluster che hai configurato per il proxy di Kubernetes, quindi fai clic su Annulla il proxy Kubectl per il cluster. Cloud Code smette di eseguire il proxy delle richieste per il cluster annullando l'impostazione del campo proxy-url in KubeConfig.
Accedi alle risorse esterne a Google Cloud dai cluster
Tutte le configurazioni dei cluster privati GKE non forniscono nodi all'accesso a Internet. Di conseguenza, i cluster non possono raggiungere le API sulla rete Internet pubblica. I cluster vengono configurati automaticamente con l'accesso privato Google, che consente, ad esempio, ai cluster di estrarre immagini da Artifact Registry o Container Registry. Le API e i registri di immagini esterni a Google Cloud non sono accessibili senza configurazione aggiuntiva per consentire le connessioni a Internet in uscita dai nodi. Per fornire queste connessioni, puoi configurare Cloud NAT sulla tua rete VPC da Cloud Code:
- Esegui il comando Concedi ai nodi GKE privati di accesso a Internet in uscita, facendo clic con il tasto destro del mouse su un cluster o dalla tavolozza dei comandi (premi
Ctrl/Cmd+Shift+Po fai clic su Visualizza > Tavolozza comandi). - Nel terminale, modifica i comandi
gcloud compute routers createegcloud beta compute routers nats createper specificare i valori della tua applicazione. - Per eseguire i comandi, premi
Enter. - Per gestire/eliminare i router creati, consulta Router Cloud.
Passaggi successivi
- Scopri di più sulle reti con reti Virtual Private Cloud.