Tab WebHook
El tab de webhook nos permite conectar Content Island con tu plataforma de despliegue de manera que podamos lanzar un flujo de build y deploy cada vez que se publique un contenido en un proyecto. Se soportan tres proveedores: GitHub, Netlify y Vercel.
Inicial
Inicialmente el tab está vacío y se muestra el botón Add New Webhook.
Al hacer clic, se despliega un menú con los tres proveedores disponibles:
- GitHub — lanza un evento de repositorio para iniciar el build.
- Netlify — llama a una build hook URL de Netlify.
- Vercel — llama a una deploy hook URL de Vercel.
Selecciona el proveedor que corresponda con tu plataforma de despliegue para continuar con su configuración.
GitHub
Una vez que seleccionas GitHub nos aparecen una serie de campos que tenemos que rellenar:
-
Nombre de organización: El nombre de la organización de GitHub a la que queremos enviar el webhook.
-
Nombre del repositorio: El nombre del repositorio de GitHub al que queremos enviar el webhook.
-
Github Token: El token de GitHub que nos permite autenticar el webhook. Este token lo tenemos que crear en GitHub, y es un token de acceso personal. Para crear un token de acceso personal tenemos que ir a la configuración de GitHub, y en la sección de Developer settings crear un nuevo token. Este token tiene que tener permisos de escritura en el repositorio al que queremos enviar el webhook.
-
Nombre Evento: El nombre del evento que queremos enviar al webhook. Este evento es el que se va a lanzar cuando se publique un contenido en el proyecto. Por ejemplo podemos poner “content-published”.
Netlify
Una vez que seleccionas Netlify nos aparecen una serie de campos que tenemos que rellenar:
-
Name: Un nombre descriptivo para identificar este webhook dentro de Content Island. Es un alias libre y no tiene que coincidir con nada en Netlify.
-
URL: La build hook URL que genera Netlify. La encontrarás en tu sitio de Netlify en Project configuration → Build & deploy → Build hooks → Add build hook. Trata esta URL como un secreto: cualquiera que la tenga puede disparar un deploy.
Vercel
Una vez que seleccionas Vercel nos aparecen una serie de campos que tenemos que rellenar:
-
Name: Un nombre descriptivo para identificar este webhook dentro de Content Island. Es un alias libre y no tiene que coincidir con nada en Vercel.
-
URL: La deploy hook URL que genera Vercel. La encontrarás en tu proyecto de Vercel en Settings → Git → Deploy Hooks → Create Hook. Trata esta URL como un secreto: cualquiera que la tenga puede disparar un deploy.
Ejemplo
Un ejemplo de como funciona esto: Navegar a video tutorial webhooks