#导入 GKE 集群

使用此提供商特定的操作步骤，将现有 Google GKE 集群作为第三方集群导入。除非提供商特定功能有明确文档说明支持相关生命周期管理，否则外部提供商仍负责提供商基础设施，以及由提供商管理的 Kubernetes 和节点生命周期。

#前提条件

• 集群上的 Kubernetes 版本和组件满足导入公有云集群的版本要求。

• 确保集群类型为标准集群，并且帐户具有维护控制平面的权限。目前不支持 Autopilot 集群。

• 镜像仓库必须支持 HTTPS 访问，并提供由公共证书颁发机构认证的有效 TLS 证书。

#准备操作环境

为符合 GKE 安全标准，必须使用 Cloud Shell 执行以下步骤。

1. 确保与 Google 的网络连接正常。

2. 在 Kubernetes Engine 功能中访问 集群页面；找到要导入的集群，单击集群详细信息，然后选择 连接 按钮。

3. 在弹出对话框中，复制用于配置 kubectl 命令行访问权限的命令，然后单击 在 Cloud Shell 中运行 按钮。

4. 等待 Cloud Shell 准备就绪，清空命令行，粘贴上一步复制的内容，然后执行该命令。

5. 现在环境已准备就绪。后续在导入集群环境中执行的所有命令，例如 获取集群信息 和 导入集群 等操作步骤中的命令，都应在 Cloud Shell 中执行。

#获取集群信息

#获取目标集群的 API Server 地址和 CA 证书

1. 在 Kubernetes Engine 功能中访问 集群页面，然后单击进入目标集群的详细信息页面。

2. 可以在 外部端点 部分找到 API Server 地址。

3. 在 Cloud Shell 中使用以下任一方法获取 CA 证书：

   方法 A：从 kubeconfig 获取 CA 证书：

   gcloud container clusters get-credentials <cluster-name> --zone <zone>
   kubectl config view --raw -o jsonpath='{.clusters[0].cluster.certificate-authority-data}' | base64 -d

   方法 B：直接从集群获取 CA 证书：

   gcloud container clusters describe <cluster-name> --zone <zone> --format='get(masterAuth.clusterCaCertificate)' | base64 -d

   注意：将证书粘贴到导入表单之前，必须先对其进行 Base64 解码。

#获取目标集群令牌

公有云集群的 KubeConfig 文件无法直接用于导入集群。

请参阅如何获取集群信息？以获取目标集群令牌。

#导入集群

1. 在左侧导航栏中，点击 集群 > 集群。

2. 点击 管理集群 > 导入集群。

3. 根据以下说明配置相关参数。

   参数	描述
   镜像仓库	用于存储集群所需平台组件镜像的仓库。- 平台默认：全局部署期间配置的镜像仓库。- 私有仓库：存储平台所需组件的预构建仓库。请输入用于访问镜像仓库的 私有镜像仓库地址、端口、用户名和密码。- 公有仓库：使用互联网上的公有镜像仓库服务。使用前，请更新公有仓库云凭证以获取仓库身份验证权限。
   集群信息	集群信息：包括目标集群令牌、目标集群的 API Server 地址和 CA 证书。集群地址：目标集群向平台公开 API Server 的访问地址，用于平台访问集群的 API Server。CA 证书：目标集群的 CA 证书。注意：手动输入时，需要输入经过 Base64 解码的证书。身份验证方式：目标集群的身份验证方式，需要使用上一步创建的、具有集群管理权限的 token（令牌）进行身份验证。

4. 点击 检查连通性，验证与目标集群的网络连通性，并自动识别集群类型。集群类型将以徽章形式显示在表单右上角。

5. 连通性检查通过后，点击 导入并确认。

   TIP

   • 在处于导入中状态的集群右侧，点击详情图标，在弹出的执行进度对话框中查看集群执行进度（status.conditions）。
   • 集群成功导入后，可以在集群列表中查看集群关键信息，集群状态显示为正常，并可以执行集群相关操作。

#网络配置

确保 global 集群与导入的集群之间的网络连通性。请参阅导入集群的网络配置。

#导入后的操作

#Ingress 和存储初始化

导入集群后，如果需要使用 Ingress 和存储相关功能，请参阅Google GKE Ingress Controller 配置和Google GKE 存储配置。

#常见问题

#导入集群后，“添加节点”按钮显示为灰色时，如何添加节点？

不支持通过平台界面添加节点。请联系集群提供商添加节点。

#导入的集群的证书管理功能支持哪些证书？

1. Kubernetes 证书：所有导入的集群仅支持在平台证书管理界面中查看 APIServer 证书信息。不支持查看其他 Kubernetes 证书，也不支持自动轮换。

2. 平台组件证书：所有导入的集群均可在平台证书管理界面中查看平台组件证书信息，并支持自动轮换。