- 配置选项

title: 安装配置选项 description: 本页主要介绍设置 RKE2 时的配置选项 keywords:

• rancher
• rancher中文
• rancher中文文档
• rancher官网
• rancher文档
• Rancher
• rancher 中文
• rancher 中文文档
• rancher cn
• RKE2
• 安装配置选项
• 配置选项

本页主要介绍设置 RKE2 时的配置选项:

• 配置 Linux 安装脚本
• 配置 Windows 安装脚本
• 配置 RKE2 server 节点
• 配置 Linux RKE2 agent 节点
• 配置 Windows RKE2 agent 节点
• 使用配置文件
• 直接运行二进制文件时的配置

配置 RKE2 的主要方式是通过其配置文件。也可以使用命令行参数和环境变量，但是 RKE2 是作为 systemd 服务安装的，因此使用起来并不容易。

配置 Linux 安装脚本

正如快速入门指南中提到的，你可以使用 https://get.rke2.io ，将 RKE2 作为服务进行安装。

这个命令的最简单形式如下：

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

:::note 提示 国内用户，可以使用以下方法加速安装：

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

:::

当使用这种方法来安装 RKE2 时，可以使用以下环境变量来配置安装：

这个安装脚本简单明了，将做以下工作：

1. 根据上述参数，获取所需的版本进行安装。如果没有提供参数，将使用最新的官方版本。
2. 确定并执行安装方法。有两种方法：rpm 和 tar。如果设置了 INSTALL_RKE2_METHOD 变量，则将遵循该变量，否则，在使用该软件包管理系统的操作系统上将使用 “rpm”。在所有其他系统上，将使用 tar。在使用 tar 方法的情况下，脚本将简单地解压与所需版本相关的 tar 归档文件。在使用 rpm 的情况下，将建立一个 yum 仓库，并使用 yum 安装 rpm。

配置 Windows 安装脚本

从 v1.21.3+rke2r1 开始，Windows 支持目前是实验性的。Windows 支持需要选择 Calico 作为 RKE2 集群的 CNI

正如快速入门指南中提到的，你可以使用https://github.com/rancher/rke2/blob/master/install.ps1 中的安装脚本在 Windows agent 节点上安装 RKE2。

该命令的最简单形式如下。

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

当使用这种方法安装 Windows RKE2 agent 时，可以通过以下参数来配置安装脚本：

语法：
install.ps1 [[-Channel] <String>] [[-Method] <String>] [[-Type] <String>] [[-Version] <String>] [[-TarPrefix] <String>] [-Commit] [[-AgentImagesDir] <String>] [[-ArtifactPath] <String>] [[-ChannelUrl] <String>] [<CommonParameters>]
选项：
-Channel 用于获取RKE2下载URL的通道（默认："stable"）。
-Method 使用的安装方法。目前支持tar或choco安装。(默认值："tar")
-Type RKE2服务的类型。在Windows上只支持 "agent" 类型。(默认值: "agent")
-Version 从Github下载的rke2版本
-TarPrefix 使用tar安装方法时的安装前缀。(默认值：`C:/usr/local`，除非`C:/usr/local`是只读的或者有专门的挂载点，在这种情况下会使用`C:/opt/rke2`代替)
-Commit (experimental/agent) 从临时云存储中下载RKE2的commit。如果设置，这将强制`--Method=tar`。仅用于开发目的。
-AgentImagesDir 当从CI提交安装时，离线镜像的安装路径。(默认：`C:/var/lib/rancher/rke2/agent/images`)
-ArtifactPath 如果设置，安装脚本将使用本地路径来获取`rke2.windows-$SUFFIX`和`sha256sum-$ARCH.txt`文件，而不是从GitHub下载这些文件。默认情况下是禁用的。

其他 Windows 安装脚本使用实例

安装最新版本而不是稳定版

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

使用 Tar 安装方法安装最新版本

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

配置 RKE2 server 节点

关于配置 RKE2 server 的细节，请参考server 配置参考。

配置 Linux RKE2 agent 节点

关于配置 RKE2 agent 的细节，请参考agent 配置参考

配置 Windows RKE2 agent 节点

关于配置 RKE2 Windows agent 的细节，请参考Windows agent 配置参考。

配置文件

默认情况下，RKE2 将使用位于/etc/rancher/rke2/config.yaml的 YAML 文件中的值启动。

下面是一个基本的 server 配置文件的例子：

write-kubeconfig-mode: "0644"
tls-san:
  - "foo.local"
node-label:
  - "foo=bar"
  - "something=amazing"

配置文件参数直接映射到 CLI 参数，可重复的 CLI 参数表示为 YAML 列表。

下面是一个仅使用 CLI 参数的相同配置，以证明这一点：

rke2 server \
  --write-kubeconfig-mode "0644"    \
  --tls-san "foo.local"             \
  --node-label "foo=bar"            \
  --node-label "something=amazing"

也可以同时使用配置文件和 CLI 参数。在这些情况下，将从两个源中加载值，但 CLI 参数将被优先考虑。 对于可重复的参数，如--node-label，CLI 参数将覆盖列表中的所有值。

最后，配置文件的位置可以通过 CLI 参数--config FILE, -c FILE，或者环境变量$RKE2_CONFIG_FILE来改变。

直接运行二进制文件时的配置

如前所述，安装脚本主要是为了配置 RKE2 作为一个服务来运行。如果你选择不使用脚本，你可以通过从我们的发布页下载二进制文件，把它放在你的路径上，然后执行它。RKE2 二进制文件支持以下命令：

rke2 server和rke2 agent命令有额外的配置选项，可以用rke2 server --help或rke2 agent --help查看。