Files
Marty Hernandez Avedon 8a3d8b1068 #420 Adding canonical refs to ./getting-started part 2/10 (#621)
* canonicized rollbacks.md

* canonicized troubleshooting.md

* canonicized upgrades.md

there were two corresponding pages for 2.0-2.4, one for helm 2 and one for helm 3, so i added canonical refs for both

* canonicized feature-flags

2.0-2.4 and 2.5 pages were in different folders

* corrected url on feature flags
2023-05-26 14:18:59 -04:00

4.1 KiB

title
title
Feature Flags
<head> </head>

With feature flags, you can try out optional or experimental features, and enable legacy features that are being phased out.

To learn more about feature values and how to enable them, see Enabling Experimental Features.

:::note

Some feature flags require a restart of the Rancher container. Features that require a restart are marked in the Rancher UI.

:::

The following is a list of feature flags available in Rancher. If you've upgraded from a previous Rancher version, you may see additional flags in the Rancher UI, such as proxy or dashboard (both discontinued):

  • continuous-delivery: Allows Fleet GitOps to be disabled separately from Fleet. See Continuous Delivery. for more information.
  • fleet: The Rancher provisioning framework in v2.6 and later requires Fleet. The flag will be automatically enabled when you upgrade, even if you disabled this flag in an earlier version of Rancher. See Fleet - GitOps at Scale for more information.
  • harvester: This feature flag is available starting in v2.6.1. Manages access to the Virtualization Management page, where users can navigate directly to Harvester clusters and access the Harvester UI. See Harvester Integration for more information.
  • istio-virtual-service-ui: Enables a visual interface to create, read, update, and delete Istio virtual services and destination rules, which are Istio traffic management features.
  • legacy: Enables a set of features from 2.5.x and earlier, that are slowly being phased out in favor of newer implementations. These are a mix of deprecated features as well as features that will eventually be available to newer versions. This flag is disabled by default on new Rancher installations. If you're upgrading from a previous version of Rancher, this flag is enabled.
  • multi-cluster-management: Allows multi-cluster provisioning and management of Kubernetes clusters. This flag can only be set at install time. It can't be enabled or disabled later.
  • rke2: Enables provisioning RKE2 clusters. This flag is enabled by default.
  • token-hashing: Enables token hashing. Once enabled, existing tokens will be hashed and all new tokens will be hashed automatically with the SHA256 algorithm. Once a token is hashed it can't be undone. This flag can't be disabled after its enabled. See API Tokens for more information.
  • unsupported-storage-drivers: This feature allows unsupported storage drivers.. In other words, it enables types for storage providers and provisioners that are not enabled by default.

The following table shows the availability and default values for some feature flags in Rancher. Features marked "GA" are generally available:

Feature Flag Name Default Value Status Available As Of
continuous-delivery true GA v2.6.0
fleet true Can no longer be disabled v2.6.0
fleet true GA v2.5.0
harvester true Experimental v2.6.1
legacy false for new installs, true for upgrades GA v2.6.0
multi-cluster-management false GA v2.5.0
rke2 true Experimental v2.6.0
token-hashing false for new installs, true for upgrades GA v2.6.0
unsupported-storage-drivers false Experimental v2.3.0