Un endpoint de implementación de webhook pide a tu instancia de Looker que implemente los cambios de una rama de Git, un SHA de confirmación o un nombre de etiqueta, y que luego envíe los cambios a la versión de producción de tu proyecto. Consulta la sección Implementación con webhooks para ver los formatos de webhook de implementación de Looker. En la mayoría de los proyectos, Looker gestiona las integraciones de Git y despliega las actualizaciones en producción, por lo que no es necesario que configure un webhook de implementación.
Sin embargo, sí que debes usar un webhook de implementación para enviar los cambios al entorno de producción si se da alguna de las siguientes circunstancias:
- Envías actualizaciones a la rama de producción remota fuera del IDE de Looker, lo que es habitual en los flujos de trabajo de desarrollo con entornos de staging.
- Quieres usar un webhook para implementar con el modo de implementación avanzado, que te permite especificar la rama, el SHA de la confirmación o el nombre de la etiqueta que se usa en la versión de producción del proyecto de Looker.
- Has configurado tu proyecto de Looker con solicitudes de extracción de Git, lo que significa que tienes que activar un webhook de implementación una vez que combines una solicitud de extracción para enviar esos cambios a tu entorno de producción de Looker. La mayoría de los servicios de alojamiento de Git tienen formas de automatizar este proceso si añades el webhook a la interfaz de tu proveedor de Git.
Si eres administrador de Looker, puedes configurar el webhook de implementación para que requiera un secreto, de modo que solo las partes autorizadas puedan activarlo. Los desarrolladores de Looker que no sean administradores pueden ver la página Configuración del proyecto, pero no pueden cambiar las opciones que aparecen en ella.
Añadir un secreto de implementación
Looker admite secretos web para los siguientes proveedores de Git: GitHub, Bitbucket Server y GitLab.
Para definir un secreto de implementación de webhook en tu proyecto, sigue estos pasos:
- En Modo Desarrollo, abre tu proyecto y selecciona el icono de configuración en la barra de navegación del IDE para abrir el panel de configuración del proyecto.
- En el panel de configuración del proyecto, selecciona Configuración.
- Desplázate hasta la sección Secreto de implementación de webhook y haz clic en Definir secreto de webhook. Looker generará automáticamente un token secreto. Puedes usar este secreto generado automáticamente o escribir tu propio token secreto.
- Tanto si usas el secreto generado automáticamente como si creas uno propio, copia el secreto de implementación del webhook y pégalo en un archivo de texto para tenerlo a mano si necesitas añadirlo al webhook de tu repositorio. Asegúrate de copiarlo en este momento. Si abandonas o actualizas la página Configuración del proyecto, perderás el acceso al secreto de implementación del webhook y tendrás que cambiarlo o quitarlo para volver a acceder a tu proyecto.
- Haz clic en Guardar configuración del proyecto.
Ahora, el webhook de implementación de tu proyecto requiere este secreto. En los proyectos que usan una instancia de staging de Looker, debes incluir el secreto de implementación del webhook en el encabezado HTTP para poder implementar en producción. En los proyectos con integración de solicitudes de incorporación de cambios de Git, debes ir a la interfaz de tu proveedor de Git para añadir el secreto al webhook de tu repositorio.
Configurar el secreto del webhook de tu repositorio de Git
En los proyectos con integración de solicitudes de extracción de Git, si has añadido un secreto de webhook de implementación a tu proyecto de LookML, debes ir a la interfaz de tu proveedor de Git para añadir el secreto al webhook de tu repositorio. Por ejemplo, puedes hacerlo de la siguiente manera en GitHub:
Ve a la configuración del repositorio de tu proyecto en el sitio web de tu proveedor de Git.
NOTA: Si has configurado tu proyecto para la integración de Git, puedes usar la opción Ver proyecto en Git del menú Git de tu proyecto en Looker.
En la configuración de tu repositorio, haz clic en Webhooks.
Busca el webhook de tu proyecto de LookML y haz clic en el botón Editar.
En el campo Secreto, pega el secreto de implementación de webhook que has copiado de la sección Secreto de implementación de webhook de Looker.
Haz clic en Actualizar webhook.
Ahora es obligatorio indicar el secreto de webhook para implementar los cambios en la versión de producción de su proyecto. Si lo necesitas, puedes cambiar el secreto o quitarlo de tu proyecto.
Cambiar un secreto de implementación
Una vez que se haya añadido un secreto de implementación de webhook a tu proyecto, si eres administrador de Looker, puedes cambiar el secreto siguiendo estos pasos:
- En tu proyecto, selecciona el icono Configuración en la barra de navegación.
- Desplázate hasta la sección Webhook Deploy Secret (Secreto de implementación de webhook) y haz clic en Reset Secret (Restablecer secreto). Looker generará automáticamente un nuevo token secreto. Puedes usar este secreto generado automáticamente o escribir tu propio token secreto.
- Tanto si usas el secreto generado automáticamente como si creas uno propio, copia el secreto de implementación del webhook y pégalo en un archivo de texto para tenerlo a mano si necesitas añadirlo al webhook de tu repositorio. Asegúrate de copiarlo del portapapeles en este momento. Si abandonas o actualizas la página Configuración del proyecto, perderás el acceso al secreto de implementación del webhook y tendrás que volver a la página para cambiarlo o eliminarlo por completo.
- Haz clic en Guardar configuración del proyecto.
Si tu proyecto está configurado con la integración de solicitudes de extracción de Git, también debes ir a la interfaz de tu proveedor de Git para actualizar el secreto del webhook de tu repositorio.
Eliminar un secreto de implementación
Una vez que se haya añadido un secreto de implementación de webhook a tu proyecto, si eres administrador de Looker, puedes eliminarlo siguiendo estos pasos:
- En tu proyecto, selecciona el icono Configuración en la barra de navegación.
- Desplázate hasta la sección Webhook Deploy Secret (Secreto de implementación de webhook) y haz clic en Remove Secret (Quitar secreto). En este punto, puedes cancelar la operación y conservar el secreto de implementación haciendo clic en No quitar.
- Para eliminar permanentemente el secreto de implementación del webhook de tu proyecto, haz clic en Guardar configuración del proyecto.
Tu proyecto ya no necesita un secreto para el webhook de implementación. Si tu proyecto está configurado con la integración de solicitudes de extracción de Git, ahora puedes ir a la interfaz de tu proveedor de Git para eliminar el secreto del webhook de tu repositorio. Looker ya no comprobará si hay un secreto en el extremo del proveedor de Git, por lo que no pasa nada si el webhook de tu repositorio de Git sigue teniendo un secreto configurado. Si quieres eliminar el secreto de tu repositorio de Git, consulta Configurar el secreto del webhook de tu repositorio de Git para obtener información sobre cómo editar el secreto en la interfaz de un proveedor de Git.