📦 Tener el código del repositorio

Hasta ahora hemos ejecutado workflows sencillos dentro de GitHub Actions, pero hay un problema evidente:

La máquina donde se ejecuta el workflow está vacía.

Si listamos los archivos disponibles al comenzar la ejecución, veremos que no existe ningún archivo de nuestro proyecto.

Sin el código del repositorio disponible, cualquier tarea relacionada con análisis, testing, despliegue o automatización resulta imposible.

Por eso, el siguiente paso fundamental consiste en descargar el contenido del repositorio dentro del workflow.

🚀 Recuperando los archivos del repositorio

La forma tradicional de obtener el código sería ejecutar un comando:

git clone <repositorio>

Sin embargo, GitHub proporciona acciones oficiales que realizan este trabajo automáticamente y de forma mucho más cómoda.

La acción más utilizada para este propósito es:

- name: Descargar código del repositorio
  uses: actions/checkout@v6

Con una sola línea obtenemos una copia del repositorio dentro de la máquina que ejecuta el workflow.

🔧 ¿Qué significa `uses`?

GitHub Actions permite reutilizar componentes llamados Actions.

Estas actions son bloques de trabajo ya preparados que encapsulan tareas frecuentes y que pueden ser utilizadas por cualquier workflow.

Por ejemplo:

uses: actions/checkout@v6

indica:

Que queremos utilizar una action externa.
Que la action pertenece a GitHub.
Que estamos utilizando la versión 6.

El sufijo @v6 permite especificar exactamente qué versión de la action queremos ejecutar.

♻️ Los workflows son reutilizables

Una de las ideas más importantes de GitHub Actions es la reutilización.

No solo puedes utilizar actions creadas por otras personas.

También puedes:

Crear tus propias actions.
Compartirlas con otros equipos.
Reutilizarlas en múltiples proyectos.

Esto permite construir automatizaciones complejas a partir de componentes ya existentes.

✅ ¿Qué hace realmente actions/checkout?

Aunque nosotros únicamente escribimos una línea:

uses: actions/checkout@v6

internamente GitHub ejecuta una gran cantidad de tareas:

Inicializa el repositorio local.
Configura Git.
Realiza el fetch del repositorio.
Descarga los archivos necesarios.
Deja el proyecto listo para trabajar.

Todo esto ocurre automáticamente sin necesidad de configurar cada paso manualmente.

⚙️ La action se puede configurar

La configuración básica suele ser suficiente para la mayoría de casos, pero actions/checkout admite múltiples opciones.

Por ejemplo, permite:

Descargar otro repositorio.
Obtener únicamente el último commit.
Controlar la profundidad del historial.
Personalizar el comportamiento del checkout.

Estas configuraciones avanzadas pueden consultarse en la documentación oficial cuando sean necesarias.

🏪 Existe un marketplace enorme de Actions

GitHub dispone de un ecosistema muy amplio de actions reutilizables.

Podemos encontrar acciones relacionadas con:

Seguridad.
Calidad del código.
Testing.
Inteligencia artificial.
Despliegues.
Generación de informes.
Automatización de tareas.

Incluso existen actions oficiales de distintas compañías para integrar sus propias herramientas dentro de los workflows.

📂 Verificando los archivos disponibles

Una vez ejecutado el checkout, el contenido del repositorio ya está presente dentro de la máquina del workflow.

Si volvemos a listar los archivos disponibles veremos:

Carpetas del proyecto.
Archivos fuente.
Configuración.
Recursos del repositorio.

Ahora sí disponemos de todo el contexto necesario para trabajar sobre el código.

🎯 El verdadero punto de partida

Tener el repositorio descargado marca el inicio real de cualquier automatización.

A partir de este momento podremos:

Ejecutar tests.
Analizar el código.
Generar builds.
Crear despliegues.
Ejecutar herramientas de IA.
Automatizar cualquier proceso relacionado con el proyecto.

Todo ello porque el workflow ya tiene acceso completo al código fuente.

📌 Ideas clave de esta clase

Quédate con estos conceptos:

Las máquinas de GitHub Actions comienzan vacías.
Necesitamos descargar el repositorio para trabajar sobre él.
actions/checkout es la action oficial para obtener el código.
uses permite reutilizar actions creadas por terceros.
@v6 indica la versión de la action.
Una sola línea ejecuta múltiples tareas internas automáticamente.
Existe un marketplace enorme de actions reutilizables.
El checkout es normalmente el primer paso de cualquier workflow real.
Tras el checkout ya podemos ejecutar tareas sobre nuestro proyecto.

🚀 Lo siguiente

Ahora que el workflow tiene acceso al código del repositorio, ya podemos empezar a construir automatizaciones útiles sobre nuestro proyecto.

A partir de aquí veremos cómo ejecutar acciones reales utilizando los archivos disponibles dentro del repositorio.

💡 Tip: En la mayoría de workflows reales, actions/checkout suele ser uno de los primeros pasos que se ejecutan. Sin el código del repositorio, la mayoría de automatizaciones simplemente no tienen nada sobre lo que trabajar.