功能介绍

什么是 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