Skip to content

Release v2.6.0

Compare
Choose a tag to compare
@rancherio-gh-m rancherio-gh-m released this 31 Aug 04:28
· 315 commits to master since this release
df2432a

Release v2.6

It is important to review the Install/Upgrade Notes below before upgrading to any Rancher version.

Features and Enhancements

Redesigned Rancher User Experience

Rancher 2.6 has a new refreshed look and feel in the UI making it easy to use for beginner and advanced Kubernetes users.

  • New cluster explorer navigation: The Rancher UI view for a Kubernetes cluster has been enhanced for both new and advanced users. Users now see a collapsed subset of the most-used Kubernetes resources expressed in simple terms. All Kubernetes resources can be managed through the explorer and quickly found through the resource search functionality. Cluster admins can now administer projects from the cluster detail view. Cluster tools like logging and monitoring are now aggregated under a new easy-to-discover Cluster Tools. The cluster detail page is now enhanced with cluster and pod live metrics dashboards when monitoring is deployed through the Cluster Tools. See #2578
  • New home page: The default landing page provides a quick overview of the Rancher installation. Users can see what is new in the current release, find support, quickly launch into a cluster, or provision their first cluster. See #2511.
  • New global navigation: The primary navigation menu has been redesigned and simplified to make it easier for users and admins to quickly switch between clusters and top-level apps. See #2499.
  • New cluster manager navigation: The new cluster management page lists all of a user's clusters and has been enhanced with a new left-hand navigation menu to manage clusters, credentials, pod security policy templates and node drivers from a single place. See #2849.

Because the Cluster Manager and Cluster Explorer from Rancher v2.5 have been consolidated into a unified experience, those terms have been replaced in these release notes with "the global view" and "the cluster detail page."

Enhanced Branding and Customization Options

A new brand management page has been added to allow customizations to the Rancher UI in a single place:

  • Admins can now customize the logo image, display name, and primary color displayed throughout the Rancher UI.
  • Admins can specify a link to direct users to a custom support page.
  • Admins can disable displaying Rancher community support links on the new home page.
  • Cluster navigation customizations:
    • Users can now add top-level links in the left navigation of the cluster detail page.
    • Users can create groups of links that point to external and services within the cluster.

For details, see the documentation and #2835.

Enhancements for Hosted Kubernetes Clusters

  • AKS provisioning enhancements: AKS provisioning has been enhanced to support the full lifecycle management of the cluster. Users can now provision private AKS endpoints, multiple node pools, and leverage Rancher cloud credentials for authentication. Existing AKS clusters provisioned with other tools like the Azure Portal can now be registered into Rancher to allow management of Kubernetes upgrades and configuration going forward. Node pools can be configured with AKS to automatically enable autoscaling. See the documentation.
    • Note for AKS Clusters with RBAC Disabled: It is possible to create an AKS cluster in the Azure portal that has RBAC disabled. Since Rancher relies heavily on RBAC, a warning message is displayed when registering and viewing an AKS cluster in Rancher that has RBAC disabled. See #27670.
  • GKE provisioning enhancements: GKE provisioning builds on the updates in Rancher 2.5 that support full lifecycle management of GKE clusters. The GKE enhancements allow users to leverage shared VPCs and multiple node pools within Google Cloud Platform. GKE node pools can be also be configured to support the native autoscaling capabilities.
    • Ability to support network tags: When provisioning node pools in GKE clusters, users can add network tags to make firewall rules and routes between subnets.
    • Ability to support Project Network Isolation for registered GKE clusters: Admins and project owners can now leverage project network isolation to restrict network access between projects on imported/registered GKE clusters.
  • Deploying on hardened clusters: Support has been added for deploying EKS, AKS, and GKE clusters when the Rancher Management server cluster has been CIS hardened. See #29066.

Security Enhancements

  • Username and Identity Provider (IdP) name added to Rancher and Kubernetes audit logs: Admins can now view Rancher usernames and IdP (e.g., Active Directory and Github) usernames in the Kubernetes audit logs and the Rancher API audit logs, when interacting with the cluster through Rancher UI. Downstream cluster admins no longer have to map the u-********* name back to a user in the Rancher local cluster manually. This allows admins to track a user's activity by using the IDP username throughout the system including login and failed login attempts. See the documentation and #31166
  • Rancher server container based on SLE BCI image: The base image for Rancher server has been moved to SLE BCI. See #33127.
  • Rancher API token hashing: A new opt-in feature flag has been added to enable one-way hashing of Rancher tokens. Enabling this flag is one-way and non-reversible and should be vetted in dev/test environments before enabling in production. See the documentation and issues #31214 and #25723.
  • Randomly generated bootstrap password: A random bootstrap password is always generated for the user when Rancher is started for the first time, unless the users sets bootstrapPassword in the Helm chart values or CATTLE_BOOTSTRAP_PASSWORD on the Docker container. See the documentation and #121.
  • Sanitized audit log data: Audit logs level 2+ no longer output sensitive data (Passwords) in plain text. See #33338.
  • Restricted admin permissions: Permissions for a user with a "Restricted Admin" role have been fixed so that the user is able to perform the following operations, even though they have restricted access to the local cluster:
    • Deploy AKS/GKE/EKS clusters

Tech Preview - RKE2 Cluster Provisioning

Rancher 2.6 introduces a new provisioning framework built on top of Cluster API for provisioning RKE2 clusters from the Rancher UI/API.

  • Out of the box node driver support: RKE2 provisioning can create VMs on the major cloud providers leveraging cloud credentials. New in RKE2 provisioning with Rancher node drivers is the ability to SSH into the node directly from the Rancher UI. See #32516.
  • Additional CNI options: RKE2 brings with it new supported CNI options. Rancher's project network isolation feature can be used with CNIs that support Kubernetes network policies. See #32378.
  • Support for Authorized Cluster Endpoint: Cluster admins can configure Rancher's Authorized Cluster Endpoint locally in RKE2 clusters to allow direct access to the cluster without passing through the Rancher Management server proxy. See #32388.

Tech Preview - RKE2 Windows Node support

Tech Preview - Cluster Templates and Example RKE2 Cluster Template

Cluster templates allow an admin to define a base cluster configuration for users to consume when provisioning clusters. Cluster templates in the new provisioning framework are built as Helm charts and added to Rancher through the catalog.

Unlike RKE templates, which are for enforcing Kubernetes configuration, cluster templates include more of the cluster definition options and do not affect the cluster after it is initially provisioned. Cluster templates can define node pools, cloud credentials, cluster members, and installation of Rancher tools like monitoring. We provide an example cluster template for RKE2 that can be used to provision a Kubernetes cluster with the following constraints:

  • Multiple node pools for etcd/control plane and workers
  • An admin provided cloud credential
  • Allow users to enable the authorized cluster endpoint and specify cluster configuration options
  • Install Rancher V2 Monitoring
  • Assign cluster members

We provide an example cluster template for an RKE2 cluster here. To customize the template, you will need to fork the repository, add the Helm chart to a Rancher catalog, and install the template through the catalog. Rancher then provisions the Kubernetes cluster, and the cluster can be managed through Rancher in the same way as any other Rancher-launched Kubernetes cluster.

See the documentation and #30099.

More cluster template examples will be added to the cluster template repository in the future.

Enhancements for RKE Clusters

  • Added RKE External Dockershim Support: As of Kubernetes 1.20, the in-tree Dockershim was deprecated and is scheduled for removal in Kubernetes 1.22. The Dockershim is the CRI compliant layer between the Kubelet and the Docker daemon. RKE clusters now support the external Dockershim to continue leveraging Docker as the CRI runtime. We now implement the upstream open source community Dockershim announced by Mirantis and Docker to ensure RKE clusters can continue to leverage Docker. See the documentation and #31943.
  • Added Kubernetes 1.21: We've added support for Kubernetes 1.21 clusters for RKE.
  • NGINX Ingress default backend no longer a separate deployment: The default backend for the NGINX Ingress controller is now self-contained. Previously, the default backend was deployed as a pod and service. See #30356.
  • Windows RKE Prefix Path Support: Add support for Windows RKE prefix path with the ability to parse multiple styles of paths and separators. See #32268.
  • Dual-stack Support: Starting with Kubernetes v1.21, it is possible to configure dual-stack clusters in combination with the Calico network provider. See #33107.
  • hostPort for NGINX Ingress: The NGINX Ingress Controller version deployed with Kubernetes v1.21 and higher will be configured using hostPort instead of using hostNetwork. The NGINX Ingress Controller runs a validating admission webhook server which would be exposed externally when using hostNetwork. To avoid exposing it externally, the NGINX Ingress Controller runs in hostPort for port 80 and port 443, and the validating admission webhook server uses a ClusterIP which is only reachable from inside the cluster. See #33792.
  • ECR repository private registry configuration support: Added support to configure ECR repository as a private registry. See #28693.

Rancher Logging Enhancements

  • Added support for configuring fluentd and fluent-bit buffer sizes. See #28401.
  • Added support for more fluentd options: bufferStorageVolume, nodeSelector, tolerations (specific to fluentd), and replicas. See #31807.
  • Added support for Windows RKE prefix path with the ability to handle multiple kinds of pathing styles and separators. See #32268.
  • K3s logs are now aggregated through journald and are more refined. See #32993.
  • The number of fluentd replicas is now configurable. See #33373.
  • Upgraded the Banzai logging operator to version 3.10.0. See #32748.
  • Added timestamps to RKE2 control plane logs. See #32917.

Continuous Delivery Enhancements

  • Extended support for Fleet values: Add valuesFrom feature for ConfigMaps and Secrets to provide values.yaml for Fleet. See #384.
  • Ability to support bundle dependencies: Support bundle dependency. See #392.
  • Updated namespaces to avoid potential Fleet naming conflicts: Move Fleet to cattle-fleet-system from fleet-system to avoid collisions with other apps named fleet. See #395.
  • New Fleet GitOps feature flag: Rancher v2.6's new cluster provisioning system leverages Fleet's bundle deployment capabilities in order to manage clusters at scale. Therefore, in Rancher v2.6, Fleet can no longer be disabled. If Fleet was disabled in Rancher v2.5.x, it will become enabled if Rancher is upgraded to v2.6.x. A new feature flag was added to Rancher to disable the GitOps CD portion for end users within Rancher. See the documentation, #32688 and #32808.
  • Miscellaneous fixes for Provisioning V2: various edge cases were mitigated and performance inconsistencies were fixed in preparation for Provisioning V2.

Other Enhancements

  • Support for Keycloak with OIDC: A new Keycloak auth provider has been added to support OIDC. See the documentation and #30280.
  • Catalog performance enhancement: Catalogs will be greatly reduced in size, depending on their contents. See #32938.

Major Bug Fixes

  • Fix workload environment variables interpolation order by deprecating our custom environment and environmentFrom types in favor of Kubernetes env and envFrom native types. See #16148.
  • EKS, AKS, and GKE provisioners now correctly use any additional CAs passed to Rancher, if provided. See #31846.
  • The GKE cluster provisioner now handles differences in supported Kubernetes versions across regions. See #33524.
  • The GKE cluster provisioner was updated to handle changes to how the provider configures public and private clusters. See #33241.
  • The EKS cluster provisioner now correctly adds labels to clusters without causing the cluster to be in a perpetual updating state. See #33302.
  • Global DNS app gets uninstalled/removed immediately after install due to OwnerReferences cleanup enforced in Kubernetes v1.20. Instead of relying on the ownerReference for deletion of the app after GlobalDNSProvider is removed, fix is added to handle the delete event in the controller to remove the app. See #31638.
  • Project Network Isolation ingress NetworkPolicy resources now get configured correctly when using Calico CNI with IPIP or VXLAN routing. See #33979.
  • The Multi-cluster management feature flag can now only be disabled when starting Rancher. Previously, disabling the flag through the UI would result in a 404 page not found error. See #32721.
  • Users can now use the answersSetString field to ensure values are passed as a string as expected by the app being configured. See #26088.
  • The health status of the Controller Mananger and Scheduler on the dashboard will show as Not Applicable on clusters where the componentstatus is not available. See #11496.
  • Custom encryption configuration is no longer required to be case sensitive. See #31385
  • The rancher.cattle.io MutatingWebhookConfiguration object is now deleted when Rancher is uninstalled, which would otherwise cause failures reinstalling Rancher on the same cluster. See #33988

Install/Upgrade Notes

If you are installing Rancher for the first time, your environment must fulfill the installation requirements.

Upgrade Requirements

  • Creating backups: We strongly recommend creating a backup before upgrading Rancher. To roll back Rancher after an upgrade, you must back up and restore Rancher to the previous Rancher version. Because Rancher will be restored to its state when a backup was created, any changes post upgrade will not be included after the restore. For more information, see the documentation on backing up Rancher.
  • Helm version: Rancher install or upgrade must occur with Helm 3.2.x+ due to the changes with the latest cert-manager release. See #29213.
  • Kubernetes version: The local Kubernetes cluster for the Rancher server should be upgraded to Kubernetes 1.18+ before installing Rancher 2.6+.
  • CNI requirements:
    • For K8s 1.19 and newer, we recommend disabling firewalld as it has been found to be incompatible with various CNI plugins. See #28840.
    • If upgrading or installing to a Linux distribution which uses nf_tables as the backend packet filter, such as SLES 15, RHEL 8, Ubuntu 20.10, Debian 10, or newer, users should upgrade to RKE1 v1.19.2 or later to get Flannel version v0.13.0 that supports nf_tables. Flannel #1317.
    • For users upgrading from >=v2.4.4 to v2.5.x with clusters where ACI CNI is enabled, note that upgrading Rancher will result in automatic cluster reconciliation. This is applicable for Kubernetes versions v1.17.16-rancher1-1, v1.17.17-rancher1-1, v1.17.17-rancher2-1, v1.18.14-rancher1-1, v1.18.15-rancher1-1, v1.18.16-rancher1-1, and v1.18.17-rancher1-1. Please refer to the workaround BEFORE upgrading to v2.5.x. See #32002.
  • Requirements for air gapped environments:
    • For installing or upgrading Rancher in an air gapped environment, please add the flag --no-hooks to the helm template command to skip rendering files for Helm's hooks. See #3226.
    • If using a proxy in front of an air gapped Rancher, you must pass additional parameters to NO_PROXY. See the documentation and #2725.
  • Cert-manager version requirements: Recent changes to cert-manager require an upgrade if you have a high-availability install of Rancher using self-signed certificates. If you are using cert-manager older than v0.9.1, please see the documentation on how to upgrade cert-manager. See documentation.
  • Requirements for Docker installs:
    • When starting the Rancher Docker container, the privileged flag must be used. See the documentation.
    • When installing in an air gapped environment, you must supply a custom registries.yaml file to the docker run command as shown in the K3s documentation. If the registry has certs, then you will need to also supply those. See #28969.
    • When upgrading a Docker installation, a panic may occur in the container, which causes it to restart. After restarting, the container comes up and is working as expected. #33685

Rancher Behavior Changes

  • Legacy features are gated behind a feature flag. Users upgrading from Rancher <=v2.5.x will automatically have the --legacy feature flag enabled. New installations that require legacy features need to enable the flag on install or through the UI.
  • The local cluster can no longer be turned off. In older Rancher versions, the local cluster could be hidden to restrict admin access to the Rancher server's local Kubernetes cluster, but that feature has been deprecated. The local Kubernetes cluster can no longer be hidden and all admins will have access to the local cluster. If you would like to restrict permissions to the local cluster, there is a new restricted-admin role that must be used. The access to local cluster can now be disabled by setting hide_local_cluster to true from the v3/settings API. See the documentation and #29325. For more information on upgrading from Rancher with a hidden local cluster, see the documentation.
  • Users must log in again. After upgrading to v2.6+, users will be automatically logged out of the old Rancher UI and must log in again to access Rancher and the new UI. See #34004.
  • Fleet is now always enabled. For users upgrading from v2.5.x to v2.6.x, note that Fleet will be enabled by default as it is required for operation in v2.6+. This will occur even if Fleet was disabled in v2.5.x. During the upgrade process, users will observe restarts of the rancher pods, which is expected. See #31044 and #32688.
  • Editing and saving clusters can result in cluster reconciliation. For users upgrading from <=v2.4.8 (<= RKE v1.1.6) to v2.4.12+ (RKE v1.1.13+)/v2.5.0+ (RKE v1.2.0+) , please note that Edit and save cluster (even with no changes or a trivial change like cluster name) will result in cluster reconciliation and upgrading kube-proxy on all nodes because of a change in kube-proxy binds. This only happens on the first edit and later edits shouldn't affect the cluster. See #32216.
  • The EKS cluster refresh interval setting changed. There is currently a setting allowing users to configure the length of refresh time in cron format: eks-refresh-cron. That setting is now deprecated and has been migrated to a standard seconds format in a new setting: eks-refresh. If previously set, the migration will happen automatically. See #31789.
  • System components will restart. Please be aware that upon an upgrade to v2.3.0+, any edits to a Rancher launched Kubernetes cluster will cause all system components to restart due to added tolerations to Kubernetes system components. Plan accordingly.
  • New GKE and AKS clusters will use Rancher's new lifecycle management features. Existing GKE and AKS clusters and imported clusters will continue to operate as-is. Only new creations and registered clusters will use the new full lifecycle management.
  • New steps for rolling back Rancher. The process to roll back Rancher has been updated for versions v2.5.0 and above. New steps require scaling Rancher down to 0 replica before restoring the backup. Please refer to the documentation for the new instructions.
  • RBAC differences around Manage Nodes for RKE2 clusters Due to the change of the provisioning framework, the Manage Nodes role will no longer be able to scale up/down machine pools. The user would need the ability to edit the cluster to manage the machine pools #34474.
  • Machines vs Kube Nodes. In previous versions, Rancher only displayed Nodes, but with v2.6, there are the concepts of machines and kube nodes. Kube nodes are the Kubernetes node objects and are only accessible if the Kubernetes API server is running and the cluster is active. Machines are the cluster's machine object which defines what the cluster should be running.
  • Requirements for Docker installs:
    • When starting the Rancher Docker container, the privileged flag must be used. See the documentation.
    • When installing in an air gapped environment, you must supply a custom registries.yaml file to the docker run command as shown in the K3s documentation. If the registry has certs, then you will need to also supply those. See #28969.

Versions

Please refer to the README for latest and stable versions.

Please review our version documentation for more details on versioning and tagging conventions.

Images

  • rancher/rancher:v2.6.0

Tools

Kubernetes Versions

  • v1.21.x (Default)
  • v1.20.10
  • v1.19.14
  • v1.18.20

Rancher Helm Chart Versions

Starting in 2.6.0 many of the Rancher Helm charts available in the Apps & Marketplace will start with a major version of 100. This was done to avoid simultaneous upstream changes and Rancher changes from causing conflicting version increments. This also brings us into compliance with semver, which is a requirement for newer versions of Helm. You can now see the upstream version of a chart in the build metadata, for example: 100.0.0+up2.1.0. See #32294.

Other Notes

Feature Flags

Please review the new feature flags introduced into 2.6.0 and their default status.

Feature Flag Default Value Description
fleet true The previous fleet feature flag is now required to be enabled as the fleet capabilities are leveraged within the new provisioning framework. If you had this feature flag disabled in earlier versions, upon upgrading to Rancher, the flag will automatically be enabled.
gitops true If you want to hide the "Continuous Delivery" feature from your users, then please use the newly introduced gitops feature flag, which hides the ability to leverage Continuous Delivery.
rke2 true We have introduced the ability to provision RKE2 clusters as tech preview. By default, this feature flag is enabled, which allows users to attempt to provision these type of clusters.
legacy false for new installs, true for upgrades There are a set of features from previous versions that are slowly being phased out of Rancher for newer iterations of the feature. This is a mix of deprecated features as well as features that will eventually be moved to newer variations in Rancher. By default, this feature flag is disabled for new installations. If you are upgrading from a previous version, this feature flag would be enabled.
token-hashing false Used to enable new token-hashing feature. Once enabled, existing tokens will be hashed and all new tokens will be hashed automatically using the SHA256 algorithm. Once a token is hashed it cannot be undone. Once this feature flag is enabled it cannot be disabled.

Experimental Features

RancherD was introduced in 2.5 as an easy-to-use installation binary. With the introduction of RKE2 provisioning, this project is being re-written and will be available at a later time. See #33423.

Legacy Features

Legacy features are features hidden behind the legacy feature flag, which are various features/functionality of Rancher that was available in previous releases. These are features that Rancher doesn't intend for new users to consume, but if you have been using past versions of Rancher, you'll still want to use this functionality.

When you first start 2.6, there is a card in the Home page that outlines the location of where these features are now located.

The deprecated features from v2.5 are now behind the legacy feature flag. Please review our deprecation policy for questions.

The following legacy features are no longer supported on Kubernetes 1.21+ clusters:

  • Logging (Legacy)
  • CIS Scans (Legacy)
  • Istio 1.5
  • Pipelines

Known Major Issues

  • Kubernetes Cluster Distributions
    • RKE
      • Rotating encryption keys with a custom encryption provider is not supported. See #30539.
    • RKE2 - Tech Preview: There are several known issues as this feature is in tech preview, but here are some major issues to consider before using RKE2.
      • Sometimes the nodes may not be cleaned up in the infrastructure provider when deleting clusters or nodes. Please be sure to review the actual nodes after cleaning up a cluster. See #34542.
      • There are issues around removing etcd nodes from a cluster. See #34488.
      • Amazon ECR Private Registries are not functional. See #33920.
      • Proxy behind individual downstream clusters is not working. See #32633.
      • Cloud providers are not working for Azure clusters. See #34367.
      • Windows Container support on Windows Server Standard Edition requires the 09-2021 cumulative update from Microsoft. Windows Server Datacenter Edition is unaffected. See #72.
      • Windows clusters do not yet support Rancher Apps & Marketplace. See #34405.
      • Windows clusters do not yet support upgrading RKE2 versions. See Windows #76.
    • AKS:
      • When upgrading the Kubernetes version in an AKS cluster, do not add a node pool at the same time. These actions must be done separately. See #33426.
      • When editing or upgrading the AKS cluster, do not make changes from the Azure console or CLI at the same time. These actions must be done separately. See #33561
      • Windows node pools are not currently supported. See #32586.
      • When upgrading an AKS cluster Kubernetes minor versions cannot be skipped. All upgrades must be performed sequentially by major version number. See #34161
    • GKE
      • Basic authentication must be explicitly disabled in GCP before upgrading a GKE cluster to 1.19+ in Rancher. See #32312.
  • Cluster Tools:
    • Fleet:
      • Multiple fleet-agent pods may be created and deleted during initial downstream agent deployment; rather than just one. This resolves itself quickly, but is unintentional behavior. See #33293.
    • Hardened clusters: Not all cluster tools can currently be installed on a hardened cluster.
    • Rancher Backup:
      • When migrating to a cluster with the Rancher Backup feature, the server-url cannot be changed to a different location. It must continue to use the same URL.
      • When running a newer version of the rancher-backup app to restore a backup made with an older version of the app, the resourceSet rancher-resource-set will be restored to an older version that might be different from the one defined in the current running rancher-backup app. The workaround is to edit the rancher-backup app to trigger a reconciliation. See #34495.
    • Monitoring:
      • Deploying Monitoring on a Windows cluster with win_prefix_path set requires users to deploy Rancher Wins Upgrader to restart wins on the hosts to start collecting metrics in Prometheus. See #32535.
    • Logging:
      • Windows nodeAgents are not deleted when performing helm upgrade after disabling Windows logging on a Windows cluster. See #32325.
    • Istio versions:
      • Istio v1.10.4 will be available with the Rancher Istio Helm chart v100.0.0+up1.10.4. A previous version of Istio, 1.10.2, included a security fix for CVE-2021-34824. See #32795.
      • Istio 1.9 support ends on August 18th, 2021.
      • Istio 1.5 is not supported in air gapped environments. Please note that the Istio project has ended support for Istio 1.5.
      • The Kiali dashboard bundled with 100.0.0+up1.10.2 errors on a page refresh. Instead of refreshing the page when needed, simply access Kiali using the dashboard link again. Everything else works in Kiali as expected, including the graph auto-fresh. See #33739.
      • When v1 Istio is installed in a cluster, the side navigation will incorrectly show a top-level 'Istio' menu item. This should be ignored for v1 Istio and users should instead use the Istio functionality under the 'Legacy' top-level menu item (this requires the legacy feature flag to be enabled). See #4072.
    • Legacy Monitoring:
      • The Grafana instance inside Cluster Manager's Monitoring is not compatible with Kubernetes 1.21. See #33465.
      • In air gapped setups, the generated rancher-images.txt that is used to mirror images on private registries does not contain the images required to run Legacy Monitoring, also called Monitoring V1, which is compatible with Kubernetes 1.15 clusters. If you are running Kubernetes 1.15 clusters in an air gapped environment, and you want to either install Monitoring V1 or upgrade Monitoring V1 to the latest that is offered by Rancher for Kubernetes 1.15 clusters, you will need to take one of the following actions:
        • Upgrade the Kubernetes version so that you can use v0.2.x of the Monitoring application Helm chart
        • Manually import the necessary images into your private registry for the Monitoring application to use
      • When deploying any downstream cluster, Rancher logs errors that seem to be related to Monitoring even when Monitoring is not installed onto either cluster; specifically, Rancher logs that it failed on subscribe to the Prometheus CRs in the cluster because it is unable to get the resource prometheus.meta.k8s.io. These logs appear in a similar fashion for other Prometheus CRs (namely Alertmanager, ServiceMonitors, and PrometheusRules), but do not seem to cause any other major impact in functionality. See #32978.
  • Docker installs: There are UI issues around startup time. See #28800 and #28798.
  • Login to Rancher using ActiveDirectory with TLS: See #34325.
    • Upon an upgrade to v2.6.0, authenticating via Rancher against an ActiveDirectory server using TLS can fail if the certificates on the AD server do not support SAN attributes. This is a check enabled by default in Golang 1.15.
    • The error received is "Error creating ssl connection: LDAP Result Code 200 "Network Error": x509: certificate relies on legacy Common Name field, use SANs or temporarily enable Common Name matching with GODEBUG=x509ignoreCN=0"
    • To resolve this, the certificates on the AD server should be updated or replaced with new ones that support the SAN attribute. Alternatively this error can be ignored by setting "GODEBUG=x509ignoreCN=0" as an environment variable to Rancher server container.
  • Legacy UI:
    • When using the Rancher v2.6 UI to add a port to a Deployment that was created initially without any ports using the legacy UI, users may encounter a services <NAME> already exists error. To work around this issue, the legacy UI should be used to make updates to the configuration of Deployments created using the legacy UI. See #4159.
  • Rancher UI:
    • After closing the shell in the Rancher UI, be aware that the corresponding processes remain running indefinitely for each shell in the pod. See #16192.