Modo de implementación avanzada

Con la integración predeterminada de Git de Looker, los desarrolladores de Looker confirman sus cambios en su rama de desarrollo y, luego, combinan su rama de desarrollo en la rama de producción. Luego, cuando realizas la implementación en el entorno de Looker, Looker usa la confirmación más reciente en la rama de producción. (Consulta la página de documentación Usa el control de versión y realiza implementaciones para conocer el flujo de trabajo predeterminado de Git y otras opciones para implementaciones avanzadas de Git).

Para las implementaciones avanzadas de Git en las que no deseas que se use la confirmación más reciente en tu rama de producción para tu entorno de Looker, un administrador de Looker puede habilitar el modo de implementación avanzada. Cuando está habilitado, el modo de implementación avanzada permite que un desarrollador con deploy permiso especifique un SHA o una etiqueta de confirmación diferente para implementar en tu entorno de producción de Looker, en lugar de usar la confirmación más reciente en la rama de producción. Si deseas implementar una confirmación desde una rama diferente, puedes usar el webhook o el extremo de la API del modo de implementación avanzada.

El modo de implementación avanzada ayuda a consolidar repositorios en flujos de trabajo de desarrolladores de varios entornos, en los que cada entorno apunta a una versión diferente de una base de código. También brinda a uno o varios desarrolladores o administradores un mayor control sobre los cambios que se implementan en producción.

Cuando se habilita el modo de implementación avanzada, Looker no les solicita a los desarrolladores que implementen sus cambios en producción. En cambio, Looker les solicita a los desarrolladores que combinen sus cambios en la rama de producción. A partir de ahí, los cambios solo se pueden implementar de las siguientes maneras:

• Usa el administrador de implementación.
• Activa un webhook.
• Usa un extremo de la API.

Nota: En el caso de los proyectos que tienen habilitado el modo de implementación avanzada, si el proyecto nunca se implementó en producción, la implementación inicial en producción se debe realizar con el administrador de implementación. No puedes usar la API ni el webhook para la implementación inicial de un proyecto que tiene habilitado el modo de implementación avanzada. Después de la implementación inicial en producción (incluso si se implementó inicialmente sin el modo de implementación avanzada), puedes usar el webhook o la API para implementar los cambios posteriores en producción con el modo de implementación avanzada.

Habilita el modo de implementación avanzada

Para habilitar el modo de implementación avanzada, sigue estos pasos:

1. En el IDE de Looker, navega a la página Configuración del proyecto seleccionando el ícono de Configuración en el menú de íconos y, luego, la pestaña Configuración.
2. En la página Configuración del proyecto, selecciona la casilla de verificación junto a Habilitar el modo de implementación avanzada en la sección Implementación.
3. Selecciona el botón Guardar configuración del proyecto para guardar el cambio.

Control de versiones con el modo de implementación avanzada

Cuando se habilita el modo de implementación avanzada, la implementación en producción desde Looker ya no es una opción para los desarrolladores. En cambio, cuando el desarrollador realiza una confirmación, el botón Git le solicitará que combine sus cambios en la rama principal en lugar de solicitarle que realice la implementación en producción.

Los cambios se implementan en producción con un webhook, la API o el administrador de implementación.

Administrador de Deployment

En el caso de los proyectos con el modo de implementación avanzada habilitado, los desarrolladores de Looker que tienen el deploy permiso pueden usar el administrador de implementación para implementar una confirmación o etiqueta en su entorno de producción de Looker.

Para acceder al administrador de implementación, selecciona el ícono de Implementar en el menú de íconos.

El administrador de implementación muestra todas las confirmaciones y etiquetas que se implementaron anteriormente con el modo de implementación avanzada.

Nota: Como se describe en la sección Implementa una confirmación desde el administrador de implementación de esta página, puedes implementar una confirmación con o sin una etiqueta. Si implementas una confirmación con una etiqueta, el administrador de implementación muestra el SHA de etiqueta, que es diferente de un SHA de confirmación. Puedes usar el historial de confirmaciones de tu proyecto de Looker para ver el SHA de confirmación asociado con una etiqueta. De lo contrario, si implementas una confirmación sin una etiqueta, el administrador de implementación muestra el SHA de confirmación, que es el mismo que el SHA de confirmación que puedes ver en la interfaz de tu proveedor de Git o en el historial de confirmaciones de tu proyecto de Looker.

Si aún no usaste el modo de implementación avanzada para implementar una confirmación, haz clic en el botón Seleccionar confirmación para ver el historial de confirmaciones con las confirmaciones que tus desarrolladores de Looker combinaron en la rama de producción.

En el caso de los proyectos que usaron el modo de implementación avanzada para implementar una confirmación, el historial de confirmaciones también mostrará las etiquetas asociadas de una confirmación, si las hay, y indicará qué confirmación es la versión actual que se usa para la producción.

Si la rama de producción tiene confirmaciones más recientes que la confirmación implementada, el administrador de implementación muestra esta información y la confirmación más reciente que tus desarrolladores de Looker combinaron en la rama de producción.

Implementa una confirmación desde el administrador de implementación

Existen varias formas de implementar una confirmación desde el administrador de implementación:

1. Para implementar una confirmación que aún no se implementó, haz clic en el botón Seleccionar confirmación para seleccionar entre todas las confirmaciones que se combinaron en la rama de producción remota. (Si deseas implementar una confirmación desde una rama diferente, usa el webhook o el extremo de la API del modo de implementación avanzada).
2. Para implementar la confirmación combinada más recientemente en la rama de producción remota, haz clic en el botón Implementar más reciente.
3. Para implementar una confirmación o etiqueta que se implementó anteriormente, haz clic en el menú de tres puntos Opciones del administrador de implementación y, luego, en Implementar en producción.

Si eliges una confirmación que no se implementó anteriormente, el administrador de implementación mostrará el menú Implementar confirmación. Para implementar una confirmación desde el menú Implementar confirmación, sigue estos pasos:

1. Para implementar la confirmación sin asignarle una etiqueta, selecciona Implementar sin etiquetar y, luego, Implementar en el entorno. De lo contrario, mantén seleccionada la opción Etiquetar e implementar.

2. Especifica una etiqueta para la confirmación. Una etiqueta de Git marca la importancia de la confirmación en el historial del repositorio, como un número de versión o un nombre de versión. Ten en cuenta lo siguiente sobre las etiquetas de Git:

   • Las etiquetas de Git deben ser únicas dentro del repositorio de Git. No puedes usar la misma etiqueta para dos confirmaciones diferentes en tu repositorio.
   • Las etiquetas de Git no pueden contener espacios ni ciertos caracteres especiales. Consulta la documentación de referencia de Git para conocer las reglas para nombrar referencias en Git.

3. De manera opcional, puedes agregar una descripción para la etiqueta para proporcionar más detalles sobre la confirmación.

4. Selecciona Implementar en el entorno para implementar la confirmación en la versión de producción de tu instancia de Looker.

Una vez que implementes una confirmación, el administrador de implementación marcará la confirmación como la versión actual en tu entorno de producción de Looker.

Implementa con webhooks

En el caso de los proyectos con el modo de implementación avanzada, puedes usar el webhook de implementación para implementar cambios en producción.

Nota: Cuando se habilita el modo de implementación avanzada para un proyecto nuevo, debes usar el administrador de implementación para la implementación inicial del proyecto en producción. Una vez que tu proyecto se haya implementado en producción (incluso si se implementó inicialmente sin el modo de implementación avanzada), puedes usar el webhook de implementación para implementar los cambios posteriores en producción con el modo de implementación avanzada.

Para configurar el webhook de implementación, primero debes agregar un secreto de webhook para tu proyecto de Looker desde la página Configuración del proyecto. Agregar un secreto de webhook garantiza que solo las partes autorizadas puedan activar el webhook de implementación.

Hay dos webhooks disponibles para implementar cambios en producción con el modo de implementación avanzada habilitado. Un webhook es para implementar el encabezado de una rama y el otro es para implementar un SHA o una etiqueta de Git específicos.

El webhook para implementar el encabezado de una rama usa este formato:

<Looker URL>/webhooks/projects/<LookML project name>/deploy/branch/<Git branch name>

El webhook para implementar un SHA o una etiqueta de confirmación usa este formato:

<Looker URL>/webhooks/projects/<LookML project name>/deploy/ref/<commit SHA or tag>

Reemplaza la información entre corchetes angulares < > por la información específica de la dirección de tu instancia, el proyecto de LookML y el nombre de la rama o el SHA/etiqueta de confirmación. Este es un webhook de ejemplo para implementar el nombre de etiqueta v1.0 para el proyecto e_faa en la instancia de Looker docsexamples.dev.looker.com:

https://docsexamples.dev.looker.com/webhooks/projects/e_faa/deploy/ref/v1.0

Implementa con la API

En el caso de los proyectos con el modo de implementación avanzada, puedes usar la API de Looker para implementar cambios en producción.

Nota: Cuando se habilita el modo de implementación avanzada para un proyecto nuevo, debes usar el administrador de implementación para la implementación inicial del proyecto en producción. Una vez que tu proyecto se haya implementado en producción (incluso si se implementó inicialmente sin el modo de implementación avanzada), puedes usar la API para implementar los cambios posteriores en producción con el modo de implementación avanzada.

Para realizar la implementación con la API, el usuario de la API que realiza la llamada deberá tener permiso deploy. Consulta las páginas de documentación Autenticación de la API de Looker y Comienza a usar la API para obtener más información sobre la autenticación y el uso de la API de Looker.

Para realizar la implementación con la API, usa el deploy_ref_to_production extremo. Se puede llamar a este extremo de varias maneras diferentes. Los siguientes ejemplos son para los métodos HTTPS y SDK.

HTTPS

Nota: Cuando uses los siguientes ejemplos, asegúrate de reemplazar la información entre corchetes angulares < > por la información específica de la dirección de tu instancia, el proyecto de LookML, el nombre de la rama, el SHA o la etiqueta.

Para realizar la implementación manualmente con el extremo de API deploy_ref_to_production, consulta los siguientes ejemplos, que usan el método HTTPS. Para obtener más información y ejemplos de cómo llamar a la API de forma manual con solicitudes de CURL, consulta el archivo README de GitHub Cómo autenticarte en la API o usa el Explorador de APIs. Puedes instalar el Explorador de APIs en tu instancia de Looker desde el Looker Marketplace.

Usa los siguientes ejemplos en una solicitud HTTPS para implementar el encabezado de una rama o un SHA o una etiqueta de confirmación específicos a través del extremo de API deploy_ref_to_production:

Implementa el encabezado de una rama: <HOST_URL>/api/4.0/projects/<PROJECT_ID>/deploy_ref_to_production?branch=<BRANCH_NAME>

Implementa un SHA o una etiqueta de confirmación: <HOST_URL>/api/4.0/projects/<PROJECT_ID>/deploy_ref_to_production?ref=<SHA_OR_TAG>

SDK

Nota: Cuando uses los siguientes ejemplos, asegúrate de reemplazar la información entre corchetes angulares < > por la información específica de tu proyecto de LookML, el nombre de la rama, el SHA o la etiqueta.

Como alternativa, usa uno de los SDKs de Looker en lugar de realizar solicitudes manuales a la API. Los SDKs controlan los detalles de la autenticación, la serialización de parámetros y respuestas, y otras cuestiones.

La implementación con deploy_ref_to_production con el método SDK se ve de la siguiente manera:

Implementa el encabezado de una rama: deploy_ref_to_production(<PROJECT_ID>, {branch: <BRANCH_NAME>})

Implementa un SHA o una etiqueta de confirmación: deploy_ref_to_production(<PROJECT_ID>, {ref: <SHA_OR_TAG>})