导入 AWS EKS 集群
本教程演示如何使用直接连接方法将 AWS EKS 集群导入 KubeSphere。如果您想使用代理连接方法,请参考代理连接。
准备工作
- 您需要准备一个已安装 KubeSphere 的 Kubernetes 集群,并将其设置为主集群。有关如何准备主集群的更多信息,请参考准备主集群。
- 您需要准备一个 EKS 集群,用作成员集群。
导入 EKS 集群
步骤 1:在 EKS 集群上部署 KubeSphere
您需要首先在 EKS 集群上部署 KubeSphere。有关如何在 EKS 上部署 KubeSphere 的更多信息,请参考在 AWS EKS 上部署 KubeSphere。
步骤 2:准备 EKS 成员集群
为了通过主集群管理,您需要使它们之间的
jwtSecret
相同。首先,需要在主集群上执行以下命令获取jwtSecret
。kubectl -n kubesphere-system get cm kubesphere-config -o yaml | grep -v "apiVersion" | grep jwtSecret
输出类似如下:
jwtSecret: "QVguGh7qnURywHn2od9IiOX6X8f8wK8g"
以
admin
身份登录 EKS 集群的 KubeSphere Web 控制台。点击左上角的平台管理,选择集群管理。访问定制资源定义,在搜索栏输入
ClusterConfiguration
,然后按下键盘上的回车键。点击 ClusterConfiguration 访问其详情页。点击右侧的 ,选择编辑 YAML 来编辑
ks-installer
。在
ks-installer
的 YAML 文件中,将jwtSecret
的值改为如上所示的相应值,将clusterRole
的值改为member
。点击更新保存更改。authentication: jwtSecret: QVguGh7qnURywHn2od9IiOX6X8f8wK8g
multicluster: clusterRole: member
备注
请确保使用您自己的jwtSecret
。您需要等待一段时间使更改生效。
步骤 3:创建新的 kubeconfig 文件
Amazon EKS 不像标准的 kubeadm 集群那样提供内置的 kubeconfig 文件。但您可以参考此文档创建 kubeconfig 文件。生成的 kubeconfig 文件类似如下:
apiVersion: v1 clusters: - cluster: server: <endpoint-url> certificate-authority-data: <base64-encoded-ca-cert> name: kubernetes contexts: - context: cluster: kubernetes user: aws name: aws current-context: aws kind: Config preferences: {} users: - name: aws user: exec: apiVersion: client.authentication.k8s.io/v1alpha1 command: aws args: - "eks" - "get-token" - "--cluster-name" - "<cluster-name>" # - "--role" # - "<role-arn>" # env: # - name: AWS_PROFILE # value: "<aws-profile>"
但是,自动生成的 kubeconfig 文件要求使用此 kubeconfig 的每台计算机均安装有
aws
命令(aws CLI 工具)。在本地计算机上运行以下命令,获得由 KubeSphere 创建的 ServiceAccount
kubesphere
的令牌,该令牌对集群具有集群管理员访问权限,并将用作新的 kubeconfig 令牌。- Kubernetes 1.23 及以前版本
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) kubectl config set-credentials kubesphere --token=${TOKEN} kubectl config set-context --current --user=kubesphere
- Kubernetes 1.24 及以后版本,ServiceAccount 不再自动生成 Secert,参见这里
cat <<EOF >kubesphere-secret.yaml apiVersion: v1 kind: Secret metadata: name: kubesphere namespace: kubesphere-system annotations: kubernetes.io/service-account.name: "kubesphere" type: kubernetes.io/service-account-token EOF
kubectl apply -f kubesphere-secret.yaml TOKEN=`kubectl -n kubesphere-system get secret kubesphere -o jsonpath='{.data.token}' | base64 -d` kubectl config set-credentials kubesphere --token=${TOKEN} kubectl config set-context --current --user=kubesphere
运行以下命令获取新的 kubeconfig 文件:
cat ~/.kube/config
输出类似如下,可以看到已插入新用户
kubesphere
并已将其设置为当前集群环境上下文 (current-context) 用户:apiVersion: v1 clusters: - cluster: certificate-authority-data: LS0tLS1CRUdJTiBDRVJUSUZ...S0tLQo= server: https://*.sk1.cn-north-1.eks.amazonaws.com.cn name: arn:aws-cn:eks:cn-north-1:660450875567:cluster/EKS-LUSLVMT6 contexts: - context: cluster: arn:aws-cn:eks:cn-north-1:660450875567:cluster/EKS-LUSLVMT6 user: kubesphere name: arn:aws-cn:eks:cn-north-1:660450875567:cluster/EKS-LUSLVMT6 current-context: arn:aws-cn:eks:cn-north-1:660450875567:cluster/EKS-LUSLVMT6 kind: Config preferences: {} users: - name: arn:aws-cn:eks:cn-north-1:660450875567:cluster/EKS-LUSLVMT6 user: exec: apiVersion: client.authentication.k8s.io/v1alpha1 args: - --region - cn-north-1 - eks - get-token - --cluster-name - EKS-LUSLVMT6 command: aws env: null - name: kubesphere user: token: eyJhbGciOiJSUzI1NiIsImtpZCI6ImlCRHF4SlE5a0JFNDlSM2xKWnY1Vkt5NTJrcDNqRS1Ta25IYkg1akhNRmsifQ.eyJpc3M................9KQtFULW544G-FBwURd6ArjgQ3Ay6NHYWZe3gWCHLmag9gF-hnzxequ7oN0LiJrA-al1qGeQv-8eiOFqX3RPCQgbybmix8qw5U6f-Rwvb47-xA
您可以运行以下命令检查新的 kubeconfig 是否有权限访问 EKS 集群。
kubectl get nodes
输出类似如下:
NAME STATUS ROLES AGE VERSION ip-10-0-47-38.cn-north-1.compute.internal Ready <none> 11h v1.18.8-eks-7c9bda ip-10-0-8-148.cn-north-1.compute.internal Ready <none> 78m v1.18.8-eks-7c9bda
步骤 4:导入 EKS 成员集群
以
admin
身份登录主集群的 KubeSphere Web 控制台。点击左上角的平台管理,然后选择集群管理。在集群管理页面,点击添加集群。按需输入基本信息,然后点击下一步。
连接方式选择直接连接 Kubernetes 集群。填写 EKS 的新 kubeconfig,然后点击创建。
等待集群初始化完成。
反馈
这篇文章对您有帮助吗?
通过邮件接收 KubeSphere 最新的技术博客与产品更新的通知
感谢您的反馈。如果您有关于如何使用 KubeSphere 的具体问题,请在 Slack 上提问。如果您想报告问题或提出改进建议,请在 GitHub 存储库中打开问题。