Configura y prueba una conexión de Git

Cuando creas un proyecto nuevo, este solo existe en Modo de desarrollo para permitirte desarrollar tu modelo en un entorno seguro que no afectará a otros usuarios. Cuando tengas todo listo para publicar tu proyecto, el siguiente paso es configurar una conexión de Git.

Configurar una conexión de Git para tu proyecto te permite implementar LookML en Modo de producción, lo que permite que otros usuarios exploren tu modelo de datos, creen paneles y agreguen LookML a tu modelo. Para una configuración más rápida, usa un repositorio simple. Si quieres obtener una integración de Git más sólida, crea tu propio repositorio de Git y sigue las instrucciones de esta página para conectarlo a tu instancia de Looker.

Integra Looker en Git

Looker usa Git para registrar cambios y administrar versiones de archivos. Cada proyecto de LookML corresponde a un repositorio de Git. Cada vez que un usuario está en Modo de desarrollo, está en su propia rama de Git.

Para la administración de archivos fuente de LookML, Looker se puede configurar con cualquier proveedor de Git que use una clave SSH o HTTPS para la autenticación. Los pasos generales son los mismos, independientemente de la plataforma que utilices. En esta página, se usa GitHub como ejemplo para conectar un proyecto de Looker a Git una vez que hayas creado un repositorio de Git.

Para acceder a las opciones de integración de Git, debes activar el Modo de desarrollo.

Puedes configurar la integración de Git mediante uno de los siguientes protocolos:

  • HTTPS: El protocolo de transferencia de hipertexto seguro. Con HTTPS, Looker accede a tu repositorio de Git con el nombre de usuario y la contraseña (o token de acceso) que proporcionas, como se describe en Conéctate a Git mediante HTTPS.
  • SSH: Secure Shell. Con SSH, Looker accede a tu repositorio de Git con una clave de implementación que generas a través del sitio web de tu proveedor de Git, como se describe en Conéctate a Git mediante SSH.

Conéctate a Git mediante HTTPS

Para los proyectos de LookML configurados con autenticación HTTPS, Looker se conecta a tu proveedor de Git con una o más cuentas de usuario que configuraste con el proveedor de Git. Looker usa un nombre de usuario y una contraseña (o un token de acceso) para acceder a tu proveedor de Git y realizar operaciones de Git en nombre de tus desarrolladores de LookML.

Si tu cuenta de Git usa autenticación de dos factores, puedes ir a tu proveedor de Git y crear tokens de acceso para usar en lugar de contraseñas. Ve a la publicación de Comunidad Cómo configurar una conexión HTTPS de Git con 2FA habilitada para ver las instrucciones sobre cómo crear tokens de acceso personal para proveedores comunes de Git.

Con la autenticación HTTPS, puedes configurar tu proyecto de LookML de modo que use una sola cuenta de Git para todo el proyecto, o bien puedes configurar el proyecto de modo que use las cuentas de Git individuales de tus desarrolladores para realizar sus operaciones de Git.

Ten en cuenta lo siguiente para la autenticación HTTPS de GitHub:

Autenticación HTTPS de una sola cuenta

Si configuras tu proyecto de LookML con una sola cuenta de Git, Looker usa esa cuenta para acceder a tu proveedor de Git y confirmar los cambios en nombre de los desarrolladores. Looker realiza estas confirmaciones con el nombre de usuario de Looker del desarrollador para que puedas saber qué desarrollador realizó cada confirmación. Puedes ver el historial de confirmaciones de tu proyecto en la interfaz de tu proveedor de Git o seleccionando la opción Historial en el menú de Git del IDE de Looker. Consulta Ejecuta comandos de Git en Looker para obtener más información sobre los menús de Git en Looker.

Para la autenticación HTTPS de cuenta única, la cuenta de usuario de Git que especifiques debe tener acceso de lectura y escritura a tu repositorio de Git. Tus propios desarrolladores de LookML no necesitan tener sus propias cuentas de usuario de Git.

Autenticación HTTPS de varias cuentas con atributos de usuario

Si configuras tu proyecto de LookML con varias cuentas, el proyecto de LookML usará la cuenta de Git individual de cada desarrollador de Looker para realizar operaciones de Git. También debes configurar una cuenta de usuario genérica de Git con, al menos, acceso de lectura que Looker usará para extraer la versión de producción de los archivos.

Se necesitan las siguientes tareas y requisitos para la autenticación de Git con atributos de usuario:

  • Cada uno de tus desarrolladores de LookML debe tener su propia cuenta de usuario con tu proveedor de Git. Cada cuenta de usuario de Git debe tener acceso de lectura y escritura al repositorio del proyecto.
  • El administrador de Looker debe configurar cuentas de usuario de Looker con atributos de usuario que correspondan al nombre de usuario y la contraseña de Git (o al token de acceso si las cuentas de usuario de Git tienen autenticación de dos factores).
  • Los atributos de usuario para las contraseñas de las cuentas de Git (o los tokens de acceso) deben estar ocultos. Cuando crees el atributo de contraseña o token de acceso, selecciona Sí en la opción Ocultar valores y, luego, ingresa la URL del proveedor de Git en el campo Lista de dominios permitidos.
  • Los atributos de usuario para el nombre y la contraseña de Git (o el token de acceso) se deben completar para cada desarrollador de Looker. Un administrador de Looker o un usuario de Looker pueden configurar los atributos de usuario.

En el siguiente ejemplo, se muestra la página de administrador Atributos de usuario, en la que un administrador de Looker configuró atributos de usuario para el nombre de usuario de Git y el token de acceso del usuario.

Tabla de la Página de administrador de atributos de usuario, en la que se muestran los atributos de usuario de tipo string github_token y github_username.

En el siguiente ejemplo, se muestra la página Cuenta de un usuario de Looker en la que el usuario ingresó sus credenciales de Git en los campos de atributos de usuario.

Configura la autenticación HTTPS de Git

Para configurar un proyecto de LookML con autenticación HTTPS de Git, sigue estos pasos:

  1. Obtén la URL HTTPS para tu repositorio de Git. En el caso de GitHub, para los repositorios nuevos (repositorios que aún no contienen ningún archivo), GitHub te mostrará la URL como parte de la configuración inicial. Asegúrate de seleccionar el botón HTTPS en la pestaña Código para obtener la URL HTTPS y, luego, selecciona el ícono Copiar URL en el portapapeles para copiarla en el portapapeles.

    En el caso de los repositorios de GitHub existentes (repositorios que ya contienen archivos), puedes ver la URL HTTPS si te diriges a la pestaña Code del repositorio y seleccionas el botón Code. Asegúrate de seleccionar el vínculo HTTPS. Puedes seleccionar el ícono Copiar URL en el portapapeles para copiar la URL HTTPS en tu portapapeles.

  2. Navega a tu proyecto de LookML y selecciona el ícono de Configuración en la barra de navegación.

  3. En la página Project Configuration, en la pestaña Configuration, ve al botón Configure Git (para proyectos nuevos) o al botón Reset Git Connection (para proyectos existentes que se conectaron a Git anteriormente).

  4. Selecciona el botón Configurar Git o Restablecer conexión de Git para abrir la página Configurar Git.

    Si restableces tu conexión de Git, se conservará el historial de Git de la rama principal. También conservará el historial de la rama personal de cada desarrollador de Looker una vez que extraiga, combine e implemente. Para conservar el historial de todas las ramas, consulta la página de prácticas recomendadas sobre la migración a un repositorio de Git nuevo.

  5. En la página Configura Git de Looker, pega la URL HTTPS para tu repositorio de Git en el campo URL del repositorio y, luego, selecciona Continuar.

    Looker detectará tu proveedor de Git y actualizará la ventana con información sobre tu repositorio de Git.

    Si Looker no detecta correctamente tu proveedor de Git, te pedirá que elijas uno de un menú desplegable.

  6. Selecciona tu opción de acceso de Git:

  7. En los campos Nombre de usuario y Contraseña/Token de acceso personal, ingresa las credenciales que usará tu proyecto de LookML para acceder a Git. Esto es obligatorio independientemente de tu configuración de acceso de Git:

    • Si seleccionaste Usar una combinación de nombre de usuario y contraseña/token de acceso personal único y constante, este es el nombre de usuario y la contraseña de Git (o el token de acceso) que usará tu instancia de Looker para todas las operaciones de Git. Esta cuenta de usuario de Git debe tener acceso de lectura y escritura a tu repositorio de Git.
    • Si seleccionaste Usar atributos de usuario para el nombre de usuario y la contraseña/el token de acceso personal, estos son el nombre de usuario y la contraseña de Git (o el token de acceso) que usará tu instancia de Looker para extraer la versión de producción del repositorio. Esta cuenta de usuario de Git debe tener, al menos, acceso de lectura a tu repositorio de Git.

    Si tu cuenta de Git usa autenticación de dos factores, o si estás usando GitHub (que requiere un token de acceso personal en lugar de una contraseña), puedes ir a tu proveedor de Git y crear tokens de acceso para usar en lugar de contraseñas. Ve a la publicación de Comunidad Cómo configurar una conexión HTTPS git con 2FA habilitada para ver las instrucciones sobre cómo crear tokens de acceso personal para proveedores comunes de Git.

  8. Si seleccionaste Usar atributos de usuario para el nombre de usuario y la contraseña/el token de acceso personal, Looker mostrará los menús desplegables Atributo de usuario de nombre de usuario y Atributo de usuario del token de acceso personal en la sección Credenciales del modo de desarrollo. Usa los menús desplegables para seleccionar los atributos de usuario para las credenciales de Git de un desarrollador individual.

    (los usuarios de Looker pueden editar los valores de los campos de sus atributos de usuario en la página Cuenta, o los administradores de Looker pueden editar los valores de los atributos de usuario de un usuario en la página de administrador de Usuarios).

  9. Selecciona el botón Continuar con la configuración.

Git ya está configurado para tu proyecto de LookML. Desde aquí, puedes validar tu LookML y, luego, crear la confirmación inicial y, luego, implementarla en producción para que tu proyecto esté disponible en Modo de producción. También puedes realizar lo siguiente:

Conéctate a Git mediante SSH

Con la autenticación SSH, creas una clave de implementación para tu proveedor de Git. Looker genera el par de claves SSH y muestra la clave pública en la IU, como se ve en el paso 4. Looker usa esa clave de implementación para acceder a tu proveedor de Git y confirmar cambios en nombre de los desarrolladores de Looker. Looker realiza confirmaciones con el nombre de usuario de Looker de un desarrollador para que puedas saber qué desarrollador realizó cada confirmación. Puedes ver el historial de confirmaciones de tu proyecto en la interfaz de tu proveedor de Git o seleccionando la opción Historial en el menú de Git del IDE de Looker. Consulta Ejecuta comandos de Git en Looker para obtener más información sobre los menús de Git en Looker.

Para configurar un proyecto de LookML con autenticación SSH de Git, sigue estos pasos:

  1. Abre tu proyecto o crea un proyecto de LookML nuevo.
  2. En tu proyecto, selecciona el ícono de Configuración en el menú del ícono de la izquierda para abrir la página Configuración del proyecto.

  3. En la página Project Configuration, realiza una de las siguientes acciones para abrir la página Configure Git:

    • Para un proyecto sin conexión de Git, selecciona el botón Configurar Git.
    • En el caso de un proyecto que ya está configurado con una conexión de Git, selecciona el botón Reset Git Connection.

    Si restableces tu conexión de Git, se conservará el historial de Git de la rama principal. También conservará el historial de la rama personal de cada desarrollador de Looker una vez que extraiga, combine e implemente. Para conservar el historial de todas las ramas, consulta la página de prácticas recomendadas sobre la migración a un repositorio de Git nuevo.

    Diagrama en el que se muestra el progreso desde la página de configuración del proyecto hasta la página de configuración de Git. Los proyectos nuevos mostrarán el botón Configurar Git, y los proyectos existentes mostrarán el botón Restablecer Git Connect, pero ambos botones llevarán a la página Configurar Git.

  4. Obtén la URL de SSH para tu repositorio de Git. Estos son los formatos para proveedores comunes de Git:

    • GitHub: git@github.com:<organization-name>/<repository-name>.git
    • GitHub Enterprise: git@example.com:<organization-name>/<repository-name>.git
    • Cloud Source Repositories: ssh://username@example.com@source.developers.google.com:2022/p/<project-id>/r/<repository-name>
    • GitLab: git@gitlab.com:<organization-name>/<repository-name>.git
    • Bitbucket: git@bitbucket.org:<organization-name>/<repository-name>.git
    • Obrador: ssh://username@example.com/diffusion/MYCALLSIGN/<repository-name>.git

    En el caso de GitHub, para repositorios nuevos (repositorios que aún no contienen ningún archivo), GitHub mostrará la URL SSH en la pestaña Código como parte de la configuración inicial. Asegúrate de seleccionar el botón SSH para obtener la URL de SSH y, luego, selecciona el ícono del portapapeles para copiarla en tu portapapeles.

    Para los repositorios de GitHub existentes (repositorios que ya contienen archivos), puedes ver la URL SSH si te diriges a la pestaña Code del repositorio y seleccionas el botón Code. Asegúrate de seleccionar el vínculo Usar SSH. Puedes seleccionar el ícono del portapapeles para copiarlo en el portapapeles.

  5. En la página Configura Git de Looker, pega la URL de SSH para tu repositorio de Git en el campo URL del repositorio y, luego, selecciona Continuar.

    Las URLs con puertos de Git personalizados o no estándar se pueden usar con Looker agregando el número de puerto no estándar a la URL de Git. Por ejemplo: ssh://git@corporate.git.server.com:22/myorganization/myproject.git

    Debes incluir el ssh:// para que esto funcione correctamente.

  6. Looker detectará tu proveedor de Git y mostrará una clave de implementación para tu repositorio. (Si Looker no detecta correctamente tu proveedor de Git, te pedirá que elijas una en un menú desplegable). Copia la clave de implementación en el portapapeles y, luego, selecciona el vínculo Deploy Key settings for your repositorio para abrir la página Deploy keys de GitHub a tu repositorio de GitHub.

  7. En la pestaña Configuración de GitHub, en la página Claves de implementación, selecciona el botón Agregar clave de implementación:

    GitHub muestra la página Implementar claves / Agregar nuevo.

  8. Agrega un título para la clave de implementación. El nombre no es importante, pero es posible que quieras incluir "Looker" y el título de tu proyecto para hacer un seguimiento en el futuro.

  9. Pega la clave de implementación que copiaste de Looker .

  10. Selecciona la opción Permitir acceso de escritura.

  11. Selecciona el botón Agregar clave. (en este punto, es posible que tu proveedor de Git te solicite ingresar la contraseña. Si es así, ingresa tu contraseña y, luego, selecciona Confirmar contraseña).

  12. GitHub mostrará todas las claves de implementación que se agregaron para tu repositorio.

  13. Vuelve a la ventana de Looker y, en la página Configurar Git, selecciona Probar y finalizar la configuración.

Desde aquí, puedes intentar configurar la clave de implementación nuevamente, o bien seleccionar Omitir pruebas y finalizar la configuración para mantener la configuración actual.

Git ya está configurado para tu proyecto de LookML. Desde aquí, puedes validar tu LookML y, luego, crear la confirmación inicial y, luego, implementarla en producción para que tu proyecto esté disponible en Modo de producción. También puedes realizar lo siguiente:

Configura un repositorio de Git vacío

Si aún no creaste un repositorio de Git remoto, o si solo quieres realizar la configuración rápida para que otros puedan beneficiarse de LookML, puedes configurar un repositorio de Git básico. Configurar un repositorio de Git vacío crea un repositorio de Git local en tu instancia de Looker, en lugar de conectarte a un repositorio remoto.

Cuando seleccionas la opción para crear un repositorio vacío, Looker crea el repositorio en tu servidor de Looker y, luego, inicia el historial de Git del repositorio.

Para configurar un proyecto de LookML con un repositorio de Git vacío, haz lo siguiente:

  1. Abre tu proyecto o crea un proyecto de LookML nuevo.
  2. En tu proyecto, selecciona el ícono de Configuración en el menú del ícono de la izquierda para abrir la página Configuración del proyecto.

  3. En la página Project Configuration, realiza una de las siguientes acciones para abrir la página Configure Git:

    • Para un proyecto sin conexión de Git, selecciona el botón Configurar Git.
    • En el caso de un proyecto que ya está configurado con una conexión de Git, selecciona el botón Reset Git Connection.

    Si restableces tu conexión de Git, se conservará el historial de Git de la rama principal. También conservará el historial de la rama personal de cada desarrollador de Looker una vez que extraiga, combine y, luego, implemente. Para conservar el historial de todas las ramas, consulta la página de prácticas recomendadas sobre la migración a un repositorio de Git nuevo.

  4. Selecciona Set up a bare warehouse instead en la parte inferior de la página Configure Git, que se encuentra arriba del botón Continue.

  5. En el diálogo Configure Bare Git Repository, selecciona Crear repositorio.

    Después de crear el repositorio de Git, Looker mostrará el diálogo Se creó el repositorio Bare.

Git ya está configurado para tu proyecto de LookML. Desde aquí, puedes validar tu LookML y, luego, crear la confirmación inicial y, luego, implementarla en producción para que tu proyecto esté disponible en Modo de producción. También puedes realizar lo siguiente:

En el caso de los proyectos que se configuraron con un repositorio vacío, luego puedes usar la opción para restablecer la conexión de Git si deseas conectar el proyecto a un proveedor de Git (consulta los procedimientos para usar HTTPS o SSH). Sin embargo, no te conectes a un repositorio de Git que ya tenga un historial de Git. Si configuraste tu proyecto de LookML con un repositorio vacío, Looker crea un repositorio en tu servidor de Looker y, luego, inicia el historial de Git del repositorio. Si luego conectas tu proyecto de LookML a un repositorio de Git que tiene un historial de Git, Looker no podrá conciliar los dos historiales de Git y tú no podrás realizar ninguna acción de Git.

Conecta un proyecto nuevo de LookML a un repositorio de Git que no esté vacío

Configurar Git para el control de versión es un paso clave para crear un nuevo proyecto de LookML. Por lo general, cada proyecto debería tener su propio repositorio. Sin embargo, es posible que debas configurar un proyecto con un repositorio de Git que contenga LookML existente, como en las siguientes situaciones:

  • Cuando trasladas un proyecto de LookML existente entre instancias
  • Cuando recuperas el código de un proyecto de LookML dañado o en desuso para usarlo en un proyecto nuevo

En esta sección, se describen las prácticas recomendadas para configurar un proyecto nuevo de LookML con un repositorio de Git existente y no vacío para un mayor desarrollo de LookML.

  1. Selecciona Blank Project como punto de partida para crear un nuevo proyecto de LookML. Un proyecto en blanco es el punto de partida porque se propagarán con objetos de LookML de un repositorio existente, en lugar de hacerlo a partir de un esquema de base de datos o una consulta en SQL.
  2. Configura Git para tu proyecto mediante HTTPS o SSH, con la URL del proyecto que no está vacío en la sección URL del repositorio de la página Configurar Git.
  3. Una vez que hayas configurado Git para tu proyecto, extrae de la producción desde el panel Git Actions.
  4. Una vez que hayas extraído del entorno de producción, selecciona Deploy to Production.

Los cambios que realices en LookML en tu proyecto no afectarán al repositorio original, sino que se guardarán en tu versión local del repositorio.

Si quieres usar un repositorio público específico como base de un proyecto en blanco de LookML, pero no tienes acceso de escritura a ese repositorio, sigue las instrucciones que se describen en la sección Cómo clonar un repositorio público de Git de la página de documentación Cómo crear un nuevo proyecto de LookML.

Si quieres configurar un flujo de trabajo de Git con un repositorio en varias instancias, consulta la publicación de Comunidad sobre el flujo de trabajo de Git con un solo repositorio en varias instancias (desarrollo, etapa de pruebas y producción) para obtener más información.

Cómo probar tu conexión de Git

Looker proporciona una prueba de conexión de Git para verificar la conexión de Git. La prueba de conexión de Git verifica que hayas configurado la URL de Git correcta y que Looker pueda acceder al host de Git . La prueba de conexión de Git también verifica que hayas proporcionado una clave de implementación de Git válida y que esta tenga acceso de escritura a tu repositorio de Git.

Si Looker no puede conectarse a tu repositorio de Git, el botón Git mostrará el texto Test Git Connection para solicitarte que soluciones los problemas de la conexión.

También puedes acceder a la herramienta de prueba de conexión de Git seleccionando Test Git Connection en el panel Git actions:

La herramienta de prueba de conexión de Git muestra los pasos necesarios para probar la conexión de Git:

  1. Examina git remote
  2. Se resolverá el nombre de host del servicio de Git
  3. Las herramientas de redes del servicio de Git están operativas
  4. Verifica las credenciales de autorización
  5. Asegúrate de que las credenciales permitan el acceso de escritura

Si un paso se realiza correctamente, Looker mostrará una marca de verificación verde a la izquierda del paso. Si un paso no funciona, Looker mostrará una marca de verificación roja a la izquierda del paso y un mensaje de error.

En el siguiente ejemplo, se muestra una prueba exitosa:

Cuadro de diálogo Git Connection Test en el que se muestra una lista de pasos con marcas de verificación verdes a su lado para indicar que todos los pasos se completaron correctamente

En el siguiente ejemplo, el repositorio de Git no tiene una clave de implementación configurada para la conexión de Looker. Las marcas de verificación verdes a la izquierda de los primeros tres pasos indican que estos pasos se realizaron con éxito:

  • Examine git remote
  • Host name for git service will resolve
  • Networking to the git service is operational

Las marcas de verificación rojas a la izquierda de los últimos dos pasos indican que estos pasos fallaron:

  • Verify authorization credentials
  • Ensure credentials allow write access

Cuadro de diálogo Git Connection Test en el que se muestra una lista de pasos correctos y fallidos. Un error en el paso Verificar credenciales de autorización indica No se puede usar la autenticación en el modo remoto (clave de implementación de Looker).