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.

Creación y revisión de plantillas RKE

Rancher Kubernetes Engine (RKE/RKE1) will reach end of life on July 31, 2025. Rancher 2.12.0 and later will no longer support provisioning or managing downstream RKE1 clusters. We recommend replatforming RKE1 clusters to RKE2 to ensure continued support and security updates. Learn more about the transition here.

Esta sección describe cómo gestionar las plantillas y revisiones de RKE. Puedes crear, compartir, actualizar y eliminar plantillas desde la vista de Gestión de Clústeres bajo Configuración de RKE1  Plantillas RKE.

Las actualizaciones de plantillas se gestionan a través de un sistema de revisiones. Cuando los propietarios de plantillas quieren cambiar o actualizar una plantilla, crean una nueva revisión de la plantilla. Las revisiones individuales no pueden ser editadas. Sin embargo, si deseas evitar que una revisión se utilice para crear un nuevo clúster, puedes desactivarla.

Las revisiones de plantillas pueden ser utilizadas de dos maneras: para crear un nuevo clúster o para actualizar un clúster que fue creado con una versión anterior de la plantilla. El creador de la plantilla puede elegir una revisión predeterminada, pero cuando los usuarios finales crean un clúster, pueden elegir cualquier plantilla y cualquier revisión de plantilla que esté disponible para ellos. Después de que el clúster es creado a partir de una revisión específica, no puede cambiar a otra plantilla, pero el clúster puede ser actualizado a una revisión más nueva disponible de la misma plantilla.

El propietario de la plantilla tiene control total sobre las revisiones de la plantilla, y puede crear nuevas revisiones para actualizar la plantilla, eliminar o desactivar revisiones que no deberían ser utilizadas para crear clústeres, y elegir qué revisión de plantilla es la predeterminada.

Requisitos previos

Puedes crear plantillas RKE si tienes el permiso de Crear Plantillas RKE, que puede ser otorgado por un administrador.

Puedes revisar, compartir y eliminar una plantilla si eres el propietario de la plantilla. Para detalles sobre cómo convertirte en propietario de una plantilla, consulta la documentación sobre compartir la propiedad de la plantilla.

Creación de plantillas

  1. En la esquina superior izquierda, haz clic en ☰ > Gestión de Clústeres.

  2. Haz clic en Configuración de RKE1  Plantillas de Nodo.

  3. Haz clic en Añadir Plantilla.

  4. Proporciona un nombre para la plantilla. Se proporciona automáticamente un nombre para la primera versión de la plantilla, que se crea junto con esta plantilla.

  5. Opcional: Comparte la plantilla con otros usuarios o grupos añadiéndolos como miembros. También puedes hacer que la plantilla sea pública para compartirla con todos en la configuración de Rancher.

  6. Luego, sigue el formulario en pantalla para guardar los parámetros de configuración del clúster como parte de la revisión de la plantilla. La revisión puede marcarse como predeterminada para esta plantilla.

Resultado: Se ha configurado una plantilla de RKE con una revisión. Puedes utilizar esta revisión de la plantilla de RKE más tarde cuando aprovisiones un clúster lanzado por Rancher. Después de que un clúster sea gestionado por una plantilla de RKE, no se puede desconectar y la opción para desmarcar Usar una plantilla y revisión de RKE existente no estará disponible.

Actualización de una plantilla

Cuando actualiza una plantilla de RKE, está creando una revisión de la plantilla existente. Los clústeres que se crearon con una versión anterior de la plantilla pueden actualizarse para coincidir con la nueva revisión.

No puede editar revisiones individuales. Dado que no puede editar revisiones individuales de una plantilla, para evitar que se use una revisión, puede desactivarla.

Cuando se crean nuevas revisiones de plantilla, los clústeres que utilizan una revisión anterior de la plantilla no se ven afectados.

  1. En la esquina superior izquierda, haz clic en ☰ > Gestión de Clústeres.

  2. En el menú de navegación de la izquierda, haz clic en Configuración de RKE1  Plantillas de RKE.

  3. Ve a la plantilla que deseas editar y haz clic en ⋮ > Editar.

  4. Edita la información requerida y haz clic en Guardar.

  5. Opcional: Puede cambiar la revisión predeterminada de esta plantilla y también cambiar con quién se comparte.

Resultado: La plantilla se ha actualizado. Para aplicarlo a un clúster que utiliza una versión anterior de la plantilla, consulte la sección sobre actualizar un clúster para usar una nueva revisión de una plantilla.

Supresión de una plantilla

Cuando ya no uses una plantilla RKE para ninguno de tus clústeres, puedes eliminarla.

  1. En la esquina superior izquierda, haz clic en ☰ > Gestión de Clústeres.

  2. Haz clic en Configuración de RKE1  Plantillas de RKE.

  3. Ve a la plantilla RKE que deseas eliminar y haz clic en ⋮ > Eliminar.

  4. Confirme la supresión.

Resultado: La plantilla se elimina.

Creación de una revisión basada en la revisión predeterminada

Puede clonar la revisión de plantilla predeterminada y actualizar rápidamente su configuración en lugar de crear una nueva revisión desde cero. Clonar plantillas te ahorra la molestia de volver a introducir las claves de acceso y otros parámetros necesarios para la creación de clústeres.

  1. En la esquina superior izquierda, haz clic en ☰ > Gestión de Clústeres.

  2. En el menú de navegación de la izquierda, haz clic en Configuración de RKE1  Plantillas de RKE.

  3. Ve a la plantilla RKE que deseas clonar y haz clic en ⋮ > Nueva revisión desde la predeterminada.

  4. Completa el resto del formulario para crear una nueva revisión.

Resultado: La revisión de la plantilla de RKE se clona y se configura.

Creación de una revisión basada en una revisión clonada

Al crear nuevas revisiones de plantilla de RKE desde la configuración de tu usuario, puedes clonar una revisión existente y actualizar rápidamente su configuración en lugar de crear una nueva desde cero. Clonar revisiones de plantilla te ahorra la molestia de volver a introducir los parámetros del clúster.

  1. En la esquina superior izquierda, haz clic en ☰ > Gestión de Clústeres.

  2. Bajo la configuración de RKE1, haz clic en Plantillas de RKE.

  3. Ve a la revisión de plantilla que deseas clonar. Luego selecciona ⋮ > Clonar revisión.

  4. Completa el resto del formulario.

Resultado: La revisión de la plantilla de RKE se clona y se configura. Puedes usar la revisión de la plantilla RKE más tarde cuando aprovisiones un clúster. Cualquier clúster existente que utilice esta plantilla de RKE puede actualizarse a esta nueva revisión.

Desactivación de una revisión de plantilla

Cuando ya no desees que se utilice una revisión de plantilla RKE para crear nuevos clústeres, puedes desactivarla. Una revisión desactivada puede ser reactivada.

Puedes desactivar la revisión si no está siendo utilizada por ningún clúster.

  1. En la esquina superior izquierda, haz clic en ☰ > Gestión de Clústeres.

  2. En el menú de navegación de la izquierda, haz clic en Configuración de RKE1  Plantillas de RKE.

  3. Ve a la revisión de plantilla que deseas desactivar. Luego selecciona ⋮ > Desactivar.

Resultado: La revisión de plantilla RKE no puede ser utilizada para crear un nuevo clúster.

Reactivando una revisión de plantilla desactivada

Si decides que una revisión de plantilla RKE desactivada debería ser utilizada para crear nuevos clústeres, puedes reactivarla.

  1. En la esquina superior izquierda, haz clic en ☰ > Gestión de Clústeres.

  2. Bajo la configuración de RKE1, haz clic en Plantillas de RKE.

  3. Ve a la revisión de plantilla que deseas reactivar. Luego selecciona ⋮ > Activar.

Resultado: La revisión de plantilla RKE puede ser utilizada para crear un nuevo clúster.

Estableciendo una revisión de plantilla como predeterminada

Cuando los usuarios finales crean un clúster utilizando una plantilla RKE, pueden elegir qué revisión utilizar para crear el clúster. Puedes configurar qué revisión se utiliza por defecto.

Para establecer una revisión de plantilla RKE como predeterminada,

  1. En la esquina superior izquierda, haz clic en ☰ > Gestión de Clústeres.

  2. En el menú de navegación de la izquierda, haz clic en Configuración de RKE1  Plantillas de RKE.

  3. Ve a la revisión de plantilla RKE que deseas establecer como predeterminada y haz clic en ⋮ > Establecer como Predeterminada.

Resultado: La revisión de plantilla RKE será utilizada como la opción predeterminada cuando se creen clústeres con la plantilla.

Supresión de una revisión de plantilla

Puedes eliminar todas las revisiones de una plantilla excepto la revisión predeterminada.

Para eliminar permanentemente una revisión,

  1. En la esquina superior izquierda, haz clic en ☰ > Gestión de Clústeres.

  2. En el menú de navegación de la izquierda, haz clic en Configuración de RKE1  Plantillas de RKE.

  3. Ve a la revisión de la plantilla RKE que deseas eliminar y haz clic en ⋮ > Eliminar.

Resultado: La revisión de la plantilla RKE se elimina.

Actualizando un clúster para usar una nueva revisión de plantilla

Esta sección asume que ya tienes un clúster que tiene una plantilla RKE aplicada.

Esta sección también asume que has actualizado la plantilla que el clúster está utilizando para que una nueva revisión de plantilla esté disponible.

Para actualizar un clúster para usar una nueva revisión de plantilla,

  1. En la esquina superior izquierda, haz clic en ☰ > Gestión de Clústeres.

  2. Ve al clúster que deseas actualizar y haz clic en ⋮ > Editar Configuración.

  3. En la sección Opciones del Clúster, haz clic en el menú desplegable para la revisión de plantilla, luego selecciona la nueva revisión de plantilla.

  4. Haz clic en Guardar.

Resultado: El clúster se actualiza para usar la configuración definida en la nueva revisión de plantilla.

Exportando un clúster en ejecución a una nueva plantilla y revisión RKE

Puedes guardar la configuración de un clúster existente como una plantilla RKE.

Esto exporta las configuraciones del clúster como una nueva plantilla RKE, y también vincula el clúster a esa plantilla. El resultado es que el clúster solo puede ser cambiado si la plantilla es actualizada, y el clúster se actualiza para usar una versión más nueva de la plantilla.

Para convertir un clúster existente para usar una plantilla RKE,

  1. En la esquina superior izquierda, haz clic en ☰ > Gestión de Clústeres.

  2. Ve al clúster que quieres convertir para usar una plantilla RKE y ⋮ > Guardar como Plantilla RKE.

  3. Introduce un nombre para la plantilla RKE en el formulario que aparece y haz clic en Crear.

Resultados: