Un extremo de implementación de webhook le indica a tu instancia de Looker que implemente los cambios desde una rama de Git, un SHA de confirmación o un nombre de etiqueta. Luego, envía los cambios a la versión de producción de tu proyecto. Para la mayoría de los proyectos, Looker maneja las integraciones de Git y, además, implementa actualizaciones de producción, por lo que no es necesario que configure un webhook de implementación.
Sin embargo, debe usar un webhook de implementación para enviar los cambios a la producción si se cumple alguna de las siguientes circunstancias:
- Envía actualizaciones a la rama de producción remota fuera del IDE de Looker, que es común en los flujos de trabajo de desarrollo con entornos de etapa de pruebas.
- Desea usar un webhook para implementar con el modo de implementación avanzada, que le permite especificar la rama, el SHA de confirmación o el nombre de etiqueta que se usa para su versión de producción del proyecto de Looker.
- Configuraste tu proyecto de Looker con solicitudes de extracción de Git, lo que significa que debes 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 hosting de Git tienen maneras de automatizar esto si agrega el webhook a la interfaz de su proveedor de Git.
Si eres administrador de Looker, puedes configurar el webhook de implementación para que requiera un secreto a fin de 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 allí.
Agrega un secreto de implementación
Para establecer un secreto de implementación de webhook en tu proyecto, haz lo siguiente:
- En Development Mode, abre tu proyecto y selecciona el ícono de configuración en la barra de navegación del IDE para abrir el panel de configuración del proyecto.
- Selecciona Configuración en el panel de configuración del proyecto.
- Desplácese hacia abajo hasta la sección Webhook Secret y, luego, haga clic en Set Webhook Secret. Looker generará automáticamente un token secreto. Puede usar este secreto generado automáticamente o escribir su propio token secreto.
- Ya sea que utilice el secreto generado automáticamente o cree uno propio, copie el secreto de implementación de webhook y péguelo en un archivo de texto para tenerlo si necesita agregar el secreto al webhook a su repositorio. Asegúrese de copiarlo en este momento. Una vez que abandone o actualice la página Configuración del proyecto, perderá el acceso al secreto de implementación de webhook y deberá cambiar o quitar el secreto de implementación de webhook para recuperar el acceso a su proyecto.
- Haz clic en Guardar configuración del proyecto.
El webhook de implementación para tu proyecto ahora requiere este secreto. Para los proyectos que usan una instancia de etapa de pruebas de Looker, debe incluir el secreto de implementación de webhook en su encabezado HTTP a fin de implementarlo en producción. Para los proyectos con integración de solicitud de extracción Git, debes ir a la interfaz de tu proveedor de Git a fin de agregar el secreto al webhook de tu repositorio.
Configura el secreto para el webhook de tu repositorio de Git
En el caso de los proyectos con integración de solicitud de extracción Git, si agregaste un secreto de webhook de implementación a tu proyecto de LookML, debes ir a la interfaz de tu proveedor de Git a fin de agregar el secreto al webhook para tu repositorio. A modo de ejemplo, así es como se hace mediante GitHub:
Navega a la configuración del repositorio de tu proyecto en el sitio web de tu proveedor de Git.
SUGERENCIA: Si configuró su proyecto para la integración en Git, puede usar la opción View Project on Git del menú de Git de su proyecto en Looker.
En la configuración de tu repositorio, haz clic en Webhooks.
Busque el webhook de su proyecto de LookML y, luego, haga clic en el botón Edit.
En el cuadro de texto Secreto, pegue el secreto de implementación de webhook que copió de la sección Secreto de implementación de webhook en Looker.
Haz clic en Actualizar webhook.
El secreto de webhook ahora es obligatorio para implementar cambios en la versión de producción de tu proyecto. Si es necesario, puedes cambiar el secreto o quitarlo de tu proyecto.
Cambia un secreto de implementación
Una vez que se agrega un secreto de implementación de webhook a tu proyecto, si eres administrador de Looker, puedes cambiar el secreto de la siguiente manera:
- En tu proyecto, selecciona el ícono Configuración de la barra de navegación.
- Desplázate hacia abajo hasta la sección Secreto de implementación de webhook y haz clic en Restablecer secreto. Looker generará automáticamente un token secreto nuevo. Puedes usar este secreto generado automáticamente o escribir tu propio token secreto.
- Si usa el secreto generado automáticamente o crea uno propio, copie el secreto de implementación de webhook y péguelo en un archivo de texto para tenerlo si necesita agregar el secreto al webhook a su repositorio. En este punto, asegúrate de copiarlo del portapapeles. Una vez que abandone o actualice la página Configuración del proyecto, perderá el acceso al secreto de implementación de webhook y deberá cambiarlo y quitarlo por completo.
- Haz clic en Guardar configuración del proyecto.
Si tu proyecto está configurado con la integración de solicitud de extracción Git, también debes ir a la interfaz de tu proveedor de Git para actualizar el secreto de webhook de tu repositorio.
Quita un secreto de implementación
Una vez que se agrega un secreto de implementación de webhook a tu proyecto, si eres administrador de Looker, puedes quitar el secreto de la siguiente manera:
- En tu proyecto, selecciona el ícono Configuración de la barra de navegación.
- Desplázate hacia abajo hasta la sección Secreto de implementación de webhook y haz clic en Quitar secreto. En este punto, puedes cancelar la operación y mantener el secreto de la implementación haciendo clic en No quitar.
- Para quitar de forma permanente el secreto de implementación de webhook de tu proyecto, haz clic en Guardar configuración del proyecto.
Tu proyecto ya no requiere un secreto para el webhook de implementación. Si tu proyecto está configurado con la integración de solicitud de extracción Git, ahora puedes ir a la interfaz de tu proveedor de Git para quitar el secreto de webhook de tu repositorio. Looker ya no verificará si hay un secreto del proveedor de Git, por lo que no hay problema si su webhook de repositorio de Git aún tiene un secreto configurado. Si deseas quitar el secreto de tu repositorio de Git, consulta Cómo configurar el Secret para el webhook de tu repositorio de Git a fin de obtener información sobre cómo editar el secreto en la interfaz de un proveedor de Git.