Un extremo de implementación de webhook le solicita a tu instancia de Looker que implemente cambios desde una rama de Git, un SHA de confirmación o un nombre de etiqueta y, luego, envíe los cambios a la versión de producción de tu proyecto. (Consulta la sección Implementa con webhooks para conocer los formatos de webhooks de implementación de Looker). Para la mayoría de los proyectos, Looker maneja las integraciones de Git y implementa actualizaciones en producción, por lo que no necesitas configurar un webhook de implementación.
Sin embargo, sí debes usar un webhook de implementación para enviar los cambios a producción si se aplica alguna de las siguientes circunstancias:
- Envía actualizaciones a la rama de producción remota fuera del IDE de Looker, lo que es común en los flujos de trabajo de desarrollo con entornos de etapa de pruebas.
- Quieres usar un webhook para implementar con el modo de implementación avanzado, que te permite especificar la rama, el SHA de confirmación o el nombre de la etiqueta que se usa para tu 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 combinas 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 formas de automatizarlo si agregas 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 son administradores pueden ver la página Configuración del proyecto, pero no pueden cambiar las opciones allí.
Agrega un secreto de implementación
Looker admite secretos web para los siguientes proveedores de Git: GitHub, Bitbucket Server y GitLab.
Para configurar un secreto de implementación de webhook en tu proyecto, sigue estos pasos:
- 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ázate hasta la sección Secreto de implementación de webhook y, luego, haz clic en Configurar secreto de webhook. Looker generará automáticamente un token secreto. Puedes usar este secreto generado automáticamente o escribir tu propio token secreto.
- Ya sea que estés usando el secreto generado automáticamente o creando uno propio, copia el secreto de implementación de webhook y pégalo en un archivo de texto para que lo tengas si necesitas agregar el secreto al webhook de tu repositorio. Asegúrate de copiarlo en este punto. Una vez que salgas de la página Configuración del proyecto o la actualices, perderás el acceso al secreto de implementación de webhook y deberás cambiarlo o quitarlo para recuperar el acceso a tu 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, debes incluir el secreto de implementación de webhook en tu encabezado HTTP para implementar en producción. En el caso de los proyectos con la integración de solicitud de extracción Git, debes ir a la interfaz de tu proveedor de Git para 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 de 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 para agregarlo al webhook de tu repositorio. A modo de ejemplo, aquí se muestra cómo hacerlo con GitHub:
Navega a la configuración del repositorio de tu proyecto en el sitio web de tu proveedor de Git.
SUGERENCIA: Si configuraste tu proyecto para la integración de Git, puedes usar la opción Ver proyecto en Git desde el menú de Git de tu proyecto en Looker.
En la configuración del repositorio, haz clic en Webhooks.
Busca el webhook de tu proyecto de LookML y, luego, haz clic en el botón Editar.
En el campo Secreto, pega el secreto de implementación de webhook que copiaste de la sección Secreto de implementación de webhook en Looker.
Haz clic en Update 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 cambiarlo de la siguiente manera:
- En tu proyecto, selecciona el ícono Configuración en la barra de navegación.
- Desplázate hasta la sección Secreto de implementación de webhook y haz clic en Restablecer secreto. Looker generará automáticamente un nuevo token secreto. Puedes usar este secreto generado automáticamente o escribir tu propio token secreto nuevo.
- Ya sea que estés usando el secreto generado automáticamente o creando uno propio, copia el secreto de implementación de webhook y pégalo en un archivo de texto para que lo tengas si necesitas agregar el secreto al webhook de tu repositorio. Asegúrate de copiarlo desde el portapapeles en este punto. Una vez que salgas de la página Configuración del proyecto o la actualices, perderás el acceso al secreto de implementación del webhook y tendrás que volver a cambiarlo o 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 quitarlo de la siguiente manera:
- En tu proyecto, selecciona el ícono Configuración en la barra de navegación.
- Desplázate 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 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 buscará un secreto del proveedor de Git, por lo que no generará ningún impacto si tu webhook de repositorio de Git todavía tiene uno configurado. Si quieres quitar el secreto de tu repositorio de Git, consulta Cómo configurar el secreto 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.