创建阿里云集群
概述#
本文介绍了如何在阿里云 ECS 中创建和初始化 K3s 集群，以及为已有的 K3s 集群添加节点的操作步骤。除此之外，本文还提供了在阿里云 ECS 上运行 AutoK3s 的进阶操作指导，如配置私有镜像仓库、启用阿里云 Terway CNI、启用阿里云 CCM、和启用 UI 组件。
前置要求#
设置 RAM#
关于 RAM 的描述，请参考阿里云官方文档。
您的账号需要创建 ECS 及相关资源的权限，因此需要确保具有以下资源的权限：
设置安全组#
ECS 实例至少需要应用以下安全组规则：
UI 使用说明#
接下来我们将基于 AutoK3s 本地 UI 介绍如何使用 AutoK3s 工具，在 AWS EC2 主机上创建和管理 K3s 集群。如果您想了解 CLI 的使用，请移步到 CLI 使用说明
您可以通过快速体验中的描述，通过 Docker 或者 CLI 启动本地 UI，打开浏览器，访问目标端口 8080 即可。
快速创建集群#
您可以使用快速创建功能，在指定的云提供商服务中，快速启动一个K3s集群。
以下图为例，我们将在 aliyun ECS 使用默认配置创建一个单节点的 K3s 集群，ECS 虚拟机会在 cn-hangzhou 区域中创建。
表 1：快速创建参数
| 参数 | 说明 | 默认值 |
|---|---|---|
| Provider | 云提供商名称 | alibaba |
| Name | K3s集群名称 | |
| Master | Master 节点数量 | 1 |
| Worker | Worker 节点数量 | 0 |
| Access Key | 云提供商的Access Key 访问密钥 | |
| Secret Key | 云提供商的Secret Key 访问密钥 | |
| Region | 虚拟机所在的区域（在快速创建页面不允许编辑默认区域，您可以通过模板功能修改默认参数配置） | cn-hangzhou |
| Zone | 虚拟机所在的地区 | cn-hangzhou-i |
自定义参数创建#
如果您不想使用默认的配置，可以点击 Advance 按钮，进入自定义参数页面进行更多参数的设置。 或者您可以在集群列表页点击 Create 按钮进入自定义参数页面进行更多参数的设置。
使用 Alibaba 云提供商创建 K3s 集群的自定义参数配置分为四项，云供应商访问凭证、云提供商对应实例配置、K3s集群配置、高级选项。接下来对每个配置项进行详细说明。
云提供商访问凭证#
表 2：云提供商访问凭证参数
| 参数 | 说明 |
|---|---|
| Provider | 云提供商名称 |
| Name | K3s集群名称 |
| Access Key | 云提供商的Access Key 访问密钥 |
| Secret Secret | 云提供商的Secret Key 访问密钥 |
实例配置#
实例配置主要配置的内容为对应云提供商虚拟机的配置，例如实例运行区域、地区、使用的操作系统类型、实例规格、网络配置等信息。
表 3：实例配置参数
| 参数 | 说明 | 默认值 |
|---|---|---|
| Region | 阿里云 ECS 区域 | cn-hangzhou |
| Zone | 阿里云 ECS 地区 | cn-hangzhou-i |
| Instance Type | 阿里云 ECS 实例规格 | ecs.c6.large(2vCPU/4GiB) |
| Image | 阿里云 ECS 系统映像ID | ubuntu_18_04_x64_20G_alibase_20200618.vhd(Ubuntu 18.04) |
| Disk Category | 根磁盘卷类型 | cloud_ssd |
| Disk Size | 根磁盘卷大小 | 40(GiB) |
| V-Switch | 专有网络交换机 ID (如果您不设置，AutoK3s 将为您创建名称为 autok3s-aliyun-vswitch 的默认交换机) | |
| Internet Max Bandwidth Out | 网络带宽 | 5(MB) |
| Security Group | 安全组(如果您不选择任何安全组，AutoK3s 将为您自动创建名称为 autok3s 的默认的安全组) | |
| EIP | 是否使用弹性公网IP | false |
| Key Pair | 密钥对名称(如果您不设置密钥对，AutoK3s 将自动为您生成一个密钥对) | |
| SSH User | SSH 用户 | root |
| SSH Port | SSH 端口 | 22 |
| SSH Key Path | 如果您选择了已有的密钥对，需要指定SSH 私钥目录，如果您使用AutoK3s 自动生成的密钥，这里可以不填写任何内容 | |
| SSH Key Passphrase | 如果您的私钥需要密码验证，请在这里输入密码 | |
| SSH Password | 如果您使用Password连接到虚拟机，请输入密码 | |
| SSH Agent Auth | 如果您配置 SSH 代理程序，可以开启此项配置 | false |
| SSH Cert Path | 如果您配置了 ssh certificate，在这里您需要将 certificate path 传入进来，以保证 AutoK3s 可以通过ssh连接到远程虚拟机 | |
| Tags | 虚拟机标签 |
K3s 参数配置#
K3s 参数配置项主要对 K3s 集群进行设置，例如是否部署 HA 模式、K3s 安装版本等。
表 4：K3s 配置参数
| 参数 | 说明 | 默认值 |
|---|---|---|
| K3s Channel | 用于获取 K3s 下载 URL 的通道。选项包括：stable, latest, testing。 | stable |
| K3s Version | 安装的 K3s 版本，如果设置则覆盖 Channel 选项 | |
| Cluster | 启用嵌入式 DB 高可用 K3s（即开启 --cluster-init 设置） | false |
| Datastore | 指定 etcd、Mysql、Postgres 或 Sqlite（默认）数据源名称 | |
| K3s Install Script | K3s 安装脚本 | http://rancher-mirror.cnrancher.com/k3s/k3s-install.sh |
| Master | Master 节点数量 | |
| Master Extra Args | Master 节点额外参数设置，例如 --no-deploy traefik | |
| Worker | Worker 节点数量 | |
| Worker Extra Args | Worker 节点额外参数设置，例如 --node-taint key=value:NoExecute | |
| IP | K3s server IP，用于加入已有集群 | |
| Token | 用于将server或agent加入集群的共享secret，如果不设置，会自动生成一个Token | |
| Registry | 私有镜像仓库配置 |
高级选项#
配置是否开启 UI（kubernetes-dashboard），是否部署 Terway 网络插件以及是否部署阿里云 Cloud Provider。
表 4：高级选项
| 参数 | 说明 | 默认值 |
|---|---|---|
| UI | 是否部署 Kubernetes Dashboard | false |
| Cloud Controller Manager | 是否部署阿里云 Cloud Provider | false |
| Terway | 是否部署 Terway 网络插件 | false |
| Terway Max Pool Size | Terway Max Pool Size | 5 |
PS: AutoK3s 默认部署
ENI模式的 Terway 插件，更多信息请参考这里
集群模板#
您可以使用模板功能，提前预置好常用的集群模板，每次创建集群时可以用模板参数进行填充，极大精简了重复操作。一次编写，多次运行，提升效率。
创建集群模板的参数与上面描述的自定义参数创建集群的表单内容相同，在这里不做赘述。
您可以选择最常用的模板，点击右侧下拉框中的 Set Default 按钮，将模板设置为默认模板。
设置为默认模板后，您可以通过快速创建功能一键部署常用配置的 K3s 集群。
如果您想使用其他模板创建集群，您还可以在快速创建页面的右上角，或者在自定义创建集群的右上角筛选模板，点击 Fill Form 按钮后，会自动根据模板内容填充表单。
集群管理#
您可以在集群列表页查看和管理使用 AutoK3s 创建的 K3s 集群。
添加节点#
选中您要添加节点的集群，点击右侧下拉菜单中的 Join Node 按钮，在弹出的窗口中设置要添加的节点数量即可。
Kubectl#
如果您想操作 K3s 集群数据，可以点击右上角 Launch Kubectl 按钮，在下拉框中选择要操作的集群后，便可以在 UI 控制台操作选中的集群了。
SSH#
如果您想连接到远程主机进行操作，您可以在集群列表页面点击集群名称，进入详情页面，选择要连接的主机，点击右侧 Execute Shell 按钮。
CLI 使用说明#
在使用命令之前，您需要设置访问凭证。
如想了解更多参数，请运行autok3s <sub-command> --provider alibaba --help命令。
创建普通集群#
运行以下命令，在阿里云 ECS 上创建并启动创建一个名为 “myk3s”的集群，并为该集群配置 1 个 master 节点和 1 个 worker 节点。
创建高可用 K3s 集群#
创建高可用集群的命令分为两种，取决于您选择使用的是内置的 etcd 还是外部数据库。
嵌入式 etcd（k3s 版本 >= 1.19.1-k3s1)#
运行以下命令，在阿里云 ECS 上创建并启动创建了一个名为“myk3s”的高可用 K3s 集群。
外部数据库#
在高可用模式下使用外部数据库，需要满足两个条件：
- master 节点的数量不小于 1。
- 需要提供外部数据库的存储路径。
所以在以下的代码示例中，我们通过--master 2指定 master 节点数量为 2，满足 master 节点的数量不小于 1 这个条件；且通过--datastore "PATH"指定外部数据库的存储路径，提供外部数据库的存储路径。
运行以下命令，在阿里云 ECS 上创建并启动创建了一个名为“myk3s”的高可用 K3s 集群：
添加 K3s 节点#
请使用autok3s join命令为已有集群添加 K3s 节点。
普通集群#
运行以下命令，为“myk3s”集群添加 1 个 worker 节点。
高可用 K3s 集群#
删除 K3s 集群#
删除一个 k3s 集群，这里删除的集群为 myk3s。
查看集群列表#
显示当前主机上管理的所有 K3s 集群列表。
查看集群详细信息#
显示具体的 K3s 信息，包括实例状态、主机 ip、集群版本等信息。
注意
如果使用不同的 provider 创建的集群名称相同，describe 时会显示多个集群信息，可以使用-p <provider>对 provider 进一步过滤。例如：autok3s describe -n myk3s -p alibaba。
Kubectl#
集群创建完成后, autok3s 会自动合并 kubeconfig 文件。
在多个集群的场景下，可以通过切换上下文来完成对不同集群的访问。
SSH#
SSH 连接到集群中的某个主机，这里选择的集群为 myk3s。
进阶使用#
AutoK3s 集成了一些与当前 provider 有关的高级组件，例如私有镜像仓库、Terway、CCM 和 UI。
配置私有镜像仓库#
在运行autok3s create或autok3s join时，您可以通过传递--registry /etc/autok3s/registries.yaml以使用私有镜像仓库，例如：
使用私有镜像仓库的配置请参考以下内容，如果您的私有镜像仓库需要 TLS 认证，autok3s会从本地读取相关的 TLS 文件并自动上传到远程服务器中完成配置，您只需要编辑registry.yaml即可。
启用阿里云 Terway CNI 插件#
实例的类型决定了 K3S 集群可以分配给集群 POD 的 EIP 数量，更多详细信息请参见这里。
启用阿里云 CCM(Cloud Controller Manager)#
更多关于 Aliyun Cloud Provider 信息，请参考Cloud Provider 帮助文档（中文版）。
启用 UI 组件#
该参数会启用 kubernetes/dashboard 图形界面。 访问 Token 等设置请参考 此文档 。