Configurare un cluster privato in Cloud Code per VS Code

Un cluster privato è un cluster nativo di Virtual Private Cloud (VPC) che dipende solo da indirizzi IP interni. Ciò significa che nodi e pod sono isolati da internet per impostazione predefinita. Questa pagina spiega come utilizzare Cloud Code per connettersi a cluster privati con e senza accesso all'endpoint pubblico e consentire ai cluster privati di accedere alle risorse dall'esterno Google Cloud.

Per informazioni sui cluster privati, vedi Cluster privati. Per i passaggi per configurare i cluster privati, vedi 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 con l'endpoint pubblico abilitato, l'aggiunta del cluster imposta l'indirizzo del cluster in KubeConfig sull'IP esterno.

  • Per i cluster con l'endpoint pubblico disattivato, l'aggiunta del cluster imposta l'indirizzo del cluster in KubeConfig in modo che corrisponda all'IP VPC interno del cluster.

Per aggiungere una rete autorizzata a un cluster esistente, assicurati di essere connesso a una rete autorizzata, poiché questo cluster ha le reti autorizzate abilitate.

Per saperne di più sulla connessione alle VM senza indirizzi IP esterni, consulta Connessione sicura alle 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 deve 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 Google Cloud console 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, i suggerimenti su come risolvere il problema vengono visualizzati nei seguenti contesti:

  • Nella sezione espansa Kubernetes, i cluster a cui Cloud Code non riesce a connettersi vengono visualizzati con un'icona di errore accanto al nome del cluster. Per visualizzare possibili soluzioni alternative e una spiegazione più dettagliata 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ù lunga del potenziale problema e potenziali soluzioni alternative.

Configura un server proxy per un cluster

Se l'API del control plane non è disponibile pubblicamente, ad esempio in un cluster GKE con endpoint pubblico disattivato, puoi configurare Cloud Code per eseguire il proxy delle richieste al control plane tramite un server proxy sulla stessa rete o VPC del cluster:

  1. Configura un server proxy sulla stessa rete del cluster, se non l'hai ancora fatto. Per i passaggi per configurare una VM di Compute Engine come server proxy di base, consulta Accedere in remoto a un cluster privato utilizzando un bastion host. Per ulteriori dettagli, vedi Creazione di cluster privati Google Kubernetes Engine con proxy di rete per l'accesso al controller.
  2. Fai clic con il tasto destro del mouse sul nome di un cluster che hai aggiunto a Cloud Code e poi fai clic su Configura il proxy Kubectl per il cluster. Segui le istruzioni per inserire il nome del server proxy, che è memorizzato nel campo proxy-url del cluster. La visualizzazione Kubernetes viene ricaricata per mostrare il cluster connesso.

Annulla il proxy Kubernetes

Fai clic con il tasto destro del mouse sul nome di un cluster che hai configurato per il proxy Kubernetes e poi fai clic su Annulla proxy Kubectl per il cluster. Cloud Code interrompe il proxy delle richieste per il cluster annullando l'impostazione del campo proxy-url in KubeConfig.

Accedere alle risorse al di fuori di Google Cloud dai cluster

Tutte le configurazioni dei cluster privati GKE non forniscono ai nodi l'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, ad esempio, consente ai cluster di estrarre immagini da Artifact Registry. Le API e i registri delle immagini al di fuori di Google Cloud sono inaccessibili senza configurazione aggiuntiva per consentire le connessioni a internet in uscita dai nodi. Per fornire queste connessioni, puoi configurare Cloud NAT sul tuo VPC da Cloud Code:

  1. Esegui il comando Concedi ai nodi GKE privati l'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+P o fai clic su Visualizza > Tavolozza comandi).
  2. Nel terminale, modifica i comandi gcloud compute routers create e gcloud beta compute routers nats create per specificare i valori per la tua applicazione.
  3. Per eseguire i comandi, premi Enter.
  4. Per gestire/eliminare i router che hai creato, consulta Router Cloud.

Passaggi successivi

Richiedi assistenza

Per inviare feedback, fai una domanda su Stack Overflow. Se sei un cliente Google Cloud, puoi inviare ticket tramite i canali di assistenza Google Cloud standard.