Anclas, alias y plantillas

Un ancla (&nombre) marca un nodo y un alias (*nombre) lo reutiliza en otro lugar: el analizador entrega, en el sitio del alias, el mismo contenido. No es una copia con vida propia ni una referencia que se pueda sobrescribir a medias: es el nodo completo. Si alguien edita el bloque ancla, cambia el valor efectivo de todos los lugares que lo usan, incluidos los que están en otros trabajos y que no aparecen en el cambio revisado.

Para un auditor eso tiene una consecuencia práctica: una línea modificada dentro de una definición compartida tiene un alcance mayor que sus propias líneas. Abre pipeline.yaml y localiza dónde se definen las plantillas y dónde se usan.

La clave especial << (clave de fusión) mezcla el contenido de un alias dentro del mapa donde aparece, y es el mecanismo habitual de las plantillas. Es una extensión definida para YAML 1.1 y no todos los analizadores ni las plataformas de CI la aplican igual, así que antes de confiar en ella hay que comprobar que la herramienta que consume el archivo la soporta.

La consecuencia al leer es que un valor puede venir de una plantilla definida cuarenta líneas más arriba. La salida expandida del lab muestra el resultado de los dos primeros trabajos; el resto hay que deducirlo.

La clave de fusión admite una lista de alias. La definición del tipo merge de YAML 1.1 dice que cada mapa se fusiona en el orden de la lista y que las claves de los mapas que aparecen antes prevalecen sobre las de los que aparecen después. Además, una clave escrita explícitamente en el propio mapa prevalece sobre cualquier valor fusionado.

El orden dentro de los corchetes es, por tanto, una decisión de seguridad: invertirlo cambia el resultado sin cambiar ninguna de las dos plantillas.

Revisar un cambio sobre anclas con la mirada puesta solo en las líneas modificadas es mirar la mitad. Una buena revisión se hace en dos pasos: primero, qué trabajos usan el ancla tocada; segundo, qué valor efectivo tienen ahora, comparado con el de antes. La salida de un analizador que expande los alias lo hace visible sin tener que simularlo a mano.

La pregunta que sirve es siempre de efecto, no de texto: qué configuración reciben los usuarios de la plantilla.

Saber cuántos elementos dependen de una plantilla es lo que decide cuánto cuidado pide un cambio sobre ella. En pipeline.yaml el trabajo que usa la plantilla puede hacerlo con un alias suelto o dentro de una lista de alias.