|
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. |
Visión general de plantillas de etiquetas
Elemental permite especificar plantillas de etiquetas en las secciones spec.machineInventoryLabels y spec.machineInventoryAnnotations de los recursos RegistroDeMáquina.
Su formato es el canónico key:value utilizado en las etiquetas y anotaciones de Kubernetes.
Estas plantillas de etiquetas se convierten en etiquetas y anotaciones reales adjuntas a cada recurso InventarioDeMáquina creado durante la fase de incorporación de máquinas.
Las etiquetas y anotaciones resultantes tienen el mismo key que la plantilla de etiquetas.
El value asociado se genera:
-
renderizando el
label template variables(si está presente) -
sanitizingel valor resultante (en el caso de las etiquetas solamente)
|
La funcionalidad de plantillas de Elemental también cubre el campo Registro de Máquina Consulta la sección Nombre de la Máquina para más detalles. |
Variables de plantillas de etiquetas
La funcionalidad de plantillas de etiquetas de Elemental incluye un conjunto de variables predefinidas que se pueden utilizar dentro del value de las plantillas de etiquetas especificadas en el Registro de Máquina.
La sintaxis utilizada para especificar las variables de las plantillas de etiquetas es:
${ VARFAMILY \/ VARPATH }
donde VARFAMILY define un grupo (familia) de variables soportadas y VARPATH define el nombre de la variable real dentro del grupo familiar correspondiente.
Elemental actualmente soporta las siguientes familias de variables de plantilla:
-
BIOS: ${ BIOS \/ VARPATH }
-
BaseBoard: ${ BaseBoard \/ VARPATH }
-
CPU: ${ CPU \/ VARPATH }
-
Chasis: ${ Chasis \/ VARPATH }
-
GPU: ${ GPU \/ VARPATH }
-
Memoria: ${ Memoria \/ VARPATH }
-
Red: ${ Red \/ VARPATH }
-
Producto: ${ Producto \/ VARPATH }
-
Tiempo de ejecución: ${ Tiempo de ejecución \/ VARPATH }
-
Almacenamiento: ${ Almacenamiento \/ VARPATH }
|
Todas las familias de variables de plantilla (pero `Random`) están habilitadas solo si el campo Registro de Máquina Cuando el campo Las variables aleatorias están siempre disponibles ya que están integradas en el lado del operador. También son especiales ya que se calculan solo una vez: consulta la sección Variables de plantilla aleatorias para más detalles. |
Las variables de plantilla se pueden mezclar con texto estático para formar las etiquetas reales asignadas a (Inventarios de Máquina).
|
Ejemplos de renderizado
|
Sanitización
Una vez que el valor de la plantilla de etiqueta ha sido renderizado de acuerdo con las variables de plantilla de etiqueta incluidas variables de plantilla de etiqueta, el valor resultante es sanitized antes de ser asignado a la etiqueta resultante.
El sanitization obliga a que el valor de la etiqueta solo contenga letras (mayúsculas o no), números y los caracteres guion (-), punto (.) y guion bajo (_):
Todos los caracteres no incluidos son sustituidos por un guion.
Cualquier carácter al principio y al final del valor de la etiqueta debe ser una letra o un número. Si no lo es, se elimina.
Dos guiones consecutivos son reemplazados por uno.
|
Ejemplo de Renderizado
|
Uso de Plantillas de Etiquetas
Las Plantillas de Etiquetas permiten adjuntar y actualizar automáticamente etiquetas y anotaciones a cada Inventario de Máquinas de los hosts cada vez que un host se registra en el Operador Elemental.
|
El registro ocurre no solo durante la fase de incorporación: cada host se vuelve a registrar cada 30 minutos (y cada vez que se reinicia). Durante la re-registración, las Plantillas de Etiquetas en el Registro de Máquina asociado son re-evaluadas y añadidas/actualizadas en el Inventario de Máquinas. |
Básicamente hay tres casos principales en los que las plantillas de etiquetas pueden ser útiles:
-
para adjuntar datos de hardware al Catálogo Elemental.
-
para añadir selectores para seleccionar hosts para el aprovisionamiento de clústeres.
-
para definir una plantilla personalizada para los nombres de máquinas.
Datos de hardware para el catálogo Elemental
Las variables de las Plantillas de Etiquetas pueden ser utilizadas para adjuntar datos de hardware a cada recurso de Inventario de Máquinas (que forman el Catálogo Elemental).
En este caso, las anotaciones pueden ser una mejor opción ya que sus valores no están sanitizados.
Selectores para la provisión de clústeres
El Label Templates se puede utilizar para generar etiquetas que se utilizan para identificar y seleccionar máquinas con propiedades de hardware especiales para formar nuevos clústeres de Kubernetes.
Las etiquetas adjuntas a cada Inventario de Máquinas son elegibles para selector para el recurso Plantilla de Selector de Inventario de Máquinas (ver la sección provisión de clústeres de Kubernetes para más detalles).
Nombres de máquinas personalizados
El nombre de host de la máquina de incorporación se puede especificar utilizando el campo Registro de Máquina spec.machineName.
El valor spec.machineName pasa por los mismos procesos de Label Templates' variables y sanitization reservados para el campo spec.machineInventoryLabels.
|
Hay una diferencia notable entre los campos Registro de Máquina |
Para más información sobre cómo definir el nombre de host para los hosts Elemental, consulta la sección Instrucciones/Personalizar nombre de host.
|
Ejemplo de renderizado
|