Guía de la Sintaxis de GitHub Actions: Un Ejemplo Sencillo con ‘Hola Mundo’
Introducción
GitHub Actions ofrece una plataforma robusta para automatizar flujos de trabajo directamente desde tus repositorios de GitHub. Entender la sintaxis de GitHub Actions es fundamental para crear flujos de trabajo efectivos. En este blog, desglosaremos la sintaxis básica de GitHub Actions y presentaremos un ejemplo sencillo que ejecuta un script para mostrar el mensaje «Hola mundo».
Sintaxis Básica de GitHub Actions
Los flujos de trabajo en GitHub Actions se definen en archivos YAML ubicados en el directorio .github/workflows de tu repositorio. Aquí están los componentes principales de un archivo de workflow:
- name (nombre): Define un nombre para el flujo de trabajo. Este nombre es opcional pero útil para identificar diferentes flujos de trabajo.
- on (en): Especifica los eventos que desencadenan el flujo de trabajo, como
push,pull_request, oschedule. - jobs (trabajos): Define los trabajos que se ejecutarán en el flujo de trabajo. Cada trabajo puede contener múltiples pasos (steps).
- steps (pasos): Los pasos dentro de un trabajo que especifican las acciones a ejecutar.
Ejemplo Sencillo: Ejecutando un Script con «Hola Mundo»
Para ilustrar la sintaxis de GitHub Actions, crearemos un flujo de trabajo simple que ejecuta un script y muestra el mensaje «Hola mundo».
Paso 1: Crear el Archivo de Workflow
Primero, crea un archivo YAML en el directorio .github/workflows de tu repositorio. Nombra el archivo hola-mundo.yml.
name: Hola Mundo Workflow
on: [push]
jobs:
hello_world_job:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v2
- name: Run Hello World Script
run: echo "Hola mundo"
Desglose del Archivo YAML
- name: Hemos nombrado este flujo de trabajo como «Hola Mundo Workflow».
- on: Este flujo de trabajo se desencadenará en cada
pushal repositorio. - jobs: Hemos definido un solo trabajo llamado
hello_world_job.- runs-on: Especifica que el trabajo se ejecutará en el entorno
ubuntu-latest. - steps:
- Checkout code: Usa la acción
actions/checkout@v2para obtener el código del repositorio. - Run Hello World Script: Ejecuta el comando
echo "Hola mundo"en la línea de comandos.
- Checkout code: Usa la acción
- runs-on: Especifica que el trabajo se ejecutará en el entorno
Ejecución del Ejemplo
Una vez que hayas creado y guardado el archivo hola-mundo.yml en tu repositorio, cada vez que hagas un push, GitHub Actions ejecutará este flujo de trabajo. Puedes verificar la ejecución del flujo de trabajo en la pestaña «Actions» de tu repositorio en GitHub.
Conclusión
GitHub Actions proporciona una sintaxis sencilla y poderosa para definir flujos de trabajo automatizados. Con unos pocos pasos, puedes crear workflows que realicen diversas tareas, desde simples mensajes de «Hola mundo» hasta complejas integraciones y despliegues. Este ejemplo básico es un buen punto de partida para explorar las capacidades de GitHub Actions y empezar a automatizar tus procesos de desarrollo.
Enlaces de referencia: Workflow syntax for GitHub Actions
