Con la integración predeterminada de Git de Looker, los desarrolladores de Looker confirman los cambios en su rama de desarrollo y, luego, combinan su rama de desarrollo en la rama de producción. Luego, cuando realices una implementación en el entorno de Looker, Looker usará la confirmación más reciente en la rama de producción. (Consulta la página de documentación Cómo usar el control de versión e implementar para conocer el flujo de trabajo predeterminado de Git y otras opciones para las implementaciones avanzadas de Git).
En el caso de implementaciones avanzadas de Git en las que no quieres que se use la confirmación más reciente de tu rama de producción para tu entorno de Looker, un administrador de Looker puede habilitar el modo de implementación avanzado. Cuando se habilita, 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 de producción. Si quieres implementar una confirmación desde una rama diferente, puedes usar el webhook o el extremo de la API en el modo de implementación avanzado.
El modo de implementación avanzado ayuda a consolidar repositorios en flujos de trabajo de desarrolladores multientorno, 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 se habilita el modo de implementación avanzado, Looker no les solicita a los desarrolladores que implementen los cambios en la producción. En su lugar, Looker les solicita a los desarrolladores que combinen sus cambios en la rama production. Desde allí, los cambios solo se pueden implementar de las siguientes maneras:
- Mediante Deployment Manager
- Activar un webhook
- Mediante un extremo de API
Habilita el modo de implementación avanzado
Para habilitar el modo de implementación avanzado, sigue estos pasos:
- Navega a la pestaña Configuración de la página Configuración del proyecto. Para ello, selecciona el ícono Configuración en el menú de íconos.
- Selecciona la casilla de verificación junto a Habilitar el modo de implementación avanzada, en la sección Implementación.
- Selecciona el botón Save Project Configuration para guardar los cambios.
Control de versión con modo de implementación avanzado
Cuando se habilita el modo de implementación avanzado, la implementación en producción desde Looker ya no es una opción para los desarrolladores. En cambio, cuando el desarrollador realice una confirmación, el botón Git le pedirá que combine sus cambios en la rama principal, en lugar de solicitarle que implemente en producción.
Los cambios se implementan en producción mediante un webhook, la API o deployment Manager.
Deployment Manager
Para proyectos con el modo de implementación avanzado habilitado, los desarrolladores de Looker que tienen el permiso deploy pueden usar Deployment Manager para implementar una confirmación o una etiqueta en su entorno de producción de Looker.
Para acceder a Deployment Manager, selecciona el ícono Implementar en el menú de íconos.
Deployment Manager muestra todas las confirmaciones y las etiquetas que se implementaron anteriormente con el modo de implementación avanzado.
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 combinaron los desarrolladores de Looker con la rama de producción.
En el caso de los proyectos que usaron el modo de implementación avanzado para implementar una confirmación, el historial de confirmaciones también mostrará las etiquetas asociadas a la 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 de producción tiene confirmaciones más recientes que la confirmación implementada, Deployment Manager mostrará esta información y la confirmación más reciente que los desarrolladores de Looker combinaron con la rama de producción.
Implementa una confirmación desde Deployment Manager
Existen varias formas de implementar una confirmación desde Deployment Manager:
- Para implementar una confirmación que aún no se implementó, haz clic en el botón Seleccionar confirmación para seleccionar todas las confirmaciones que se combinaron con la rama de producción remota. Si quieres implementar una confirmación desde una rama diferente, usa el webhook o el extremo de la API en modo de implementación avanzado.
- Para implementar la confirmación combinada más reciente en la rama de producción remota, haz clic en el botón Implementar la última versión.
- Para implementar una confirmación o una etiqueta que se implementó anteriormente, haz clic en el menú de tres puntos Opciones en Deployment Manager y, luego, en Implementar en producción.
Si eliges una confirmación que no se haya implementado anteriormente, Deployment Manager mostrará el menú Implementar confirmación. Para implementar una confirmación desde el menú Implementar confirmación, sigue estos pasos:
- 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 Implementar y etiquetar (Tag and deploy).
Especifica una etiqueta para la confirmación. Una etiqueta Git marca el significado de la confirmación en el historial del repositorio, como un número o 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 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.
De manera opcional, puedes agregar una descripción para la etiqueta a fin de brindar más detalles sobre la confirmación.
Selecciona Implementar en el entorno para implementar la confirmación en la versión de producción de tu instancia de Looker.
Cuando implementes una confirmación, el Deployment Manager la marcará como la versión actual en tu entorno de producción de Looker.
Implementa con webhooks
En el caso de proyectos con modo de implementación avanzado, puedes usar el webhook de implementación para implementar cambios en producción.
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. Esto permite garantizar 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 es para implementar el encabezado de una rama y el otro es para implementar una etiqueta o SHA de Git específica.
El webhook para implementar el encabezado de una rama usa el siguiente formato:
<Looker URL>/webhooks/projects/<LookML project name>/deploy/branch/<Git branch name>
El webhook para implementar un SHA de confirmación o una etiqueta usa el siguiente formato:
<Looker URL>/webhooks/projects/<LookML project name>/deploy/ref/<commit SHA or tag>
Reemplaza la información entre corchetes < >v1.0 en 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
Implementa con la API
En proyectos con modo de implementación avanzado, puedes usar la API de Looker para implementar cambios en producción.
Para realizar la implementación con la API, el usuario de la API que realiza 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 realizar implementaciones con la API, usa el extremo deploy_ref_to_production. Se puede llamar a este extremo de varias maneras diferentes. Los siguientes ejemplos corresponden a los métodos HTTPS y SDK.
HTTPS
Para realizar la implementación de forma manual con el extremo de API de 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 manualmente a la API con solicitudes CURL, consulta el archivo readme de GitHub Cómo autenticar la API o usa el Explorador de API. 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 un SHA de confirmación o una etiqueta específica a través del extremo de API de 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 de confirmación o una etiqueta:
<HOST_URL>/api/4.0/projects/<PROJECT_ID>/deploy_ref_to_production?ref=<SHA_OR_TAG>
SDK
Como alternativa, puedes usar uno de los SDK de Looker en lugar de realizar solicitudes manuales a la API. Los SDK manejan los detalles de autenticación, serialización de parámetros y respuestas, y otros problemas.
La implementación con deploy_ref_to_production mediante el método del SDK se verá de la siguiente manera:
Implementa el encabezado de una rama:
deploy_ref_to_production(<PROJECT_ID>, {branch: <BRANCH_NAME>})
Implementa un SHA de confirmación o una etiqueta:
deploy_ref_to_production(<PROJECT_ID>, {ref: <SHA_OR_TAG>})