Un extremo de implementación de webhook le indica 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 Implementación con webhooks para conocer los formatos de webhook de implementación de Looker). En la mayoría de los proyectos, Looker controla las integraciones de Git y despliega las actualizaciones en producción, por lo que no necesitas configurar un webhook de implementación.
Sin embargo, debes usar un webhook de implementación para enviar cambios a producción si se aplica alguna de las siguientes circunstancias:
- Envías 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 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 la 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 formas de automatizar esto 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 que aparecen allí.
Agrega un secreto de implementación
Looker admite Secrets web para los siguientes proveedores de Git: GitHub, Bitbucket Server y GitLab.
Para configurar un secreto de implementación de webhook en tu proyecto, haz lo siguiente:
- En el modo de desarrollo, 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 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 uses el secreto generado automáticamente o crees tu propio secreto, copia el secreto de implementación del webhook y pégalo en un archivo de texto para tenerlo si necesitas agregarlo al webhook de tu repositorio. Asegúrate de copiarlo en este punto. Una vez que abandones o actualices la página Configuración del proyecto, perderás el 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 Save Project Configuration.
El webhook de implementación para tu proyecto ahora requiere este Secret. Para los proyectos que usan una instancia de etapa de pruebas de Looker, debes incluir el secreto de implementación del webhook en tu encabezado HTTP para poder implementarlo en producción. En el caso de los proyectos con integración de solicitudes de extracción de 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 solicitudes 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 agregar el secreto al webhook de tu repositorio. A modo de ejemplo, así es como puedes 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 en Git, puedes usar la opción View Project on Git en 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 Actualizar webhook.
Ahora se requiere el secreto de webhook 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 agregue un secreto de implementación de webhook a tu proyecto, si eres administrador de Looker, puedes cambiarlo siguiendo estos pasos:
- En tu proyecto, selecciona el ícono de 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 uses el secreto generado automáticamente o crees tu propio secreto, copia el secreto de implementación del webhook y pégalo en un archivo de texto para tenerlo si necesitas agregarlo al webhook de tu repositorio. Asegúrate de copiarlo del 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 deberás volver y cambiarlo o quitarlo por completo.
- Haz clic en Save Project Configuration.
Si tu proyecto está configurado con la integración de solicitud de extracción de Git, también debes ir a la interfaz de tu proveedor de Git para actualizar el secreto del webhook para tu repositorio.
Quita un secreto de implementación
Una vez que se agregue un secreto de implementación de webhook a tu proyecto, si eres administrador de Looker, puedes quitarlo siguiendo estos pasos:
- En tu proyecto, selecciona el ícono de Configuración en la barra de navegación.
- Desplázate hasta la sección Webhook Deploy Secret y haz clic en Remove Secret. 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 Save Project Configuration.
Tu proyecto ya no necesita un secreto para el webhook de implementación. Si tu proyecto está configurado con la integración de solicitud 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 buscará un secreto en el proveedor de Git, por lo que no importa si el webhook de tu repositorio de Git aún tiene un secreto 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 para obtener información sobre cómo editar el secreto en la interfaz de un proveedor de Git.