KubeKey一键部署：轻松安装Kubernetes与KubeSphere

已于 2024-02-23 15:42:39 修改
阅读量1.6k 收藏 31
点赞数 21
文章标签： kubernetes 容器 云原生
于 2024-02-21 17:11:33 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/yqwang75457/article/details/136216235
版权
本文详细描述了如何在Linux系统中利用KubeKey工具以All-in-One模式快速、简便地安装Kubernetes和KubeSphere，包括环境准备、依赖组件安装、配置文件编辑以及一键安装流程。
摘要由CSDN通过智能技术生成

本文主要参考“在 Linux 上以 All-in-One 模式安装 KubeSphere”进行实践测试部署。

通过KubeKey工具实现Kubernetes（k8s）和KubeSphere的一键式安装，极大地简化了安装过程。用户无需手动预先安装Docker和Kubernetes，只需按照以下步骤操作：

  1. 关闭防火墙，确保安装环境的安全性。
  2. 关闭分区，确保系统的稳定性和兼容性。
  3. 安装依赖组件，为后续的KubeKey和Kubernetes安装做好准备。
  4. 下载KubeKey工具，这是实现一键安装的关键。
  5. 使用KubeKey的./kk命令创建Kubernetes和KubeSphere集群，整个安装过程将自动完成。

通过以上步骤，用户可以轻松完成Kubernetes和KubeSphere的安装，无需深入了解复杂的安装过程。

1. 准备资源

一台干净的服务器： Centos 7.6 系统，内核版本：3.10.0-1160.71.1.el7.x86_64。

IP

host

内存

CPU

10.8.3.246

master

8Gi

6cores

2. 准备网络

如果服务器已经可以上网，可忽略此步骤。

检查DNS：cat /etc/resolv.conf

若为空，则配置vi /etc/resolv.conf

插入内容：nameserver 61.139.2.69 （具体根据公司情况添加）

3. 环境准备

关闭防火墙、关闭分区、安装依赖组件。

[root@master home]#hostnamectl --static set-hostname master
[root@master home]#cat >> /etc/hosts << EOF 
10.8.3.246 master
EOF
[root@master home]### 关闭防火墙或者开放必要的[防火墙端口](https://v3-0.docs.kubesphere.io/docs/installing-on-linux/introduction/port-firewall/)
[root@master home]#systemctl disable firewalld
[root@master home]#systemctl stop firewalld
[root@master home]#systemctl status firewalld
[root@master home]### 查看并关闭swap分区
[root@master home]#swapoff -a
[root@master home]#echo "vm.swappiness=0" >> /etc/sysctl.conf
[root@master home]#sysctl -p /etc/sysctl.conf
net.ipv6.conf.eth0.accept_dad = 0
net.ipv6.conf.eth0.accept_ra = 1
net.ipv6.conf.eth0.accept_ra_defrtr = 1
net.ipv6.conf.eth0.accept_ra_rtr_pref = 1
net.ipv6.conf.eth0.accept_ra_rt_info_max_plen = 1
vm.swappiness = 0
[root@master home]#sed -i 's$/dev/mapper/centos-swap$#/dev/mapper/centos-swap$g' /etc/fstab
[root@master home]#sed -i "s/^SELINUX=enforcing/SELINUX=disabled/g" /etc/sysconfig/selinux 
[root@master home]#sed -i "s/^SELINUX=enforcing/SELINUX=disabled/g" /etc/selinux/config 
[root@master home]#sed -i "s/^SELINUX=permissive/SELINUX=disabled/g" /etc/sysconfig/selinux 
[root@master home]#sed -i "s/^SELINUX=permissive/SELINUX=disabled/g" /etc/selinux/config
[root@master home]#free -m
totalusedfreeshared  buff/cache   available 
Mem:  32011 300 31168  16 542 31354
Swap:     0   0   0
[root@master home]### 查看Selinux状态
[root@master home]#getenforce
Disabled  
[root@master home]### 安装依赖组件  
[root@master home]#yum install -y ebtables socat ipset conntrack
Loaded plugins: fastestmirror
...........
Complete!

4. 使用kubekey一键安装

4.1. 下载kubekey

[root@master home]#yum install -y wget
Loaded plugins: fastestmirror
...........
Complete!
[root@master home]#export KKZONE=cn
[root@master home]#curl -sfL https://get-kk.kubesphere.io | sh -
[root@master home]#chmod +x kk  

#如果无法下载?
#1.可以从https://github.com/kubesphere/kubekey/releases/tag/v3.0.13手动下载
#2.下载后解压：tar -zxvf kubekey-v3.0.13-linux-amd64.tar.gz
#3.授权chmod +x kk

4.2. 方法1：高级安装（使用配置文件创建的集群）

参考：https://github.com/kubesphere/kubekey/blob/master/README_zh-CN.md#%E9%AB%98%E7%BA%A7%E7%94%A8%E6%B3%95

4.2.1. 创建配置文件

[root@master home]# ./kk create config --with-kubesphere
##需要修改上一条命令在当前目录生成的配置文件：config-sample.yaml，详见下文！

💡 Tips：./kk create config 后面带上--with-kubesphere，否则在安装时，只会安装k8s，不会安装KubeSphere。

4.2.2. 修改配置文件


apiVersion: kubekey.kubesphere.io/v1alpha2
kind: Cluster
metadata:
  name: sample
spec:
  hosts:
  - {name: master, address:10.8.3.246,port: 444, internalAddress: 10.8.3.246, user: root, password: "服务器密码"}
  #- {name: node2, address: 172.16.0.3, internalAddress: 172.16.0.3, user: ubuntu, password: "Qcloud@123"}
  roleGroups:
    etcd:
    - master
    control-plane: 
    - master
    worker:
    - master
    #- node2
  controlPlaneEndpoint:
    ## Internal loadbalancer for apiservers 
    # internalLoadbalancer: haproxy

    domain: lb.kubesphere.local
    address: ""
    port: 6443
  kubernetes:
    version: v1.23.10
    clusterName: cluster.local
    autoRenewCerts: true
    containerManager: docker
  etcd:
    type: kubekey
  network:
    plugin: calico
    kubePodsCIDR: 10.233.64.0/18
    kubeServiceCIDR: 10.233.0.0/18
    ## multus support. https://github.com/k8snetworkplumbingwg/multus-cni
    multusCNI:
      enabled: false
  registry:
    privateRegistry: ""
    namespaceOverride: ""
    registryMirrors: []
    insecureRegistries: []
  addons: []



---
apiVersion: installer.kubesphere.io/v1alpha1
kind: ClusterConfiguration
metadata:
  name: ks-installer
  namespace: kubesphere-system
  labels:
    version: v3.4.1
spec:
  persistence:
    storageClass: ""
  authentication:
    jwtSecret: ""
  local_registry: ""
  # dev_tag: ""
  etcd:
    monitoring: false
    endpointIps: localhost
    port: 2379
    tlsEnable: true
  common:
    core:
      console:
        enableMultiLogin: true
        port: 30880
        type: NodePort
    # apiserver:
    #  resources: {}
    # controllerManager:
    #  resources: {}
    redis:
      enabled: false
      enableHA: false
      volumeSize: 2Gi
    openldap:
      enabled: false
      volumeSize: 2Gi
    minio:
      volumeSize: 20Gi
    monitoring:
      # type: external
      endpoint: http://prometheus-operated.kubesphere-monitoring-system.svc:9090
      GPUMonitoring:
        enabled: false
    gpu:
      kinds:
      - resourceName: "nvidia.com/gpu"
        resourceType: "GPU"
        default: true
    es:
      # master:
      #   volumeSize: 4Gi
      #   replicas: 1
      #   resources: {}
      # data:
      #   volumeSize: 20Gi
      #   replicas: 1
      #   resources: {}
      enabled: false
      logMaxAge: 7
      elkPrefix: logstash
      basicAuth:
        enabled: false
        username: ""
        password: ""
      externalElasticsearchHost: ""
      externalElasticsearchPort: ""
    opensearch:
      # master:
      #   volumeSize: 4Gi
      #   replicas: 1
      #   resources: {}
      # data:
      #   volumeSize: 20Gi
      #   replicas: 1
      #   resources: {}
      enabled: true
      logMaxAge: 7
      opensearchPrefix: whizard
      basicAuth:
        enabled: true
        username: "admin"
        password: "admin"
      externalOpensearchHost: ""
      externalOpensearchPort: ""
      dashboard:
        enabled: false
  alerting:
    enabled: false
    # thanosruler:
    #   replicas: 1
    #   resources: {}
  auditing:
    enabled: false
    # operator:
    #   resources: {}
    # webhook:
    #   resources: {}
  devops:
    enabled: false
    jenkinsCpuReq: 0.5
    jenkinsCpuLim: 1
    jenkinsMemoryReq: 4Gi
    jenkinsMemoryLim: 4Gi
    jenkinsVolumeSize: 16Gi
  events:
    enabled: false
    # operator:
    #   resources: {}
    # exporter:
    #   resources: {}
    ruler:
      enabled: true
      replicas: 2
    #   resources: {}
  logging:
    enabled: false
    logsidecar:
      enabled: true
      replicas: 2
      # resources: {}
  metrics_server:
    enabled: false
  monitoring:
    storageClass: ""
    node_exporter:
      port: 9100
      # resources: {}
    # kube_rbac_proxy:
    #   resources: {}
    # kube_state_metrics:
    #   resources: {}
    # prometheus:
    #   replicas: 1
    #   volumeSize: 20Gi
    #   resources: {}
    #   operator:
    #     resources: {}
    # alertmanager:
    #   replicas: 1
    #   resources: {}
    # notification_manager:
    #   resources: {}
    #   operator:
    #     resources: {}
    #   proxy:
    #     resources: {}
    gpu:
      nvidia_dcgm_exporter:
        enabled: false
        # resources: {}
  multicluster:
    clusterRole: none
  network:
    networkpolicy:
      enabled: false
    ippool:
      type: none
    topology:
      type: none
  openpitrix:
    store:
      enabled: false
  servicemesh:
    enabled: false
    istio:
      components:
        ingressGateways:
        - name: istio-ingressgateway
          enabled: false
        cni:
          enabled: false
  edgeruntime:
    enabled: false
    kubeedge:
      enabled: false
      cloudCore:
        cloudHub:
          advertiseAddress:
            - ""
        service:
          cloudhubNodePort: "30000"
          cloudhubQuicNodePort: "30001"
          cloudhubHttpsNodePort: "30002"
          cloudstreamNodePort: "30003"
          tunnelNodePort: "30004"
        # resources: {}
        # hostNetWork: false
      iptables-manager:
        enabled: true
        mode: "external"
        # resources: {}
      # edgeService:
      #   resources: {}
  gatekeeper:
    enabled: false
    # controller_manager:
    #   resources: {}
    # audit:
    #   resources: {}
  terminal:
    timeout: 600

4.2.3. 执行安装

##通过指定配置文件来创建集群
[root@master home]# ./kk create cluster -f config-sample.yaml
##等待完成即可！

4.3. 方法2：快速入门（all-in-one）

参考：在 Linux 上以 All-in-One 模式安装 KubeSphere

[root@master home]# ./kk create cluster --with-kubernetes v1.22.12 --with-kubesphere v3.4.1
#等待完成即可！

5. 验证安装结果

5.1. 等待安装并最终看到如下日志输出

#####################################################
###              Welcome to KubeSphere!           ###
#####################################################

Console: http://10.8.3.246:30880
Account: admin
Password: P@88w0rd
NOTES：
  1. After you log into the console, please check the
     monitoring status of service components in
     "Cluster Management". If any service is not
     ready, please wait patiently until all components 
     are up and running.
  2. Please change the default password after login.

#####################################################
https://kubesphere.io             2024-02-21 03:06:10
#####################################################
03:06:11 EST success: [master]
03:06:11 EST Pipeline[CreateClusterPipeline] execute successfully
Installation is complete.

Please check the result using the command:

        kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l 'app in (ks-install, ks-installer)' -o jsonpath='{.items[0].metadata.name}') -f

5.2. 命令查看安装结果

 kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l 'app in (ks-install, ks-installer)' -o jsonpath='{.items[0].metadata.name}') -f

5.3. 浏览器访问

http://10.8.3.246:30880/

Account: admin

Password: P@88w0rd

6. 部署一个nginx

7. 卸载

#如果是使用高级模式安装的 KubeSphere（使用配置文件创建的），则使用以下命令卸载：
./kk delete cluster -f config-sample.yaml

#如果是普通的，直接使用以下命令卸载：
./kk delete cluster

8. 使用手册

8.1. 手册入口

登录平台，点击右上角“用户指南”，或直接打开https://kubesphere.io/zh/docs/v3.4/

8.2. 官方KubeSphere文档

文档根据相关分类（集群管理、企业空间管理和用户指南、项目用户指南、DevOps 用户指南、帐户管理和权限控制、工具箱等）排列，非常详细。当然也可以通过在顶部搜索关键字的方式查找。

8.3. 其他

💡 当然遇到问题还有更多方式可以咨询解决：

  • 加入社区微信群：关注公众号 KubeSphere云原生 或搜索添加好友 kubesphere

9. 问题

9.1. 还需要单独安装Docker吗？

KubeKey 会默认安装最新版本的 Docker。当然，也可以在创建集群前手动安装 Docker 或其他容器运行时。

上文安装创建过程中可以看到，默认已经下载并安装docker。

9.2. 使用方法2时，执行./kk create时报错？

错误信息：

21:54:16 EST [GreetingsModule] Greetings

21:54:16 EST failed: [node1]

error: Pipeline[CreateClusterPipeline] execute failed: Module[GreetingsModule] exec failed:failed: [node1] failed to connect to 10.8.3.246: could not establish connection to 10.8.3.246:22: dial tcp 10.8.3.246:22: connect: connection refused

原因：

kubekey默认用22端口！

而当前你的服务器ssh不是22端口，而是444或其他端口（看看远程服务器用的什么端口）！

解决办法：

方法1：改ssh端口，vi /etc/ssh/sshd_config改成22端口，重启ssh：systemctl restart sshd，再重试方法2。

方法2：使用上文方法1：高级安装（使用配置文件创建的集群）。

10. 参考文献

官网地址：在 Linux 上以 All-in-One 模式安装 KubeSphere

github：https://github.com/kubesphere/kubekey

yqwang_cn
关注
  • 21
    点赞
  • 踩
  • 31
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
六、kubekey一键安装k8s和KubeSphere高可用集群
IT谢彪的博客
09-20 529
kubekey一键安装k8s和KubeSphere高可用集群
KubeSphere核心实战_在Centos7.9/linux单节点使用kubekey一键安装完整平台_启用插件_一键安装docker_k8s_kubesphere---分布式云原生部署架构搭建038
添柴程序猿的专栏
07-22 92
现在我们在单个linux节点上部署一个完整的,包含k8s,docker,kubesphere的环境,可以看到,正在running,但是还有kubesphere-system 两个在创建容器中,等等。现在我们安装了kubesphere以后,但是这个功能少很多,很单一,但是后面可以开启其他功能。但是我根据需要,安装了一个全功能版本的kubesphere,开启了很多功能,安装需要10几分钟,需要等, 提示是否安装,就输入yes。可以看到注意下载以后,记得,给kk,添加上执行权限.
KubeKey 实践-部署高可用 Kubernetes 集群.pdf
05-07
KubeKey 实践-部署高可用 Kubernetes 集群.pdf
kubekey：提供了一种灵活，快速和便捷的方式来仅安装Kubernetes和KubeSphere以及相关的云原生附加组件，仅安装Kubernetes。 它也是扩展和升级集群的有效工具
02-03
KubeKey English | 从v3.0.0开始， 将基于Ansible的安装程序更改为使用Go语言开发的名为KubeKey的新安装程序。 使用KubeKey，您可以分别，轻松，高效且灵活地安装Kubernetes和KubeSphere。 有三种使用KubeKey的方案。 仅安装Kubernetes 在一个命令中一起安装Kubernetes和KubeSphere 首先安装Kubernetes，然后使用在其上部署KubeSphere 重要提示：如果您已有集群，请参考 。 动机 基于Ansible的安装程序具有大量软件依赖性，例如Python。 KubeKey是使用Go语言开发的
信创：鲲鹏(arm64)+麒麟(kylin v10)离线部署k8s和kubesphere(含离线部署新方式)
虫虫的博客
07-09 1686
鲲鹏(arm64)+麒麟(kylin v10)离线部署k8s和kubesphere(含离线部署新方式)
KubeSphere - 使用 kubekey 搭建 k8s 集群 及 kubeSphere
小毕超博客
02-03 7527
一、kubekey kubeykey是KubeSphere基于Go 语言开发的kubernetes集群部署工具，使用 KubeKey，您可以轻松、高效、灵活地单独或整体安装 Kubernetes 和KubeSphere。 KubeKey可以用于以下三种安装场景： 仅安装 Kubernetes集群 使用一个命令安装 Kubernetes 和 KubeSphere 已有Kubernetes集群，使用ks-installer 在其上部署 KubeSphere。 官网地址：https://kubesphere.i
Linux多节点部署KubeSphere
weixin_38770022的博客
10-20 438
1、准备三台服务器 [ ] 4c8g （master） [ ] 8c16g * 2（worker） [ ] centos7.9 [ ] 内网互通 [ ] 每个机器有自己域名 [ ] 防火墙开放30000~32767端口 2、使用KubeKey创建集群 1、下载KubeKey export KKZONE=cn curl -sfL https://get-kk.kubesphere.io | VERSION=v1.1.1 sh - chmod +x kk 2、创建集群配置文件 ./kk create co
使用kubeKey安装kubeSphere
lcq_lxy的博客
12-22 757
使用kubeKey安装kubeSphere。如果你和作者一样在部署时下载遇到了约束可用参考该文章，该文档主要使用代理方案将包给提前下载了有些脚本更改了代理路径，希望对您有所帮助！
使用 KubeKey 快速安装 Kubernetes 集群
技术宅，专注云原生、Go、Linux、Java等技术分享，原创文章、效率工具、实战解决方案！关注我，了解互联网动态，学 IT 不迷路
03-21 450
Kubernetes 可能是正确启动和运行的真正挑战。当您真的希望快速完成时尤其如此，以便您可以创建测试或开发环境或只是熟悉它的工作原理。每次需要一个多节点集群时，您可能没有时间启动一个多节点集群。在这种情况下，您总是可以求助于KubeKey，这使得为开发/测试目的启动 Kubernetes 部署变得非常容易。 但是，不要认为以这种方式使用 KubeKey 是大规模部署应用程序和服务的一种方式。我将向您展示的主要是为了测试和开发目的，所以甚至不要将其视为生产就绪应用程序或服务的解决方案。 为了完成这项工作.
云原生之容器编排实践-OpenEuler23.09在线安装Kubernetes与KubeSphere
Heartsuit的博客
06-30 1338
前几篇文章中介绍了如何将ruoyi-cloud项目部署到Kubernetes集群中，包括网关服务、认证服务和系统服务并且对全部服务采用YAML文件的方式来进行部署，这虽然有助于理解K8S组织管理资源的风格与底层机制，但是对于团队中不太熟悉命令行操作的成员不太友好，现在我们借助由青云开源的容器平台KubeSphere来进行可视化的服务部署。KubeSphere是在Kubernetes之上构建的面向云原生应用的分布式操作系统，完全开源，支持多云与多集群管理，提供全栈的IT自动化运维能力；KubeKey一键安装。
KubeSphere核心实战_在Centos7.9使用kubekey一键构建k8s集群完整平台_多节点自动化部署kubesphere_k8s集群---分布式云原生部署架构搭建039
最新发布
添柴程序猿的专栏
07-22 1984
可以看到其实就是指定了配置文件,kubernetes的版本和kubesphere的版本。可以看到我们有三台机器,并且内部互通.点击复制标志可以复制它的内网的ip地址。进行一键部署的,现在我们准备3台机器,用kubekey,部署k8s集群.上一节我们在一个单节点上部署了kubesphere,使用kubekey。可以看官网,有all in one 就是所有的都装在一个机器上.也是首先执行上面的这两个命令,下载配置文件。可以看到安装步骤,跟着做就可以了.然后可以看到有个多节点安装,打开。连接上三台机器,首先。
在OpenEuler中，使用kubeKey一键安装kubesphere
OwenDom的博客
10-13 1024
openeular安装kuberesphere
通过kubekey超简单安装k8s和kubesphere(单机版)
m0_64519023的博客
04-25 758
环境准备执行命令:导出环境变量exportKKZONEcn。
使用kubekey搭建kubernetes和kubesphere
qq_42315648的博客
03-23 841
kubekey部署kubernetes和kubesphere部署教程
借助kubekey极速安装Kubernetes
fishmai的专栏
07-30 1257
尽管可以使用，但是仍旧需要kubeadminit和kubeadmjoin等操作；作为开发人员，多数时候，我们并不想将时间浪费在繁琐的安装操作上，可以借助于kubesphere提供的安装工具来迅速搭建kubernetes集群。下面将要安装的是，适合开发工作。............
使用kubekey的all-in-one安装K8S1.24及KubeSphere3.3
云来山更佳，云去山如画
08-08 4360
使用kubekey的all-in-one安装K8S1.24及KubeSphere3.3
云原生|kubernetes|kubernetes集群部署神器kubekey安装部署高可用k8s集群（半离线形式）
zsk_john的技术分享专用博客
07-23 2174
前面利用kubekey部署了一个简单的非高可用，etcd单实例的kubernetes集群，经过研究，发现部署过程可以简化，省去了一部分下载过程（主要是下载kubernetes组件的过程）只是kubernetes版本会固定在1.22.16版本，etcd集群可以部署成生产用的外部集群，并且apiserver等等组件也是高可用，并且部署非常简单，因此，也就非常nice了。
kubekey—创建kubernetes集群、安装kubesphere3.3
大虾别跑
07-21 2352
kubekey—创建kubernetes集群、安装kubesphere3.3
[Kubernetes] KubeKey 部署 K8s v1.28.8
959
05-08 878
KubeKey 部署 K8s v1.28.8
一键部署Kubernetes（K8s）在CentOS 7：本地安装教程与注意事项
本文档是一份详细的Kubernetes (K8s) 本地一键安装教程，针对的是CentOS 7操作系统环境。首先，安装前的准备工作至关重要，确保所有节点满足以下条件： 1. **系统环境**：推荐使用CentOS 7，因为文档示例是基于此...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

yqwang_cn

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值