启用实验功能

自 v2.3.0 起可用

Rancher 包含一些实验性功能，默认状态下，这些功能是禁用的。在某些情况下，您可能想要启用这些功能。例如，如果您决定使用的Rancher 技术支持团队不支持的存储类型所带来的好处大于风险，则可能需要启用这些未被测试过的功能。功能开关，使您可以尝试使用默认情况下未启用的功能。

可以通过三种方式启用这些功能：

每个功能有两个值：

  • 默认值，可以通过命令行配置一个标志或环境变量
  • 设置值，可以通过 Rancher API 或 UI 配置

如果未设置任何值，则 Rancher 使用默认值

因为 API 设置了实际值，而命令行设置了默认值，所以这意味着，如果您使用 API 或 UI 启用或禁用功能，它将覆盖命令行设置的值。

例如，如果您安装 Rancher，然后使用 Rancher API 将功能开关设置为 true，然后通过命令行将功能开关设置为 false 来升级 Rancher，默认值仍然是 false，但是这个功能还是被启用的，因为它是通过 Rancher API 设置的。如果随后使用 Rancher API 删除了设置值（true），并将其设置为 NULL，则默认值（false）将生效。

注意： 从 v2.4.0 开始，有些功能开关可能需要重新启动 Rancher Server 容器。下表和 UI 中标记了哪些功能需要重新启动 Rancher Server。

以下是 Rancher 中可用的功能开关的列表：

  • Fleet：Rancher 在 v2.5+版本中预装了 Fleet。
  • istio-virtual-service-ui：该功能可以实现 UI 来创建、读取、更新和删除 Istio 虚拟服务和目标规则，这是 Istio 的流量管理功能。
  • unsupported-storage-drivers：该功能允许不支持的存储驱动。换句话说，它启用了默认不启用的存储提供商和供应者的类型。

下表显示了在 Rancher 中功能开关的可用版本和默认值：

功能开关名默认值状态可用版本是否需要重启 Rancher?
dashboardtrue实验性v2.4.0是
dashboardtrue实验性v2.4.0是
istio-virtual-service-uifalse实验性v2.3.0否
istio-virtual-service-uitrueGAv2.3.2否
proxyfalse实验性v2.4.0否
proxyN/A暂停开发v2.5.0否
unsupported-storage-driversfalse实验性v2.3.0否
fleettrueGAv2.5.0否

启动 Rancher 时启用功能

安装 Rancher 时，请使用功能开关启用所需的功能。该命令会有所不同，具体取决于您是高可用安装还是单节点安装。

注意： 通过 Rancher API 设置的值将覆盖通过命令行传递的值。

高可用安装

当通过 Helm chart 安装 Rancher 时，请使用--features选项。在下面的示例中，通过传递功能开关名称（用逗号分隔）来启用两个功能：

  1. helm install rancher-latest/rancher \
  3.   --name rancher \
  5.   --namespace cattle-system \
  7.   --set hostname=rancher.my.org \
  9.   --set 'extraEnv[0].name=CATTLE_FEATURES' # 自 v2.3.0 起可用
  11.   --set 'extraEnv[0].value=<FEATURE-FLAG-NAME-1>=true,<FEATURE-FLAG-NAME-2>=true' # 自 v2.3.0 起可用

Copy

注意：如果要安装 Alpha 版本，Helm 要求在命令中添加--devel参数。

在离线安装时渲染 Helm Chart

对于离线安装 Rancher，通过 Helm 安装 Rancher 之前，需要添加一个 Helm chart 仓库，渲染一个 Helm 模板。有关详细信息，请参阅离线安装文档。

在下面的示例中，通过传递功能开关名称（用逗号分隔）来启用两个功能。

2.5.8 之前： Helm 3 命令如下：

  1. helm template rancher ./rancher-<VERSION>.tgz --output-dir . \
  3.   --namespace cattle-system \
  5.   --set hostname=<RANCHER.YOURDOMAIN.COM> \
  7.   --set rancherImage=<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher \
  9.   --set ingress.tls.source=secret \
  11.   --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # 自 v2.2.0 起可用，配置 Rancher 使用默认的镜像仓库
  13.   --set useBundledSystemChart=true # 自 v2.3.0 起可用，使用Rancher内嵌的system charts
  15.   --set 'extraEnv[0].name=CATTLE_FEATURES' # 自 v2.3.0 起可用
  17.   --set 'extraEnv[0].value=<FEATURE-FLAG-NAME-1>=true,<FEATURE-FLAG-NAME-2>=true' # 自 v2.3.0 起可用

Copy

Helm 2 命令如下：

  1. helm template ./rancher-<VERSION>.tgz --output-dir . \
  3.   --name rancher \
  5.   --namespace cattle-system \
  7.   --set hostname=<RANCHER.YOURDOMAIN.COM> \
  9.   --set rancherImage=<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher \
  11.   --set ingress.tls.source=secret \
  13.   --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # 自 v2.2.0 起可用，配置 Rancher 使用默认的镜像仓库
  15.   --set useBundledSystemChart=true # 自 v2.3.0 起可用，使用Rancher内嵌的system charts
  17.   --set 'extraEnv[0].name=CATTLE_FEATURES' # 自 v2.3.0 起可用
  19.   --set 'extraEnv[0].value=<FEATURE-FLAG-NAME-1>=true,<FEATURE-FLAG-NAME-2>=true' # 自 v2.3.0 起可用

Copy

2.5.8 及之后： Helm 3 命令如下：

  1. helm template rancher ./rancher-<VERSION>.tgz --output-dir . \
  3.   --no-hooks \ # prevent files for Helm hooks from being generated
  5.   --namespace cattle-system \
  7.   --set hostname=<RANCHER.YOURDOMAIN.COM> \
  9.   --set rancherImage=<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher \
  11.   --set ingress.tls.source=secret \
  13.   --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # Set a default private registry to be used in Rancher
  15.   --set useBundledSystemChart=true # Use the packaged Rancher system charts
  17.   --set 'extraEnv[0].name=CATTLE_FEATURES'
  19.   --set 'extraEnv[0].value=<FEATURE-FLAG-NAME-1>=true,<FEATURE-FLAG-NAME-2>=true'

Copy

Helm 2 命令如下：

  1. helm template rancher ./rancher-<VERSION>.tgz --output-dir . \
  3.   --namespace cattle-system \
  5.   --set hostname=<RANCHER.YOURDOMAIN.COM> \
  7.   --set rancherImage=<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher \
  9.   --set ingress.tls.source=secret \
  11.   --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # Set a default private registry to be used in Rancher
  13.   --set useBundledSystemChart=true # Use the packaged Rancher system charts
  15.   --set 'extraEnv[0].name=CATTLE_FEATURES'
  17.   --set 'extraEnv[0].value=<FEATURE-FLAG-NAME-1>=true,<FEATURE-FLAG-NAME-2>=true'

Copy

单节点安装

通过 Docker 安装 Rancher 时，请使用--features选项。在下面的示例中，通过传递功能开关名称（逗号分隔）来启用两个功能：

  1. docker run -d -p 80:80 -p 443:443 \
  3.   --restart=unless-stopped \
  5.   rancher/rancher:rancher-latest \
  7.   --features=<FEATURE-FLAG-NAME-1>=true,<FEATURE-NAME-2>=true # 自 v2.3.0 起可用

Copy

通过 Rancher UI 启用功能

自 v2.3.3 起可用

  1. 转到全局视图，然后单击系统设置
  2. 单击功能选项选项卡。您将看到一个实验功能列表。
  3. 要启用功能，请转到要启用的禁用功能，然后单击 省略号 (…) > 启用。

结果： 该功能已启用。

通过 Rancher UI 禁用功能

自 v2.3.3 起可用

  1. 转到全局视图，然后单击系统设置
  2. 单击功能选项选项卡。您将看到一个实验功能列表。
  3. 要启用功能，请转到要启用的禁用功能，然后单击 省略号 (…) > 停用。

结果： 该功能被禁用。

通过 Rancher API 启用功能

  1. 转到 <RANCHER-SERVER-URL>/v3/features.
  2. 在data部分，您将会看到一个包含所有可以使用功能开关启用功能的功能数组。功能名称在id字段中。单击要启用的功能的名称。
  3. 在屏幕左上角，Operations下面，单击Edit.
  4. 在 Value 下拉菜单, 单击 True。
  5. 单击 Show Request。
  6. 单击 Send Request。
  7. 单击 Close。

结果： 该功能已启用。

通过 Rancher API 禁用功能

  1. 转到 <RANCHER-SERVER-URL>/v3/features。
  2. 在 data 部分, 您将会看到一个包含所有可以使用功能开关启用功能的功能数组。功能名称在id字段中。单击要启用的功能的名称。
  3. 在屏幕左上角， Operations 下面， 单击Edit。
  4. 在 Value 下拉菜单, 单击 False。
  5. 单击 Show Request。
  6. 单击 Send Request。
  7. 单击 Close。

结果： 该功能被禁用。