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.

Habilitando Características Experimentales

Rancher incluye algunas características que son experimentales y están desactivadas por defecto. Puede que desee habilitar estas características, por ejemplo, si decide que los beneficios de usar un tipo de almacenamiento no soportado superan el riesgo de usar una característica no probada. Se introdujeron las banderas de características para permitirle probar estas características que no están habilitadas por defecto.

Las características se pueden habilitar de tres maneras:

Habilitar características al iniciar Rancher. Al instalar Rancher con una CLI, puede usar una bandera de característica para habilitar una característica por defecto.
Habilitar características desde la interfaz de usuario de Rancher yendo a la página de Ajustes.
Habilitar características con la API de Rancher después de instalar Rancher.

Cada característica tiene dos valores:

Un valor por defecto, que se puede configurar con una bandera de características o variable de entorno desde la CLI.
Un valor establecido, que se puede configurar con la API o la interfaz de usuario de Rancher

Si no se ha establecido ningún valor, Rancher utiliza el valor por defecto.

Debido a que la API establece el valor real y la línea de comandos establece el valor por defecto, eso significa que si habilita o deshabilita una característica con la API o la interfaz de usuario, anulará cualquier valor establecido con la línea de comandos.

Por ejemplo, si instala Rancher, luego establece una bandera de característica en verdadero con la API de Rancher, y luego actualiza la versión de Rancher con un comando que establece la bandera de característica en falso, el valor por defecto seguirá siendo falso, pero la característica seguirá habilitada porque se estableció con la API de Rancher. Si luego elimina el valor establecido (true) con la API de Rancher, configurándolo a NULL, se aplicará el valor por defecto (false). Consulta la página de banderas de características para más información.

Habilitando características al iniciar Rancher

Cuando instales Rancher, habilita la característica que desees con una bandera de características. El comando es diferente dependiendo de si estás instalando Rancher en un solo nodo o si estás realizando una instalación de Rancher en Kubernetes.

Habilitando características para instalaciones de Kubernetes

Los valores establecidos desde la API de Rancher anularán el valor pasado a través de la línea de comandos.

Al instalar Rancher con un gráfico de Helm, utiliza la opción --set. En el siguiente ejemplo, se habilitan dos características pasando los nombres de las banderas de características en una lista separada por comas:

helm install rancher rancher-prime/rancher \
  --namespace cattle-system \
  --set hostname=rancher.my.org \
  --set 'extraEnv[0].name=CATTLE_FEATURES'
  --set 'extraEnv[0].value=<FEATURE-FLAG-NAME-1>=true,<FEATURE-FLAG-NAME-2>=true'

Habilitando características para instalaciones en entorno aislado

Para realizar una instalación en entorno aislado de Rancher, añade un repositorio de Helm y descarga un gráfico de Helm, luego instala Rancher con Helm.

Cuando instales el gráfico de Helm, deberías pasar los nombres de las banderas de características en una lista separada por comas, como en el siguiente ejemplo:

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

Habilitando características para instalaciones de Docker

Al instalar Rancher con Docker, utiliza la opción --features. En el siguiente ejemplo, se habilitan dos características pasando los nombres de las banderas de características en una lista separada por comas:

docker run -d -p 80:80 -p 443:443 \
  --restart=unless-stopped \
  rancher/rancher:rancher-latest \
  --features=<FEATURE-FLAG-NAME-1>=true,<FEATURE-FLAG-NAME-2>=true

Habilitando características con la interfaz de usuario de Rancher

En la esquina superior izquierda, haz clic en ☰ > Configuración Global.
Haz clic en Banderas de características.
Para habilitar una característica, ve a la característica deshabilitada que deseas habilitar y haz clic en ⋮ > Activar.

Resultado: La característica está habilitada.

Deshabilitando características con la interfaz de usuario de Rancher

En la esquina superior izquierda, haz clic en ☰ > Configuración Global.
Haz clic en Banderas de características. Verás una lista de características experimentales.
Para desactivar una característica, ve a la característica habilitada que deseas desactivar y haz clic en ⋮ > Desactivar.

Resultado: La característica está desactivada.

Habilitando características con la API de Rancher

Diríjase al <RANCHER-SERVER-URL>/v3/features.
En la sección data, verás un array que contiene todas las características que se pueden activar con banderas de características. El nombre de la característica está en el campo id. Haz clic en el nombre de la característica que deseas habilitar.
En la esquina superior izquierda de la pantalla, bajo Operaciones, haz clic en Editar.
En el menú desplegable Valor, haz clic en Verdadero.
Haz clic en Mostrar Solicitud.
Haz clic en Enviar Solicitud.
Haz clic en Cancelar.

Resultado: La característica está habilitada.

Desactivando características con la API de Rancher

Diríjase al <RANCHER-SERVER-URL>/v3/features.
En la sección data, verás un array que contiene todas las características que se pueden activar con banderas de características. El nombre de la característica está en el campo id. Haz clic en el nombre de la característica que deseas habilitar.
En la esquina superior izquierda de la pantalla, bajo Operaciones, haz clic en Editar.
En el menú desplegable Valor, haz clic en Falso.
Haz clic en Mostrar Solicitud.
Haz clic en Enviar Solicitud.
Haz clic en Cancelar.

Resultado: La característica está desactivada.