Crear tu primer workflow en GitHub Actions es más sencillo de lo que parece: necesitas un script que imprima Hola, mundo en tu lenguaje favorito y un archivo YAML que lo ejecute automáticamente. Este reto te enseña a automatizar la ejecución de un archivo desde un repositorio, usando los conceptos base de jobs, runners y steps.

¿Qué necesitas para resolver el reto de Hola Mundo en GitHub Actions?

El reto tiene dos entregables claros y puedes completarlo en pocos minutos si ya manejas Git y GitHub a nivel básico [01:30].

• Un script que imprima Hola, mundo en el lenguaje que prefieras: print("Hola, mundo") en Python, console.log("Hola, mundo") en JavaScript o System.out.println("Hola, mundo") en Java.
• Un workflow file llamado hola_mundo.yml ubicado en .github/workflows.
• Dos pasos dentro del job: hacer checkout del repositorio y ejecutar el script desde la terminal.

La terminación .yml es obligatoria porque GitHub Actions solo reconoce archivos en formato YAML para correrlos como workflows [00:35].

¿Qué es un workflow file? Es un archivo YAML guardado en .github/workflows que define qué tareas automatizar, cuándo ejecutarlas y en qué tipo de servidor o runner correrlas.

¿Cómo se estructura el workflow file paso a paso?

La lógica es mínima: nombre, evento, job, runner y steps. Si tu archivo se llama main.py, el segundo paso sería tan simple como ejecutar python main.py en la terminal del runner.

Puedes partir desde cero o usar la plantilla Simple workflow que GitHub ofrece al hacer clic en New workflow dentro de la pestaña Actions [10:50]. Esa plantilla te entrega el esqueleto con:

• Un nombre de workflow.
• Una etiqueta on con los eventos que disparan la ejecución.
• Un job (puedes renombrarlo a hola-mundo).
• Pasos predefinidos, incluyendo el action de checkout, que clona el repositorio dentro del runner para que el script esté disponible.

¿Qué hace el action de checkout?

Es el paso más común en cualquier workflow: descarga el contenido del repositorio en el servidor donde correrá la automatización. Sin él, el runner no tendría acceso a tu archivo main.py ni a ningún otro archivo del proyecto.

¿Cómo usar el repositorio plantilla del curso?

El curso entrega un repositorio público que funciona como plantilla y contiene cinco retos progresivos que puedes terminar en menos de dos horas [02:45]. El enlace está en los recursos de la clase.

Para empezar, haz clic en Use this template y luego en Create a new repository. Te recomiendo dejarlo como público por una razón concreta: GitHub no cobra por el uso de GitHub Actions en repositorios públicos [04:25]. En repositorios privados tienes minutos gratuitos limitados y, al superarlos, necesitarás agregar una tarjeta de crédito o asumir costos adicionales.

¿Por qué dejar el repositorio público? Porque GitHub Actions es gratuito sin límite de minutos en repositorios públicos, mientras que los privados consumen una cuota mensual restringida.

Una vez creado el repositorio, un action automatizado genera una rama llamada Aprendiendo GitHub Actions y actualiza el README a medida que completas cada paso. Esto te permite trabajar en una rama distinta a main y abrir un pull request limpio con tus cambios.

¿Dónde editar los archivos sin salir del navegador?

Tienes tres caminos para crear el script y el workflow file:

• Clonar el repositorio en local y abrirlo en tu editor preferido.
• Usar GitHub Codespaces, presionando la tecla punto (.) sobre la pantalla del repositorio para abrir Visual Studio Code en el navegador.
• Crear archivos directamente desde la interfaz de GitHub con Add file > Create new file.

Cualquiera de las tres rutas te lleva al mismo resultado: un commit con tu script y otro con el hola_mundo.yml.

¿Cómo aprovechar el GitHub Marketplace para tu workflow?

El Marketplace de Actions reúne más de 17.000 actions creados por la comunidad [13:20], y puedes filtrarlos por categoría según lo que necesites automatizar.

Por ejemplo, si tu script es JavaScript y necesitas Node configurado en el runner, basta con buscar Setup Node environment, leer su documentación y copiar el bloque de ejemplo dentro de tu workflow file. Cada action en el Marketplace incluye:

• Descripción y casos de uso.
• Etiquetas y parámetros que recibe.
• Ejemplos de código listos para copiar y pegar.

Esta lógica de reutilización es la que convierte a GitHub Actions en una herramienta poderosa: no escribes automatizaciones desde cero, las combinas.

¿Qué entregas al terminar este reto?

Al final tendrás un pull request en la rama Aprendiendo GitHub Actions con dos archivos: el script de Hola, mundo y el hola_mundo.yml que lo ejecuta. Cuando el workflow corra exitosamente, habrás automatizado tu primera tarea con GitHub Actions.

Comparte tu solución en los comentarios y revisa cómo otros estudiantes resolvieron el reto en lenguajes distintos al tuyo. ¿Qué lenguaje vas a elegir para tu primer Hola, mundo automatizado?