Un extremo de implementación de webhook le solicita a su instancia de Looker que implemente cambios desde una rama de Git, un SHA de confirmación o un nombre de etiqueta y, luego, envía los cambios a la versión de producción de su proyecto. Para la mayoría de los proyectos, Looker se encarga de las integraciones de Git y implementa actualizaciones para la producción, por lo que no es necesario configurar un webhook de implementación.
Sin embargo, debes usar un webhook de implementación para enviar los cambios a la producción si se da alguna de las siguientes circunstancias:
- Se envían 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 avanzado, que le permite especificar la rama, el SHA de confirmación o el nombre de la etiqueta que se usa para su versión de producción del proyecto de Looker.
- Configuró su proyecto de Looker con solicitudes de extracción de Git, lo que significa que debe activar un webhook de implementación una vez que fusione una solicitud de extracción para enviar esos cambios a su entorno de producción de Looker. La mayoría de los servicios de hosting de Git tienen maneras de automatizar este proceso 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 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 configurar 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ázate hacia abajo hasta la sección Secreto de implementación de webhook y, luego, haz clic en 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 uses el secreto generado automáticamente o que crees tu propio secreto, copia el secreto de implementación de webhook y pégalo en un archivo de texto para tenerlo si necesitas agregar el secreto al webhook para tu repositorio. Asegúrese de copiarla en este punto. Una vez que abandonas o actualizas la página Configuración del proyecto, pierdes acceso al secreto de implementación de webhook y deberás cambiar o quitar el secreto de implementación de webhook 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 el encabezado HTTP a fin de implementarlo en producción. Para los proyectos con integración de solicitud de extracción de Git, debes ir a la interfaz de tu proveedor de Git a fin de agregar el secreto al webhook para tu repositorio.
Configurando el secreto para el webhook de tu repositorio de Git
Para 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 a fin de agregar el secreto al webhook para tu repositorio. A modo de ejemplo, aquí te mostramos 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 del menú de Git de tu 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 Editar.
En el cuadro de texto Secreto, pegue el secreto de implementación del 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 necesario para implementar cambios en la versión de producción de tu proyecto. Si lo necesitas, 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 su proyecto, si es administrador de Looker, puede cambiar el secreto de la siguiente manera:
- En tu proyecto, selecciona el ícono Configuración en 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 nuevo token secreto. Puedes usar este secreto generado automáticamente o escribir tu propio token secreto.
- Ya sea que uses el secreto generado automáticamente o que crees tu propio secreto, copia el secreto de implementación de webhook y pégalo en un archivo de texto para tenerlo si necesitas agregar el secreto al webhook para tu repositorio. En este punto, asegúrate de copiarlo del portapapeles. Una vez que abandones o actualices la página Project Settings (Configuración del proyecto), perderás el acceso al secreto de implementación de webhook y deberás cambiarlo o quitarlo 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 de webhook de tu repositorio.
Quita un secreto de implementación
Una vez que se haya agregado un secreto de implementación de webhook a su proyecto, si es administrador de Looker, siga estos pasos para quitar el secreto:
- En tu proyecto, selecciona el ícono Configuración en 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 implementación haciendo clic en Don't Remove.
- Para quitar de forma permanente el secreto de implementación de webhook de tu proyecto, haz clic en Guardar configuración de proyecto.
Tu proyecto ya no requiere 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 quitar el secreto de webhook de tu repositorio. Looker ya no verificará un secreto del proveedor de Git, por lo que no dañará si el webhook de tu repositorio de Git aún tiene configurado un secreto. Si deseas quitar el secreto de tu repositorio de Git, consulta Configura el secreto para tu webhook de Git a fin de obtener información sobre cómo editar el secreto en la interfaz de un proveedor de Git.