导入 AWS EKS 集群

本教程演示如何使用直接连接方法将 AWS EKS 集群导入 KubeSphere。如果您想使用代理连接方法，请参考代理连接。

准备工作

  • 您需要准备一个已安装 KubeSphere 的 Kubernetes 集群，并将其设置为 Host 集群。有关如何准备 Host 集群的更多信息，请参考准备 Host 集群。
  • 您需要准备一个 EKS 集群，用作 Member 集群。

导入 EKS 集群

步骤 1：在 EKS 集群上部署 KubeSphere

您需要首先在 EKS 集群上部署 KubeSphere。有关如何在 EKS 上部署 KubeSphere 的更多信息，请参考在 AWS EKS 上部署 KubeSphere。

步骤 2：准备 EKS Member 集群

  1. 为了通过 Host 集群管理 Member 集群，您需要使它们之间的 jwtSecret 相同。首先，需要在 Host 集群上执行以下命令获取 jwtSecret。

    1. kubectl -n kubesphere-system get cm kubesphere-config -o yaml | grep -v "apiVersion" | grep jwtSecret

    输出类似如下：

    1. jwtSecret: "QVguGh7qnURywHn2od9IiOX6X8f8wK8g"

  2. 以 admin 身份登录 EKS 集群的 KubeSphere Web 控制台。点击左上角的平台管理，选择集群管理。

  3. 访问自定义资源 CRD，在搜索栏输入 ClusterConfiguration，然后按下键盘上的回车键。点击 ClusterConfiguration 访问其详情页。

    search-config

  4. 点击右侧的三个点，选择编辑配置文件来编辑 ks-installer。

    click-edit

  5. 在 ks-installer 的 YAML 文件中，将 jwtSecret 的值改为如上所示的相应值，将 clusterRole 的值改为 member。点击更新保存更改。

    1. authentication:
    2.   jwtSecret: QVguGh7qnURywHn2od9IiOX6X8f8wK8g
    1. multicluster:
    2.   clusterRole: member

    备注

    请确保使用您自己的 jwtSecret。您需要等待一段时间使更改生效。

步骤 3：创建新的 kubeconfig 文件

  1. Amazon EKS 不像标准的 kubeadm 集群那样提供内置的 kubeconfig 文件。但您可以参考此文档创建 kubeconfig 文件。生成的 kubeconfig 文件类似如下：

    1. apiVersion: v1
    2. clusters:
    3. - cluster:
    4.     server: <endpoint-url>
    5.     certificate-authority-data: <base64-encoded-ca-cert>
    6.   name: kubernetes
    7. contexts:
    8. - context:
    9.     cluster: kubernetes
    10.     user: aws
    11.   name: aws
    12. current-context: aws
    13. kind: Config
    14. preferences: {}
    15. users:
    16. - name: aws
    17.   user:
    18.     exec:
    19.       apiVersion: client.authentication.k8s.io/v1alpha1
    20.       command: aws
    21.       args:
    22.         - "eks"
    23.         - "get-token"
    24.         - "--cluster-name"
    25.         - "<cluster-name>"
    26.         # - "--role"
    27.         # - "<role-arn>"
    28.       # env:
    29.         # - name: AWS_PROFILE
    30.         #   value: "<aws-profile>"

    但是，自动生成的 kubeconfig 文件要求使用此 kubeconfig 的每台计算机均安装有 aws 命令（aws CLI 工具）。

  2. 在本地计算机上运行以下命令，获得由 KubeSphere 创建的 ServiceAccount kubesphere 的令牌，该令牌对集群具有集群管理员访问权限，并将用作新的 kubeconfig 令牌。

    1. TOKEN=$(kubectl -n kubesphere-system get secret $(kubectl -n kubesphere-system get sa kubesphere -o jsonpath='{.secrets[0].name}') -o jsonpath='{.data.token}' | base64 -d)
    2. kubectl config set-credentials kubesphere --token=${TOKEN}
    3. kubectl config set-context --current --user=kubesphere

  3. 运行以下命令获取新的 kubeconfig 文件：

    1. cat ~/.kube/config

    输出类似如下，可以看到已插入新用户 kubesphere 并已将其设置为当前集群环境上下文 (current-context) 用户：

    1. apiVersion: v1
    2. clusters:
    3. - cluster:
    4.     certificate-authority-data: LS0tLS1CRUdJTiBDRVJUSUZ...S0tLQo=
    5.     server: https://*.sk1.cn-north-1.eks.amazonaws.com.cn
    6.   name: arn:aws-cn:eks:cn-north-1:660450875567:cluster/EKS-LUSLVMT6
    7. contexts:
    8. - context:
    9.     cluster: arn:aws-cn:eks:cn-north-1:660450875567:cluster/EKS-LUSLVMT6
    10.     user: kubesphere
    11.   name: arn:aws-cn:eks:cn-north-1:660450875567:cluster/EKS-LUSLVMT6
    12. current-context: arn:aws-cn:eks:cn-north-1:660450875567:cluster/EKS-LUSLVMT6
    13. kind: Config
    14. preferences: {}
    15. users:
    16. - name: arn:aws-cn:eks:cn-north-1:660450875567:cluster/EKS-LUSLVMT6
    17.   user:
    18.     exec:
    19.       apiVersion: client.authentication.k8s.io/v1alpha1
    20.       args:
    21.       - --region
    22.       - cn-north-1
    23.       - eks
    24.       - get-token
    25.       - --cluster-name
    26.       - EKS-LUSLVMT6
    27.       command: aws
    28.       env: null
    29. - name: kubesphere
    30.   user:
    31.     token: eyJhbGciOiJSUzI1NiIsImtpZCI6ImlCRHF4SlE5a0JFNDlSM2xKWnY1Vkt5NTJrcDNqRS1Ta25IYkg1akhNRmsifQ.eyJpc3M................9KQtFULW544G-FBwURd6ArjgQ3Ay6NHYWZe3gWCHLmag9gF-hnzxequ7oN0LiJrA-al1qGeQv-8eiOFqX3RPCQgbybmix8qw5U6f-Rwvb47-xA

    您可以运行以下命令检查新的 kubeconfig 是否有权限访问 EKS 集群。

    1. kubectl get nodes

    输出类似如下：

    1. NAME                                        STATUS   ROLES    AGE   VERSION
    2. ip-10-0-47-38.cn-north-1.compute.internal   Ready    <none>   11h   v1.18.8-eks-7c9bda
    3. ip-10-0-8-148.cn-north-1.compute.internal   Ready    <none>   78m   v1.18.8-eks-7c9bda

步骤 4：导入 EKS Member 集群

  1. 以 admin 身份登录 Host 集群的 KubeSphere Web 控制台。点击左上角的平台管理，然后选择集群管理。在集群管理页面，点击添加集群。

    click-add-cluster

  2. 按需输入基本信息，然后点击下一步。

    input-info

  3. 连接方式选择直接连接 Kubernetes 集群。填写 EKS Member 集群的 kubeconfig，然后点击导入。

    eks-kubeconfig

  4. 等待集群初始化完成。

    eks-overview