KubeKey 正在参加 2020 年度 OSC 中国开源项目评选,请投票支持!
KubeKey 在 2020 年度 OSC 中国开源项目评选 中已获得 {{ projectVoteCount }} 票,请投票支持!
投票让它出道
已投票
KubeKey 获得 2020 年度 OSC 中国开源项目评选「最佳人气项目」 !
KubeKey 获得 2020 年度 OSC 中国开源项目评选「最佳人气项目」「最积极运营项目」 !
KubeKey 获得 2020 年度 OSC 中国开源项目评选「最积极运营项目」 !

软件简介

KubeKey(由 Go 语言开发)是一种全新的安装工具,替代了以前使用的基于 ansible 的安装程序。KubeKey 为您提供灵活的安装选择,您可以仅安装 Kubernetes,也可以同时安装 Kubernetes 和 KubeSphere。

KubeKey 的几种使用场景:

  • 仅安装 Kubernetes;
  • 使用一个命令同时安装 Kubernetes 和 KubeSphere;
  • 扩缩集群;
  • 升级集群;
  • 安装 Kubernetes 相关的插件(Chart 或 YAML)。

KubeKey 如何运作

下载 KubeKey 之后,您可以使用可执行文件 kk 来进行不同的操作。无论您是使用它来创建,扩缩还是升级集群,都必须事先使用 kk 准备配置文件。此配置文件包含集群的基本参数,例如主机信息、网络配置(CNI 插件以及 Pod 和 Service CIDR)、仓库镜像、插件(YAML 或 Chart)和可插拔组件选项(如果您安装 KubeSphere)。有关更多信息,请参见示例配置文件

准备好配置文件后,您需要使用 ./kk 命令以及不同的标志来进行不同的操作。这之后,KubeKey 会自动安装 Docker,并拉取所有必要的镜像以进行安装。安装完成后,您还可以检查安装日志。

为什么选择 KubeKey

  • 以前基于 ansible 的安装程序依赖于许多软件,例如 Python。KubeKey 由 Go 语言开发,可以消除在多种环境中出现的问题,确保成功安装。
  • KubeKey 支持多种安装选项,例如 All-in-One多节点安装以及离线安装
  • KubeKey 使用 Kubeadm 在节点上尽可能多地并行安装 Kubernetes 集群,使安装更简便,提高效率。与旧版的安装程序相比,它极大地节省了安装时间。
  • KubeKey 旨在将群集作为对象来进行安装,即 CaaO。

下载 KubeKey

从 GitHub Release Page 下载 KubeKey 或者直接运行以下命令。

curl -sfL https://get-kk.kubesphere.io | VERSION=v1.0.1 sh -

备注

通过以上的命令,可以下载 KubeKey 的最新版本 (v1.0.1)。您可以更改命令中的版本号来下载特定的版本。

支持的环境

Linux 发行版

  • Ubuntu 16.04, 18.04
  • Debian Buster, Stretch
  • CentOS/RHEL 7
  • SUSE Linux Enterprise Server 15

Kubernetes 版本

  • v1.15:   v1.15.12
  • v1.16:   v1.16.13
  • v1.17:   v1.17.9 (默认)
  • v1.18:   v1.18.6

查看更多支持的版本点击这里

注意: KubeSphere目前暂不支持运行在k8s 1.19.x之上。

要求和建议

  • 最低资源要求(仅对于最小安装 KubeSphere):
    • 2 核虚拟 CPU
    • 4 GB 内存
    • 20 GB 储存空间

/var/lib/docker 主要用于存储容器数据,在使用和操作过程中会逐渐增大。对于生产环境,建议 /var/lib/docker 单独挂盘。

  • 操作系统要求:
    • SSH 可以访问所有节点。
    • 所有节点的时间同步。
    • sudo/curl/openssl 应在所有节点使用。
    • docker 可以自己安装,也可以通过 KubeKey 安装。
    • Red Hat 在其 Linux 发行版本中包括了SELinux,建议关闭SELinux或者将SELinux的模式切换为Permissive[宽容]工作模式
  • 建议您的操作系统环境足够干净 (不安装任何其他软件),否则可能会发生冲突。
  • 如果在从 dockerhub.io 下载镜像时遇到问题,建议准备一个容器镜像仓库 (加速器)。为 Docker 守护程序配置镜像加速
  • 默认情况下,KubeKey 将安装 OpenEBS 来为开发和测试环境配置 LocalPV,这对新用户来说非常方便。对于生产,请使用 NFS/Ceph/GlusterFS 或商业化存储作为持久化存储,并在所有节点中安装相关的客户端 。
  • 如果遇到拷贝时报权限问题Permission denied,建议优先考虑查看SELinux的原因
  • 依赖要求:

KubeKey 可以同时安装 Kubernetes 和 KubeSphere。根据 KubeSphere 所安装版本的不同,您所需要安装的依赖可能也不同。请参考以下表格查看您是否需要提前在节点上安装有关的依赖。

  Kubernetes 版本 ≥ 1.18 Kubernetes 版本 < 1.18
socat 必须安装 可选,但推荐安装
conntrack 必须安装 可选,但推荐安装
ebtables 可选,但推荐安装 可选,但推荐安装
ipset 可选,但推荐安装 可选,但推荐安装
  • 网络和 DNS 要求:
    • 确保 /etc/resolv.conf 中的 DNS 地址可用。否则,可能会导致群集中出现某些 DNS 问题。
    • 如果您的网络配置使用防火墙或安全组,则必须确保基础结构组件可以通过特定端口相互通信。建议您关闭防火墙或遵循链接配置:网络访问

用法

获取安装程序可执行文件

  • 下载KubeKey可执行文件 Releases page

    下载解压后可直接使用。

  • 从源代码生成二进制文件

    git clone https://github.com/kubesphere/kubekey.git
    cd kubekey
    ./build.sh

注意:

  • 在构建之前,需要先安装 Docker。
  • 如果无法访问 https://proxy.golang.org/,比如在大陆,请执行 build.sh -p

创建集群

快速开始

快速入门使用 all-in-one 安装,这是熟悉 KubeSphere 的良好开始。

命令

./kk create cluster [--with-kubernetes version] [--with-kubesphere version]

例子

  • 使用默认版本创建一个纯 Kubernetes 集群

    ./kk create cluster
  • 创建指定一个(支持的版本)的 Kubernetes 集群

    ./kk create cluster --with-kubernetes v1.17.9
  • 创建一个部署了 KubeSphere 的 Kubernetes 集群 (例如 --with-kubesphere v3.0.0

    ./kk create cluster --with-kubesphere [version]

高级用法

您可以使用高级安装来控制自定义参数或创建多节点群集。具体来说,通过指定配置文件来创建集群。

  1. 首先,创建一个示例配置文件

    ./kk create config [--with-kubernetes version] [--with-kubesphere version] [(-f | --file) path]

    例子:

    • 使用默认配置创建一个示例配置文件。您也可以指定文件名称或文件所在的文件夹。

      ./kk create config [-f ~/myfolder/config-sample.yaml]
    • 同时安装 KubeSphere

      ./kk create config --with-kubesphere
  2. 根据您的环境修改配置文件 config-sample.yaml

当指定安装KubeSphere时,要求集群中有可用的持久化存储。默认使用localVolume,如果需要使用其他持久化存储,请参阅 addons 配置。

  1. 使用配置文件创建集群。

    ./kk create cluster -f ~/myfolder/config-sample.yaml

启用多集群管理

默认情况下,Kubekey 将仅安装一个 Solo 模式的单集群,即未开启 Kubernetes 多集群联邦。如果您希望将 KubeSphere 作为一个支持多集群集中管理的中央面板,您需要在 config-example.yaml 中设置 ClusterRole。关于多集群的使用文档,请参考 如何启用多集群

开启可插拔功能组件

KubeSphere 从 2.1.0 版本开始对 Installer 的各功能组件进行了解耦,快速安装将默认仅开启最小化安装(Minimal Installation),Installer 支持在安装前或安装后自定义可插拔的功能组件的安装。使最小化安装更快速轻量且资源占用更少,也方便不同用户按需选择安装不同的功能组件。

KubeSphere 有多个可插拔功能组件,功能组件的介绍可参考 配置示例。您可以根据需求,选择开启安装 KubeSphere 的可插拔功能组件。我们非常建议您开启这些功能组件来体验 KubeSphere 完整的功能以及端到端的解决方案。请在安装前确保您的机器有足够的 CPU 与内存资源。开启可插拔功能组件可参考 开启可选功能组件

添加节点

将新节点的信息添加到群集配置文件,然后应用更改。

./kk add nodes -f config-sample.yaml

删除节点

通过以下命令删除节点,nodename指需要删除的节点名。

./kk delete node <nodeName> -f config-sample.yaml

删除集群

您可以通过以下命令删除集群:

  • 如果您以快速入门(all-in-one)开始:
./kk delete cluster
  • 如果从高级安装开始(使用配置文件创建的集群):
./kk delete cluster [-f config-sample.yaml]

集群升级

单节点集群

升级集群到指定版本。

./kk upgrade [--with-kubernetes version] [--with-kubesphere version] 
  • --with-kubernetes 指定kubernetes目标版本。
  • --with-kubesphere 指定kubesphere目标版本。

多节点集群

通过指定配置文件对集群进行升级。

./kk upgrade [--with-kubernetes version] [--with-kubesphere version] [(-f | --file) path]
  • --with-kubernetes 指定kubernetes目标版本。
  • --with-kubesphere 指定kubesphere目标版本。
  • -f 指定集群安装时创建的配置文件。

注意: 升级多节点集群需要指定配置文件. 如果集群非kubekey创建,或者创建集群时生成的配置文件丢失,需要重新生成配置文件,或使用以下方法生成。

Getting cluster info and generating kubekey's configuration file (optional).

./kk create config [--from-cluster] [(-f | --file) path] [--kubeconfig path]
  • --from-cluster 根据已存在集群信息生成配置文件.
  • -f 指定生成配置文件路径.
  • --kubeconfig 指定集群kubeconfig文件.
  • 由于无法全面获取集群配置,生成配置文件后,请根据集群实际信息补全配置文件。

启用 kubectl 自动补全

KubeKey 不会启用 kubectl 自动补全功能。请参阅下面的指南并将其打开:

先决条件:确保已安装 bash-autocompletion 并可以正常工作。

# 安装 bash-completion
apt-get install bash-completion

# 将 completion 脚本添加到你的 ~/.bashrc 文件
echo 'source <(kubectl completion bash)' >>~/.bashrc

# 将 completion 脚本添加到 /etc/bash_completion.d 目录
kubectl completion bash >/etc/bash_completion.d/kubectl

更详细的参考可以在这里找到。

相关文档

展开阅读全文

代码

的 Gitee 指数为
超过 的项目

评论 (0)

加载中
更多评论
暂无内容
发表了博客
02/06 08:21

使用kubekey安装kubesphere

下载 KubeKey KubeKey 是新一代 Kubernetes 和 KubeSphere 安装器,可帮助您以简单、快速、灵活的方式安装 Kubernetes 和 KubeSphere。 export KKZONE=cn curl -sfL https://get-kk.kubesphere.io | VERSION=v1.0.1 sh - 准备镜像 如果您想让安装加快或者您的机房没有外网,可以使用公司内部的私有仓库,预先把镜像推送到私有仓库中,我这里的仓库使用harbor 下载离线安装工具,我这里只是用这个脚本来下载和推送镜像 curl -L ...

0
0
发表了博客
02/06 08:22

使用kubekey安装kubesphere

下载 KubeKey KubeKey 是新一代 Kubernetes 和 KubeSphere 安装器,可帮助您以简单、快速、灵活的方式安装 Kubernetes 和 KubeSphere。 export KKZONE=cn curl -sfL https://get-kk.kubesphere.io | VERSION=v1.0.1 sh - 准备镜像 如果您想让安装加快或者您的机房没有外网,可以使用公司内部的私有仓库,预先把镜像推送到私有仓库中,我这里的仓库使用harbor 下载离线安装工具,我这里只是用这个脚本来下载和推送镜像 curl -L ...

0
0
发表于云计算专区
2020/12/09 18:17

Docker出局?你还有iSula、Containerd和CRI-O

❝ 12 月 19 日,KubeSphere 开源社区联合 CNCF 将在北京举办一场年度的云原生 Meetup,聚焦用户落地实践的干货分享,以及现场动手实践的 Workshop 和闪电演讲,现场有来自 AWS、中通、微众银行的多位重量级讲师进行分享,欢迎大家点击文末的「阅读原文」或扫描二维码免费报名 Meetup!❞ Docker 真的要被 Kubernetes 社区剔除了吗? 最近,Kubernetes 在 1.20 版本中 的 ChangeLog 提到将在未来的版本中废弃 Docker 作为容器运...

0
0
2020/09/01 09:23

KubeSphere 3.0.0 GA:面向应用的容器混合云

2020 年 8 月 31 日,KubeSphere 开源社区官方宣布 KubeSphere 3.0.0 GA 正式发布!KubeSphere 3.0.0 主打 “面向应用的容器混合云”,专为 「多云、多集群、多团队、多租户」 应用场景而设计,大幅增强了 「集群管理、可观察性、存储管理、网络管理、多租户安全、应用商店、安装部署」 等特性,并且进一步提升了交互设计与用户体验,KubeSphere 3.0.0 是 KubeSphere 至今为止最重要的版本更新。作为多云与多集群的统一控制平面...

0
0
发表于DevOps专区
2020/08/31 21:46

KubeSphere 3.0.0 GA:面向应用的容器混合云

2020 年 8 月 31 日,KubeSphere 开源社区官方宣布 KubeSphere 3.0.0 GA 正式发布!KubeSphere 3.0.0 主打 “面向应用的容器混合云”,专为 「多云、多集群、多团队、多租户」 应用场景而设计,大幅增强了 「集群管理、可观察性、存储管理、网络管理、多租户安全、应用商店、安装部署」 等特性,并且进一步提升了交互设计与用户体验,KubeSphere 3.0.0 是 KubeSphere 至今为止最重要的版本更新。作为多云与多集群的统一控制平面...

0
0
2020/09/30 11:34

使用 Sealos + Longhorn 部署 KubeSphere v3.0.0

本文来自 KubeSphere 社区用户 Will,演示如何使用 Sealos + Longhorn 部署一个带有持久化存储的 Kubernetes 集群,然后使用 ks-installer 在该集群上部署 KubeSphere 3.0.0。这是一篇最适合小白初次上手的 KubeSphere 3.0.0 快速部署和体验的文章🚀。 Sealos 简介 Sealos (https://sealyun.com/),只能用丝滑一词形容的 Kubernetes 高可用安装工具,一条命令,离线安装,包含所有依赖,内核负载不依赖 haproxy keepalived,纯...

0
0
发表于DevOps专区
2020/09/29 23:50

使用 Sealos + Longhorn 部署 KubeSphere v3.0.0

本文来自 KubeSphere 社区用户 Will,演示如何使用 Sealos + Longhorn 部署一个带有持久化存储的 Kubernetes 集群,然后使用 ks-installer 在该集群上部署 KubeSphere 3.0.0。这是一篇最适合小白初次上手的 KubeSphere 3.0.0 快速部署和体验的文章🚀。 Sealos 简介 Sealos (https://sealyun.com/),只能用丝滑一词形容的 Kubernetes 高可用安装工具,一条命令,离线安装,包含所有依赖,内核负载不依赖 haproxy keepalived,纯...

0
0
发表于DevOps专区
2020/11/19 17:21

KubeSphere 在直播电商行业 “双十一”的混合云实践

主营业务 杭州遥望网络(https://www.ywwl.com/)成立于 2010 年 11 月,2018 年与上市公司星期六并购,并成为头部 MCN 机构;2019 年连续 5 个月成为快手 MCN 第一名;在多平台 MCN 机构排名中均名列前茅;2020 年双 11 期间,直播电商 GMV 达 13.22 亿人民币。 公司技术情况 公司在十余年的发展中,一直是业务导向,技术拆分成小组,不同业务组管理自己的服务及服务器,公司整体缺乏Devops的理念和 Cloud Native 的基因;另一...

0
0
发表了博客
2020/07/01 10:36

The Overview of KubeSphere 3.0

在 KubeSphere 3.0 里我们完成了很多对企业用户重要的特性,本文将从基础设置、运维、应用开发与管理、生态及混合云场景等多个层面给大家带来分享,也欢迎大家使用并反馈。 数字化转型的核心是快速向市场交付产品、服务和价值,一套能够承载企业核心应用敏捷开发和灵活运营的基础架构至关重要。混合云使企业在基础架构的敏捷性和可靠性、经济性和安全性之间得到平衡,成为越来越多企业数字化转型基础设施的选择。 2020 Flexera...

0
0
发表于开源治理专区
2020/10/07 11:16

使用Sealos + Longhorn部署KubeSphere v3.0.0

本文来自 KubeSphere 社区用户 Will,演示如何使用 Sealos + Longhorn 部署一个带有持久化存储的 Kubernetes 集群,然后使用 ks-installer 在该集群上部署 KubeSphere 3.0.0。这是一篇最适合小白初次上手的 KubeSphere 3.0.0 快速部署和体验的文章🚀。 Sealos 简介 Sealos (https://sealyun.com/),只能用丝滑一词形容的 Kubernetes 高可用安装工具,一条命令,离线安装,包含所有依赖,内核负载不依赖 haproxy keepalived,纯...

0
2
没有更多内容
加载失败,请刷新页面
点击加载更多
加载中
下一页
暂无内容
0 评论
3 收藏
分享
OSCHINA
登录后可查看更多优质内容
返回顶部
顶部