快速开始
本指南将帮助你用默认选项快速启动一个集群。
刚接触 Kubernetes?Kubernetes 官方文档已经有一些很好的教程,这里概述了基础知识。
#
先决条件请确保你的环境满足要求。如果在主机上安装并启用了 NetworkManager,确保它被配置为忽略 CNI 管理的接口。
对于 1.21 及以上的 RKE2 版本,如果主机内核支持AppArmor,那么在安装 RKE2 之前,AppArmor 工具(通常通过
apparmor-parser
包获得)也必须存在。RKE2 安装过程必须以 root 用户或通过
sudo
运行。
#
Server 节点安装RKE2 提供了一个安装脚本,这是一个在基于 systemd 的系统上将其作为服务安装的便捷方式。这个脚本可以从 https://get.rke2.io 获得。要使用此方法安装 RKE2,请执行以下操作:
#
1. 运行安装程序提示
国内用户,可以使用以下方法加速安装:
这将在你的机器上安装 rke2-server
服务和 rke2
二进制文件。需要注意的是,除非以 root 用户身份或通过 sudo
运行,否则会失败。
#
2. 启用 rke2-server 服务#
3. 启动服务#
4. 如果你愿意,可以关注一下日志运行此安装程序后:
rke2-server
服务将被安装。rke2-server
服务将被配置为在节点重启后或进程崩溃或被杀时自动重启。- 其他的实用程序将被安装在
/var/lib/rancher/rke2/bin/
。它们包括kubectl
,crictl
, 和ctr
. 注意,这些东西默认不在你的路径上。 - 还有两个清理脚本会安装到
/usr/local/bin/rke2
的路径上。它们是rke2-killall.sh
和rke2-uninstall.sh
。 - 一个 kubeconfig 文件将被写入
/etc/rancher/rke2/rke2.yaml
。 - 一个可用于注册其他 server 或 agent 节点的令牌将在
/var/lib/rancher/rke2/server/node-token
文件中创建。
注意:
如果你要添加额外的 server 节点,则总数必须为奇数。需要奇数来维持选举数。更多细节请参见高可用文档 。
#
Linux Agent(Worker)节点的安装本节中的步骤需要 root 级别访问权限或 sudo
才能工作。
#
1. 运行安装程序提示
国内用户,可以使用以下方法加速安装:
这将在你的机器上安装 rke2-agent
服务和 rke2
二进制文件。
#
2. 启用 rke2-agent 服务#
3. 配置 rke2-agent 服务config.yaml 的内容。
注意:
rke2 server
进程通过端口 9345
监听新节点的注册。正常情况下,Kubernetes API 仍可在端口 6443 上使用。
#
4. 启动服务如果你愿意,可以关注一下日志。
注意:
每台机器必须有一个唯一的主机名。如果你的机器没有唯一的主机名,请在 config.yaml
文件中设置 node-name
参数,并为每个节点提供一个有效和唯一的主机名。
要阅读更多关于 config.yaml 文件的信息,请参见安装选项文档。
#
Windows Agent(Worker)节点的安装从 v1.21.3+rke2r1 开始,Windows 支持目前是实验性的。Windows 支持需要选择 Calico 作为 RKE2 集群的 CNI。
#
1. 准备好 Windows Agent 节点注意:需要启用 Windows Server Containers,以便 RKE2 agent 工作。
以管理员权限打开一个新的 Powershell 窗口
在新的 Powershell 窗口中,运行以下命令。
这将需要重新启动以使 Containers
功能正常运行。
#
2. 下载安装脚本这个脚本将下载 Windows 二进制文件 rke2.exe
到你的机器上。
#
3. 为 Windows 配置 rke2-agent要阅读更多关于 config.yaml 文件的信息,请参见安装选项文档。
#
4. 配置 PATH#
5. 运行安装程序#
6. 启动 Windows RKE2 服务注意:每台机器必须有一个唯一的主机名。
如果你希望只使用 CLI 参数,请使用所需参数运行二进制文件。