Skip to main content

功能介绍

什么是 AutoK3s#

K3s 是经过完全认证的 Kubernetes 产品,在某些情况下可以替代完整的 K8s。

AutoK3s 是用于简化 K3s 集群管理的轻量级工具,您可以使用 AutoK3s 在任何地方运行 K3s 服务。

AutoK3s 是一款开源的工具,如果您需要提交产品需求,或者是在使用过程中遇到任何问题或,请访问 AutoK3s-GitHub 网站,创建 Issue 并描述您的需求或问题,我们会尽快回复。如果您喜欢这款工具,请一键三连( Watch、star 和 fork )!

关键特性#

  • 通过 API、CLI 和 UI 等方式快速创建 K3s。
  • 云提供商集成(简化 CCM 设置)。
  • 灵活安装选项,例如 K3s 集群 HA 和数据存储(内置 etcd、RDS、SQLite 等)。
  • 低成本(尝试云中的竞价实例)。
  • 通过 UI 简化操作。
  • 多云之间弹性迁移,借助诸如 backup-restore-operator 这样的工具进行弹性迁移。

云提供商#

AutoK3s 可以支持以下云厂商,我们会根据社区反馈添加更多支持:

  • 阿里云 - 在阿里云的 ECS 中初始化 K3s 集群
  • AWS - 在亚马逊 EC2 中初始化 K3s 集群
  • 腾讯云 - 在腾讯云 CVM 中初始化 K3s 集群
  • Native - 在任意类型 VM 实例中初始化 K3s 集群

快速体验#

您可以通过以下 Docker 命令,一键启动 AutoK3s 本地 UI,快速体验相关功能。

docker run -itd --restart=unless-stopped -p 8080:8080 cnrancher/autok3s:v0.4.2

如果您是 MacOS 或者 Linux 系统,您也可以使用以下安装命令,一键安装 AutoK3s(Windows用户请前往 Releases 页面下载对应的程序)。

curl -sS http://rancher-mirror.cnrancher.com/autok3s/install.sh | INSTALL_AUTOK3S_MIRROR=cn sh

您可以通过以下 CLI 命令启动本地 UI。

autok3s serve

您也可以通过以下 CLI 在 AWS EC2 快速创建一个 1 master, 1 worker 节点的 K3s 集群。

export AWS_ACCESS_KEY_ID='<Your access key ID>'
export AWS_SECRET_ACCESS_KEY='<Your secret access key>'
autok3s -d create -p aws --name myk3s --master 1 --worker 1

使用指南#

AutoK3s 有两种运行模式:

  • Local Mode: 在 Local Mode 模式下,您可以使用 CLI 或本地 UI 运行 AutoK3s。
  • [开发中] Rancher Mode: 在这种模式下,您可以将 AutoK3s 集成到 Rancher 中,它将作为 Rancher 的扩展插件,使您可以构建一套托管 K3s 服务,通过 AutoK3s 创建的 K3s 集群可以自动导入 Rancher,并充分利用 Rancher 的 Kubernetes 管理功能。

演示视频#

在以下演示中,我们将在 1 分钟左右的时间内把 K3s 安装到 AWS EC2 云主机上。

观看演示:

升级#

如果您使用 Docker 命令一键启动 AutoK3s 本地 UI,从 v0.4.0 升级到 v0.4.2 需要进行如下操作以保证历史数据的迁移。

docker cp <old-container>:/root/.autok3s .
docker rm -f <old-container>
docker run -itd --restart=unless-stopped -p 8080:8080 -v $PWD/.autok3s:/root/.autok3s cnrancher/autok3s:v0.4.2

v0.4.1 以后的版本,可以直接通过 --volumes-from 来保证历史数据的迁移。

docker stop <old-container>
docker run -itd --restart=unless-stopped -p 8080:8080 --volumes-from <old-container> cnrancher/autok3s:v0.4.2

开发者指南#

使用 Makefile 管理项目的编译、测试与打包。

  • 编译: make autok3s build
  • 测试: make autok3s unit
  • 打包: make autok3s package only

使用 dapper 管理项目的编译、测试与打包

  • 编译: BY=dapper make autok3s build
  • 测试: BY=dapper make autok3s unit
  • 打包: BY=dapper make autok3s package only

请参考dapper项目来安装 dapper

Last updated on by JacieChao