Configurar Gitea Actions

Para configurar y tener listo Gitea Actions en un repositorio de Gitea, primeramente debe tener un Runner de Gitea Actions instalado en su servidor. Ademas de que si tiene un repositorio a nivel usuario necesita configurar su propio Runner, en caso de que tenga que poner un Runner a nivel organizacion, se debe configurar un Runner a nivel organizacion de igual manera, y estara disponible para todos los repositorios de la organizacion que tengan configurado el Runner.

Pero, antes que nada, que es un Runner? Un Runner es un agente que se ejecuta en un servidor y se encarga de ejecutar las tareas de Gitea Actions en un repositorio de Gitea. En otras palabras, el Runner es el encargado de recibir el Workflow de Gitea Actions y ejecutar las tareas definidas en el Workflow por medio de Docker.

Mientras que un Workflow es un archivo de configuracion que se encuentra en la carpeta .gitea/workflows de un repositorio de Gitea y que contiene las tareas que se deben ejecutar en un Runner de Gitea Actions.

Entiendendo entonces los conceptos basicos para usar Gitea Actions, a continuacion se describen los pasos necesarios para configurar y utilizar Gitea Actions en un repositorio de Gitea.

Configuracion de Gitea Actions

Para empezar a configurar Gitea Actions en un repositorio de Gitea, debe tener a la mano su REGISTRATION TOKEN, este lo puede encontrar en su organizacion o en su perfil con la ruta: settings/actions/runners (Puede variar la URL, pero solamente busque en configuracion o settings y busque la opcion de Actions). Una vez que tenga su REGISTRATION TOKEN guardelo y procedemos a ahora ir a nuestro servidor y configurar el Runner.

Configuracion del Runner

Para empezar con la configuracion, idealmente cree una carpeta en su servidor donde se alojara el Runner de Gitea Actions.

mkdir -p /opt/act_runner
cd /opt/act_runner

Dentro de la carpeta, descargue el Runner de Gitea Actions desde la pagina oficial de Gitea o desde el repositorio oficial de Gitea en GitHub (La URL de descarga puede variar pero la que dejare corresponde a la version 0.2.11).

wget https://dl.gitea.com/act_runner/0.2.11/act_runner-0.2.11-linux-amd64 -O act_runner

Una vez la descarga sea exitosa, cambie los permisos del archivo act_runner para que sea ejecutable.

chmod +x act_runner

Ahora necesita vincular el Runner con el servidor de Gitea y para ello necesita el REGISTRATION TOKEN que guardo anteriormente.

./act_runner register

Al ejecutar el comando anterior, se le pedira que ingrese la URL de su servidor de Gitea y el REGISTRATION TOKEN que guardo anteriormente, ademas de un nombre para el Runner y etiquetas si es requerido, en el caso de las etiquetas se recomienda dejarlo como ubuntu-latest para simplicidad en Gitea Actions.

Y eso es todo, su Runner esta configurado y listo para recibir Workflows de Gitea Actions y ejecutar las tareas definidas en el Workflow!

Escrito por: Omar Flores Salazar