Modo de implementación avanzada

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

Para implementaciones avanzadas de Git en las que no quieres que se use la confirmación más reciente en tu rama de producción en tu entorno de Looker, un administrador de Looker puede habilitar el modo de implementación avanzada. Cuando está habilitado, el modo de implementación avanzado permite que un desarrollador con permiso deploy especifique una etiqueta o SHA 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 production. Si quieres implementar una confirmación desde una rama diferente, puedes usar el modo de implementación avanzado de webhook o de extremo de API.

El modo de implementación avanzado 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 les brinda a uno o varios desarrolladores o administradores un mayor control sobre los cambios que se implementan en producción.

Cuando el modo de implementación avanzada está habilitado, Looker no solicita a los desarrolladores que implementen sus cambios en la producción. En cambio, Looker les pide a los desarrolladores que combinen sus cambios en la rama production. Desde allí, los cambios solo se pueden implementar de las siguientes maneras:

• Con deployment Manager
• Activa un webhook
• Mediante un extremo de API

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

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 Project Configuration seleccionando el ícono Settings en el menú de íconos y, luego, la pestaña Configuration.
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 versión con modo de implementación avanzado

Cuando se habilita el modo de implementación avanzada, los desarrolladores ya no pueden implementar en producción desde Looker. En cambio, cuando el desarrollador realice una confirmación, el botón de Git le pedirá que combine los cambios en la rama principal en lugar de pedirle que los implemente en producción.

Los cambios se implementan en producción a través de un webhook, la API o el Deployment Manager.

Deployment Manager

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

Puedes acceder a Deployment Manager seleccionando el ícono Deploy en el menú de íconos.

Deployment Manager muestra todas las confirmaciones y etiquetas que se implementaron previamente con el modo de implementación avanzada.

Nota: Como se describe en la sección Implementa una confirmación desde Deployment Manager en esta página, puedes implementar una confirmación con o sin una etiqueta. Si implementas una confirmación con una etiqueta, el administrador de implementaciones muestra el SHA de la etiqueta, que es diferente del SHA de la confirmación. Puedes usar el historial de confirmación 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, Deployment Manager mostrará 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 avanzado 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 hayan usado el modo de implementación avanzado para implementar una confirmación, el historial de confirmaciones también mostrará las etiquetas asociadas a una confirmación, si las hay, y también indicará qué confirmación es la versión actual que se usa para la producción.

Si la rama production tiene confirmaciones más recientes que la confirmación implementada, Deployment Manager muestra esta información y la confirmación más reciente que tus desarrolladores de Looker combinaron con la rama production.

Cómo implementar una confirmación desde el administrador de implementaciones

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

1. Para implementar una confirmación que aún no se implementó, haz clic en el botón Seleccionar confirmación para elegir 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 avanzado).
2. Para implementar la confirmación más reciente que se fusionó en la rama de producción remota, haz clic en el botón Implementar la versión más reciente.
3. Para implementar una confirmación o etiqueta que se implementó anteriormente, haz clic en el menú de tres puntos Options de Deployment Manager y, luego, en Deploy to Production.

Si eliges una confirmación que no se implementó anteriormente, Deployment Manager mostrará el menú Implementar confirmación. Para implementar una confirmación desde el menú Deploy Commit, sigue estos pasos:

1. Para implementar la confirmación sin asignarle una etiqueta, selecciona Implementar sin etiquetar y Implementar en el entorno. De lo contrario, mantén seleccionada la opción Etiquetar y, luego, 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 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 si quieres conocer las reglas para asignar nombres a referencias en Git.

3. De forma opcional, puedes agregar una descripción a la etiqueta para brindar 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 implementaciones la marcará como la versión actual en tu entorno de producción de Looker.

Implementa con webhooks

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

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

Para configurar el webhook de implementación, primero debes agregar un secreto de webhook para tu proyecto de Looker en 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 avanzado habilitado. Un webhook sirve para implementar el encabezado de una rama y el otro, para implementar una etiqueta o SHA de Git específica.

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 una etiqueta o un SHA de confirmación usa este formato:

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

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

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

Implementación con la API

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

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

Para implementar con la API, el usuario de la API que realice la llamada deberá tener el 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 implementar con la API, usa el extremo deploy_ref_to_production. 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 tu dirección de instancia, proyecto de LookML, nombre de rama, SHA o etiqueta.

Para implementar de forma manual con el extremo de API de deploy_ref_to_production, consulta los siguientes ejemplos, en los que se usa el método HTTPS. Para obtener más información y ejemplos de llamadas manuales a la API mediante solicitudes 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 Looker Marketplace.

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

Implementa la cabeza 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 < > 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 inquietudes.

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

Implementa la cabeza 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>})