私人叢集是一種虛擬私有雲 (VPC) 原生叢集，只會使用內部 IP 位址。也就是說，節點和 Pod 預設會與網際網路隔離。本頁面說明如何使用 Cloud Code 連線至私人叢集 (無論是否有公開端點存取權)，並允許私人叢集從外部 Google Cloud存取資源。
如要瞭解私人叢集，請參閱「私人叢集」。如需設定私人叢集的步驟，請參閱「建立私人叢集」。
將私人 GKE 叢集新增至 KubeConfig
在 Cloud Code 中新增私人叢集時，會發生下列行為：
如果叢集已啟用公開端點，新增叢集會將 KubeConfig 中的叢集位址設為外部 IP。
對於已關閉公開端點的叢集，新增叢集會將 KubeConfig 中的叢集位址設為叢集的內部 VPC IP。
如要將授權網路新增至現有叢集，請確認您已連線至授權網路，因為這個叢集已啟用授權網路。
如要進一步瞭解如何連線至沒有外部 IP 位址的 VM，請參閱「安全地連線至 VM 執行個體」。如要管理/刪除您建立的執行個體，請參閱「VM 執行個體」。
如要成功連線至私人叢集，Cloud Code 必須在叢集網路中的機器上執行，或是能夠存取叢集網路，例如使用 Proxy 伺服器、Cloud Interconnect 或 Cloud VPN。
如要瞭解如何在 Cloud Code 中建立 GKE 叢集，以及將現有的 GKE 叢集新增至 Cloud Code，請參閱「建立及設定 GKE 叢集」。Cloud Code 會開啟 Google Cloud 主控台，以便建立叢集。
建立叢集後，如果在建立叢集期間未設定 Cloud NAT，請設定 Cloud NAT，以便叢集可建立傳出網際網路連線。如要管理/刪除您建立的網路，請參閱「虛擬私有雲網路」。
排解連線至私人叢集的問題
如果開發環境未正確設定為存取私人叢集，系統會在下列情況下顯示解決問題的建議：
在 Kubernetes Explorer 中，Cloud Code 無法連線的叢集會顯示在叢集名稱旁的錯誤圖示。
當您嘗試在叢集上執行作業，但因私人叢集設定可能發生問題而無法存取時，工具提示會顯示錯誤訊息，並進一步說明潛在問題和可能的解決方法。如要查看錯誤訊息，請將游標懸停在有錯誤圖示的叢集上。
如要查看私人叢集文件，請在叢集上按一下滑鼠右鍵，然後選取「View Private Cluster Docs」。
為叢集設定 Proxy 伺服器
如果控制層 API 無法公開使用 (例如在已關閉公開端點的 GKE 叢集中)，您可以設定 Cloud Code，透過與叢集相同網路或虛擬私有雲端的 Proxy 伺服器，將要求代理至控制層：
- 如果尚未在叢集所屬的網路上設定 Proxy 伺服器，請先完成這項設定。如要瞭解如何將 Compute Engine VM 設為基本 Proxy 伺服器，請參閱「使用防禦主機遠端存取私人叢集」一文。如需更多詳細資訊，請參閱「透過網路 Proxy 建立 Google Kubernetes Engine 私人叢集，以便存取控制器」。
- 在您新增至 Cloud Code的叢集名稱上按一下滑鼠右鍵，然後按一下「Setup Kubectl Proxying」。按照提示輸入 Proxy 伺服器名稱，該名稱會儲存在叢集的
proxy-url欄位中。Kubernetes Explorer 會重新載入，並顯示已連線的叢集。
取消 Kubernetes 代理
在您已為 Kubernetes 代理設定的叢集名稱上按一下滑鼠右鍵，然後點選「Cancel Kubectl Proxying」。Cloud Code 會透過取消設定 KubeConfig 中的 proxy-url 欄位，停止為叢集代管要求。
從叢集 Google Cloud 外部存取資源
並非所有 GKE 私人叢集設定都會提供可存取網際網路的節點。因此，叢集無法存取公開網際網路上的 API。系統會自動設定叢集的私人 Google 存取權，例如允許叢集從 Artifact Registry 提取映像檔。如要存取 Google Cloud 以外的 API 和映像註冊表，您必須額外設定，允許節點建立傳出連線。如要提供這些連線，您可以在 Cloud Code 中設定 VPC 的 Cloud NAT：
- 在 Kubernetes Explorer 中，按一下叢集的滑鼠右鍵，然後選取「Grant Private GKE Internet」。
- 在終端機中編輯
gcloud compute routers create和gcloud beta compute routers nats create指令，指定應用程式的值。請務必選擇私人叢集所在的{REGION}。如需支援的地區清單，請參閱「地區和區域」。 - 如要執行指令，請按下
Enter。 - 如要管理/刪除您建立的路由器，請參閱「Cloud Router」。
後續步驟
- 瞭解共用虛擬私有雲網路。