Automatic Deployment con Github Webhooks

Introducción

Llamo Automatic Deployment al proceso que consiste en agilizar y automatizar el deploy de un sitio en cualquier plataforma. En el ejemplo que voy a presentar lo haré de forma local, pero se puede replicar en una máquina virtual.

Motivación

Cuando tenía que hacer el deploy de mi portfolio en Digital Ocean (o en su momento AWS) tenía que hacer siempre los mismos pasos repetitivos:

Hacer push de los cambios al repositorio
Ingresar por SSH a la máquina virtual
Dirigirme a la ruta del proyecto
Hacer pull de los últimos cambios
Instalar las dependencias
Hacer build
Reiniciar el administrador de procesos (PM2) para que se apliquen los últimos cambios

Eran muchos pasos, y siempre tenía que hacer los mismos. Esto me motivó a buscar una solución para ahorrarme pasos.

Solución

Con la ayuda de Github Webhooks, y un pequeño app hecha en node, pude reducir estos siete pasos a uno solo.

La solución que encontré, consistia en un server ubicado en la máquina virtual que se encargaba de 'escuchar' los eventos push que se hacían en la rama master de mi repositorio del Portfolio. Entonces cuando escuchaba que se le había hecho un push, ejecutaba un script para correr el build de mi portfolio, y realizar el deploy.

Paso a paso

Server para Webhook

Repositorio. Este servidor se encargará de manejar los payloads entrantes y ejecutar el script de deploy. Lo haremos en Node con Express.

Primero hacemos el set-up de npm en nuestro proyecto con npm init, luego instalamos express con npm install express.

Armamos un servidor básico:

const express = require('express');
const { exec } = require('child_process');

const app = express();
app.use(express.json());

const PORT =  5000;
const PRODUCTION_BRANCH = 'master';

app.post('/', (req, res) => {
    console.log('Recibo una request de Github...')
    const branch = req.body.ref.split('/')[2]

    console.log('Se hizo push en la rama', branch)
    if(branch === PRODUCTION_BRANCH) {
        exec('echo Realizo deploy...', (error, stdout, stderr) => {
            if (error) {
          console.error(`exec error: ${error}`);
          return;
        }
        console.log(stdout);
        console.error(stderr);
        });
    }

    res.sendStatus(200);
})

app.listen(PORT, () => {
    console.log(`Webhook server running on port ${PORT}`);
})

Vayamos por partes explicando el código.

Creamos una aplicación express e indicamos que vamos a utilizar un middleware para recibir JSON. Ese será el tipo en el que se enviará el payload.

const app = express();
app.use(express.json());

En PORT ponemos el puerto en el que correra el servior, y en BRANCH_EVENT la rama de producción. En este caso master.

const PORT =  5000;
const PRODUCTION_BRANCH = 'master';

Con app.post('/', le decimos a nuestra app de express que vamos a escuchar los POST en la ruta /. Luego en branch guardamos la rama en la que se está realizando el push. Esta información la voy a obtener del payload que nos envía Github. Acá podemos ver un ejemplo de un webhook payload. Luego preguntamos si la rama a la que se le hizo push es la rama de producción, en caso afirmativo ejecutamos el script que querramos. Estamos utilizando la función exec de child_process para ejecutar scripts.

app.post('/', (req, res) => {
    console.log('Recibo una request de Github...')
    const branch = req.body.ref.split('/')[2]

    console.log('Se hizo push en la rama', branch)
    if(branch === PRODUCTION_BRANCH) {
        exec('echo Realizo deploy...', (error, stdout, stderr) => {
            if (error) {
          console.error(`exec error: ${error}`);
          return;
        }
        console.log(stdout);
        console.error(stderr);
        });
    }

    res.sendStatus(200);
})

Este server estará en la máquina virtual junto al proyecto que querramos hacer deploy por medio de webhook. En mi caso lo voy a probar en local, para eso voy a levantar el server y exponerlo a internet. Esto lo podemos hacer con Localtunnel. Lo instalamos con npm y ejecutamos lt --port {PORT}. En PORT ponemos el puerto en el que correrá el servidor en nuestro local. En mi caso 5000. Una vez hecho esto, Localtunnel nos devolverá un link por consola que será al que le deberá pegar Github cuando se accione el evento que configuremos.

Una vez que levantamos Localtunnel, levantamos nuestro servidor.

Ya tenemos todo listo para configurar Github Webhook.

Github Webhooks

En el repositorio del proyecto que queremos que emita el evento, hay que dirigirse a la pestaña settings y webhooks. Dentro de ese lugar presionaremos Add webhook. Veremos los siguientes campos:

Payload URL: Aquí tendremos que ingresar la URL a la que se le enviará el payload. Aquí tendrás que ingresar la URL que te regresó Localtunnel, en mi caso: https://warm-firefox-91.loca.lt.
Content type: Este será el tipo de contenido que tendrá el payload. Seleccionaremos application/json.
Secret: Sirve para reconocer la request que enviará Github. Cuando se establece su token secreto, GitHub lo usa para crear una firma hasheada con cada payload. Para este ejemplo lo dejaremos vacío, pero en ambientes productivos recomiendo completerlo.

Quedaría así:

Lo guardamos.

Demo

Una vez que tenemos configurado los webhooks de nuestro repositorio, y el webhook server expuesto a internet, podremos probar si funciona o no haciendo un push en cualquier rama.

Si hacemos push en la rama de producción que indicamos en el código, debería salir un mensaje como 'Realizo deploy...'
Si hacemos push en otra rama que no sea la de producción, no saldrá el mensaje de 'Realizo deploy...'