Como ingeniero DevOps paso mucho tiempo endureciendo pipelines CI/CD. GitHub Actions es potente pero a veces hace falta automatización personalizada para cerrar el caso de uso. Recientemente me topé con un problema que parecía sencillo y que me empujó a profundizar en Bash. Aquí explico la solución, los trucos aprendidos y por qué ahora son parte de mi caja de herramientas de automatización.
El escenario era claro: recorrer todos los archivos cambiados en un pull request, ejecutar un script por servicio según qué directorios se tocaron y asegurar que cada script se ejecute una sola vez por servicio. Los primeros obstáculos fueron nombres de archivos y carpetas con espacios, guiones y caracteres especiales que provocaban división de palabras, cambios solapados en varias carpetas que había que deduplicar, y fallos con implementaciones ingenuas como for file in $(git diff ...) cuando aparecen espacios.
Requisitos: una solución Bash segura, idempotente y amigable con CI. Los pasos que seguí fueron los siguientes.
Paso 1 Obtener la lista de ficheros cambiados Empecé con git diff --name-only origin/main...HEAD y obtuve una lista separada por saltos de línea. Funcionaba hasta que aparecieron nombres con espacios.
Paso 2 Usar separación por NUL La clave fue dejar de depender de saltos de línea y pasar a separadores NUL. En sistemas Unix el carácter NUL nunca forma parte de un nombre de archivo válido, así que usar NUL como separador evita todo tipo de problemas con espacios, tabuladores, comillas o emojis. Herramientas como git, xargs y sort aceptan banderas para salida y entrada terminadas en NUL.
Paso 3 Extraer y deduplicar el directorio superior Convertí cada ruta al directorio de primer nivel y deduplicé la lista. En lugar de awk con comillas, una forma robusta y sin dependencias de comillas es usar cut. Una tubería que funcionó muy bien fue:
git diff --name-only -z origin/main...HEAD | xargs -0 -n1 dirname | cut -d/ -f1 | sort -u -z > changed_dirs.txt
Con esto se obtiene un listado deduplicado de directorios superiores separado por NUL que resiste cualquier carácter extraño en los nombres.
Paso 4 Ejecutar los scripts de forma segura en CI Para iterar y ejecutar por servicio opté por delegar en xargs en lugar de loops frágiles. De este modo se evita la mayor parte de la complejidad de lectura de delimitadores desde Bash y es totalmente compatible con los runners de GitHub Actions. Ejemplo de llamada directa:
git diff --name-only -z origin/main...HEAD | xargs -0 -n1 dirname | cut -d/ -f1 | sort -u -z | xargs -0 -I{} ./scripts/run-checks.sh {}
Esto asegura que ./scripts/run-checks.sh se invoque exactamente una vez por servicio detectado, sin romperse cuando un nombre de archivo contiene espacios o caracteres especiales.
Truco avanzado 1 NUL separado explicado Con salida NUL, los comandos trabajan con registros atómicos. Usar las opciones -z y -0 en git, sort y xargs es como cambiar un delimitador frágil por uno inquebrantable. En la práctica esto evita problemas en muchas tareas comunes: iterar datos estructurados que pueden contener espacios, procesar entradas de usuarios o nombres de ficheros, y manipular logs con delimitadores inusuales.
Truco avanzado 2 sustitución de procesos La sustitución de procesos permite tratar la salida de un comando como si fuera un archivo sin crear ficheros temporales. La sintaxis < <(comando) resulta útil para alimentar bucles o comparaciones sobre la marcha y mantiene los scripts limpios. Un uso típico por ejemplo es comparar listados sin crear archivos intermedios con diff <(ls dir1) <(ls dir2). En workflows ayuda a mantener el runner limpio y evita coste de I O adicional.
Fragmento final optimizado para GitHub Actions Un job simple que integra la idea anterior se vería así en esencia dentro del step run de un workflow YAML:
git diff --name-only -z origin/main...HEAD | xargs -0 -n1 dirname | cut -d/ -f1 | sort -u -z | xargs -0 -I{} ./scripts/run-checks.sh {}
Resumen de lecciones aprendidas No confiar en la presencia ni en la forma del espacio en CI. Usar separación por NUL con las opciones -z y -0 para robustez. Preferir pipelines que deduplican por directorio top level con tools como dirname y cut en lugar de confiar en separación por espacios. La sustitución de procesos ayuda a escribir scripts más limpios y a evitar ficheros temporales.
En Q2BSTUDIO aplicamos estas buenas prácticas cuando construimos pipelines de integración continua y despliegues automáticos para nuestros clientes. Somos una empresa de desarrollo de software y aplicaciones a medida especializada en soluciones personalizadas que incluyen inteligencia artificial, ciberseguridad y servicios cloud. Si buscas automatizar despliegues o chequeos por servicio, nuestro equipo trabaja con arquitecturas CI/CD seguras y escalables y puede integrar patrones como NUL separated processing en tus pipelines, además del desarrollo de software a medida y soluciones de Automatización de procesos.
Palabras clave que describen nuestra oferta: aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA y power bi. Si te interesan procesos de despliegue más robustos o integrar IA en tus pipelines, en Q2BSTUDIO podemos ayudarte a diseñar la solución adecuada.
¿Has tenido problemas con espacios o workflows multi servicio en GitHub Actions? Comparte tu experiencia y soluciones y seguimos la conversación.
