Este documento ha sido traducido utilizando tecnología de traducción automática. Si bien nos esforzamos por proporcionar traducciones precisas, no ofrecemos garantías sobre la integridad, precisión o confiabilidad del contenido traducido. En caso de discrepancia, la versión original en inglés prevalecerá y constituirá el texto autorizado.

Banderas de características

Con las banderas de características, puedes probar funciones opcionales o experimentales, y habilitar características heredadas que están siendo eliminadas.

Para aprender más sobre los valores de las características y cómo habilitarlas, consulta Habilitar Funciones Experimentales.

Algunas banderas de características requieren un reinicio del contenedor de Rancher. Las funciones que requieren un reinicio están marcadas en la interfaz de usuario de Rancher.

La siguiente es una lista de banderas de características disponibles en Rancher. Si has actualizado desde una versión anterior de Rancher, puedes ver banderas adicionales en la interfaz de usuario de Rancher, como proxy o dashboard (ambas xref:[descontinuadas]):

  • aggregated-roletemplates: Utiliza la arquitectura de agregación de roles de clúster para RoleTemplates, ProjectRoleTemplateBindings y ClusterRoleTemplateBindings. Consulta Agregación de RoleTemplate para más información.

  • clean-stale-secrets: Elimina secretos obsoletos del espacio de nombres cattle-impersonation-system. Esto limpia lentamente los secretos antiguos que ya no son utilizados por el sistema de suplantación.

  • continuous-delivery: Permite deshabilitar Fleet GitOps por separado de Fleet. Consulta Entrega Continua para más información.

  • fleet: El marco de aprovisionamiento de Rancher en v2.6 y versiones posteriores requiere Fleet. La bandera se habilitará automáticamente al actualizar, incluso si la desactivaste en una versión anterior de Rancher. Consulta Entrega Continua con Fleet para más información.

  • harvester: Gestiona el acceso a la página de gestión de virtualización, donde los usuarios pueden navegar directamente a los clústeres de Harvester y acceder a la interfaz de usuario de Harvester. Consulta SUSE Virtualization Visión General de Integración para más información.

  • imperative-api-extension: Habilita el servidor API de extensión de Rancher para registrar nuevas APIs en Kubernetes. Esta bandera está habilitada por defecto. Consulta la página Servidor API de Extensión para más información.

  • istio-virtual-service-ui: Habilita una interfaz visual para crear, leer, actualizar y eliminar servicios virtuales de Istio y reglas de destino, que son características de gestión de tráfico de Istio.

  • legacy: Habilita un conjunto de características de 2.5.x y versiones anteriores, que están siendo eliminadas lentamente en favor de implementaciones más nuevas. Estas son una mezcla de características obsoletas así como características que eventualmente estarán disponibles en versiones más nuevas. Esta bandera está deshabilitada por defecto en nuevas instalaciones de Rancher. Si actualizas desde una versión anterior de Rancher, esta bandera está habilitada.

  • managed-system-upgrade-controller: Habilita la instalación de la app system-upgrade-controller en clústeres RKE2/K3s importados en sentido descendente, así como en el clúster local si es un clúster RKE2/K3s.

Esta managed-system-upgrade-controller bandera está destinada a uso interno solamente y no tiene un CR de característica asociado. Utilizar con precaución.

Para controlar si Rancher debe gestionar la versión de Kubernetes de los clústeres RKE2/K3s importados, se recomienda utilizar la característica gestión-de-versiones-de-clústeres-importados que está disponible en Rancher v2.11.0 o superior.

Si la managed-system-upgrade-controller opción estaba desactivada en Rancher v2.10.x, y cualquier clúster RKE2/K3s importado fue actualizado fuera de Rancher, sigue los pasos a continuación para prevenir la instalación inesperada de la aplicación system-upgrade-controller y asegurar que la característica gestión-de-versiones-de-clústeres-importados funcione correctamente:

  1. Actualiza Rancher a v2.11.0 o superior, asegurándote de retener la managed-system-upgrade-controller=false bandera en los valores de Helm si se configuró durante la instalación de v2.10.x.

  2. Una vez que Rancher esté completamente en funcionamiento, desactiva la imported-cluster-version-management bandera. Puedes hacer esto ya sea a través de la interfaz de usuario de Rancher haciendo clic en ☰ > Configuración Global > Configuraciones > gestión-de-versiones-de-clústeres-importados, o editando el correspondiente Setting.management.cattle.io/v3 recurso personalizado a través de kubectl.

  3. Realiza una segunda actualización de Helm, esta vez omitiendo la managed-system-upgrade-controller=false bandera.

Ahora, la gestión de versiones del clúster importado está desactivada por defecto, y Rancher ya no instala automáticamente la app system-upgrade-controller en los clústeres importados.

Puedes habilitar esta característica de forma individual para cada clúster. Para más información, por favor consulta la documentación.

  • multi-cluster-management: Permite el aprovisionamiento y la gestión de múltiples clústeres de Kubernetes. Esta bandera solo puede ser configurada en el momento de la instalación. No se puede habilitar o deshabilitar más tarde.

  • rke2: Habilita la provisión de clústeres RKE2. Esta bandera está habilitada por defecto.

  • token-hashing: Habilita el hash de token. Una vez habilitada, los tokens existentes serán protegidos mediante hash y todos los nuevos tokens serán protegidos automáticamente mediante el algoritmo SHA256. Una vez que un token es protegido mediante hash, no se puede deshacer. Esta bandera no se puede desactivar después de haber sido habilitada. Consulta Tokens de API para más información.

  • uiextension: Habilita extensiones de la interfaz de usuario. Esta bandera está habilitada por defecto. Habilitar o deshabilitar la bandera obliga a reiniciar el pod de Rancher. La primera vez que esta bandera se establece en Active, crea un CRD y habilita los controladores y puntos finales necesarios para que la característica funcione. Si se establece en Disabled, deshabilita los controladores y puntos finales mencionados anteriormente. Establecer uiextension en Disabled no tiene efecto sobre el CRD --; no crea un CRD si aún no existe, ni elimina el CRD si ya existe.* unsupported-storage-drivers: Habilita tipos para proveedores de almacenamiento y aprovisionadores que no están habilitados por defecto. Consulta Permitir controladores de almacenamiento no soportados para más información.

  • ui-sql-cache: Habilita una caché basada en SQLite para tablas de la interfaz de usuario y paginación del lado del servidor. Consulta Paginación del lado del servidor de la interfaz de usuario para más información.

La siguiente tabla muestra la disponibilidad y los valores predeterminados para algunas banderas de características en Rancher. Las características marcadas como "GA" están generalmente disponibles:

Nombre de la bandera de característica Valor por defecto Estado Disponible desde información adicional

aggregated-roletemplates

Disabled

Experimental

v2.11.0

Este valor de la bandera está bloqueado en la instalación y no se puede cambiar.

clean-stale-secrets

Active

GA

v2.11.0

continuous-delivery

Active

GA

v2.6.0

external-rules

v2.7.14: Disabled, v2.8.5: Active

Removed

v2.7.14, v2.8.5

Esta bandera afectó a comportamiento RoleTemplate externo. Se elimina en Rancher v2.9.0 y versiones posteriores, ya que el comportamiento está habilitado por defecto.

fleet

Active

Ya no se puede deshabilitar

v2.6.0

fleet

Active

GA

v2.5.0

harvester

Active

Experimental

v2.6.1

imperative-api-extension

Active

GA

v2.11.0

legacy

false para nuevas instalaciones, true para actualizaciones

GA

v2.6.0

managed-system-upgrade-controller

true

GA

v2.10.0

rke2

true

Experimental

v2.6.0

token-hashing

Disabled para nuevas instalaciones, Active para actualizaciones

GA

v2.6.0

uiextension

Active

GA

v2.9.0

ui-sql-cache

Active

GA

v2.9.0