Skip to main content

快速开始

本指南将帮助你用默认选项快速启动一个集群。

刚接触 Kubernetes?Kubernetes 官方文档已经有一些很好的教程,这里概述了基础知识。

先决条件#

  • 请确保你的环境满足要求。如果在主机上安装并启用了 NetworkManager,确保它被配置为忽略 CNI 管理的接口

  • 对于 1.21 及以上的 RKE2 版本,如果主机内核支持AppArmor,那么在安装 RKE2 之前,AppArmor 工具(通常通过apparmor-parser包获得)也必须存在。

  • RKE2 安装过程必须以 root 用户或通过 sudo 运行。

Server 节点安装#

RKE2 提供了一个安装脚本,这是一个在基于 systemd 的系统上将其作为服务安装的便捷方式。这个脚本可以从 https://get.rke2.io 获得。要使用此方法安装 RKE2,请执行以下操作:

1. 运行安装程序#

curl -sfL https://get.rke2.io | sh -
提示

国内用户,可以使用以下方法加速安装:

curl -sfL https://rancher-mirror.rancher.cn/rke2/install.sh | INSTALL_RKE2_MIRROR=cn sh -

这将在你的机器上安装 rke2-server 服务和 rke2 二进制文件。需要注意的是,除非以 root 用户身份或通过 sudo 运行,否则会失败。

2. 启用 rke2-server 服务#

systemctl enable rke2-server.service

3. 启动服务#

systemctl start rke2-server.service

4. 如果你愿意,可以关注一下日志#

journalctl -u rke2-server -f

运行此安装程序后:

  • rke2-server 服务将被安装。rke2-server 服务将被配置为在节点重启后或进程崩溃或被杀时自动重启。
  • 其他的实用程序将被安装在/var/lib/rancher/rke2/bin/。它们包括 kubectl, crictl, 和 ctr. 注意,这些东西默认不在你的路径上。
  • 还有两个清理脚本会安装到 /usr/local/bin/rke2 的路径上。它们是 rke2-killall.shrke2-uninstall.sh
  • 一个 kubeconfig 文件将被写入/etc/rancher/rke2/rke2.yaml
  • 一个可用于注册其他 server 或 agent 节点的令牌将在 /var/lib/rancher/rke2/server/node-token 文件中创建。
注意:

如果你要添加额外的 server 节点,则总数必须为奇数。需要奇数来维持选举数。更多细节请参见高可用文档

Linux Agent(Worker)节点的安装#

本节中的步骤需要 root 级别访问权限或 sudo 才能工作。

1. 运行安装程序#

curl -sfL https://get.rke2.io | INSTALL_RKE2_TYPE="agent" sh -
提示

国内用户,可以使用以下方法加速安装:

curl -sfL https://rancher-mirror.rancher.cn/rke2/install.sh | INSTALL_RKE2_MIRROR=cn INSTALL_RKE2_TYPE="agent" sh -

这将在你的机器上安装 rke2-agent 服务和 rke2 二进制文件。

2. 启用 rke2-agent 服务#

systemctl enable rke2-agent.service

3. 配置 rke2-agent 服务#

mkdir -p /etc/rancher/rke2/
vim /etc/rancher/rke2/config.yaml

config.yaml 的内容。

server: https://<server>:9345
token: <token from server node>
注意:

rke2 server 进程通过端口 9345 监听新节点的注册。正常情况下,Kubernetes API 仍可在端口 6443 上使用。

4. 启动服务#

systemctl start rke2-agent.service

如果你愿意,可以关注一下日志

journalctl -u rke2-agent -f
注意:

每台机器必须有一个唯一的主机名。如果你的机器没有唯一的主机名,请在 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 -Command "Start-Process PowerShell -Verb RunAs"

在新的 Powershell 窗口中,运行以下命令。

Enable-WindowsOptionalFeature -Online -FeatureName containers –All

这将需要重新启动以使 Containers 功能正常运行。

2. 下载安装脚本#

Invoke-WebRequest -Uri https://raw.githubusercontent.com/rancher/rke2/master/install.ps1 -Outfile install.ps1

这个脚本将下载 Windows 二进制文件 rke2.exe 到你的机器上。

3. 为 Windows 配置 rke2-agent#

New-Item -Type Directory c:/etc/rancher/rke2 -Force
Set-Content -Path c:/etc/rancher/rke2/config.yaml -Value @"
server: https://<server>:9345
token: <token from server node>
"@

要阅读更多关于 config.yaml 文件的信息,请参见安装选项文档。

4. 配置 PATH#

$env:PATH+=";c:\var\lib\rancher\rke2\bin;c:\usr\local\bin"
[Environment]::SetEnvironmentVariable(
"Path",
[Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + ";c:\var\lib\rancher\rke2\bin;c:\usr\local\bin",
[EnvironmentVariableTarget]::Machine)

5. 运行安装程序#

./install.ps1

6. 启动 Windows RKE2 服务#

rke2.exe agent service --add

注意:每台机器必须有一个唯一的主机名。

如果你希望只使用 CLI 参数,请使用所需参数运行二进制文件。

rke2.exe agent --token <> --server <>
Last updated on by kingsd041