Configura y prueba una conexión de Git

Cuando creas un proyecto nuevo, solo existe en el Modo de desarrollo para que puedas desarrollar tu modelo en un entorno seguro que no afecte 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 tu LookML en el 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 sin procesar. Para 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.

Cómo integrar Looker con 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, se encuentra en su propia rama de Git.

Para la administración de archivos de origen 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 sin importar la plataforma que uses. 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 tener activado el modo de desarrollo.

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

  • HTTPS: Protocolo de transferencia de hipertexto seguro. Con HTTPS, Looker accede a tu repositorio de Git con un nombre de usuario y una contraseña (o un token de acceso) que proporcionas, como se describe en Cómo conectarse a Git con 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 Cómo conectarse a Git con SSH.

Cómo conectarse a Git con HTTPS

En el caso de 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 tu 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 la autenticación de dos factores, puedes ir a tu proveedor de Git y crear tokens de acceso para usarlos en lugar de contraseñas. Ve a la publicación de la comunidad Configura una conexión HTTPS a Git con 2FA habilitado para ver 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 para que use una sola cuenta de Git para todo el proyecto, o bien puedes configurar el proyecto para 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 confirmación de tu proyecto en la interfaz de tu proveedor de Git o seleccionando la opción History en el menú Git del IDE de Looker. Consulta Cómo ejecutar 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 una sola cuenta, la cuenta de usuario de Git que especifiques debe tener acceso de lectura y escritura a tu repositorio de Git. Los desarrolladores de LookML no necesitan tener sus propias cuentas de usuario de Git.

Autenticación HTTPS de varias cuentas con atributos del usuario

Si configuras tu proyecto de LookML con varias cuentas, este 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 el 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 la cuenta 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 entidades permitidas de dominio.
  • Los atributos de usuario para el nombre y la contraseña de Git (o el token de acceso) deben completarse para cada desarrollador de Looker. Los atributos de usuario pueden ser configurados por un administrador de Looker o por el usuario de Looker.

En el siguiente ejemplo, se muestra la página Administrador de atributos del 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 en la página Administrador de atributos de usuario que muestra los atributos de usuario de tipo de cadena 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 del usuario.

Cómo configurar la autenticación de Git HTTPS

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

  1. Obtén la URL HTTPS de 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 Code para obtener la URL HTTPS y, luego, selecciona el ícono Copy URL to clipboard para copiarla en el portapapeles.

    En el caso de los repositorios de GitHub existentes (repositorios que ya contienen archivos), puedes ver la URL HTTPS. Para ello, ve a la pestaña Code del repositorio y selecciona 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 el 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 ya se conectaron a Git).

  4. Selecciona el botón Configure Git o Reset Git Connection para abrir la página Configure Git.

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

  5. En la página Configurar Git de Looker, pega la URL HTTPS de 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 una opción 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 la configuración de acceso de Git:

    • Si seleccionaste Usar una combinación única y constante de nombre de usuario y contraseña o token de acceso personal, estos son el nombre de usuario y la contraseña (o el token de acceso) de Git 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 o el token de acceso personal, estos son el nombre de usuario y la contraseña (o el token de acceso) de Git que usará tu instancia de Looker para extraer la versión de producción del repositorio. Esta cuenta de usuario de Git debe tener, como mínimo, acceso de lectura a tu repositorio de Git.

    Si tu cuenta de Git usa la autenticación de dos factores o si usas 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 usarlos en lugar de contraseñas. Ve a la publicación de la comunidad Configura una conexión HTTPS a Git con 2FA habilitado para ver 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/token de acceso personal, Looker mostrará los menús desplegables Atributo de usuario de nombre de usuario y Atributo de usuario de token de acceso personal en la sección Credenciales del modo de desarrollo. Usa los menús desplegables para seleccionar los atributos del usuario de las credenciales de Git de un desarrollador individual.

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

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

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

Cómo conectarse a Git con SSH

Con la autenticación de 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 los 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 confirmación de tu proyecto en la interfaz de tu proveedor de Git o seleccionando la opción History en el menú Git del IDE de Looker. Consulta Cómo ejecutar 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 de SSH Git, sigue estos pasos:

  1. Abre tu proyecto o crea un proyecto de LookML nuevo.
  2. En tu proyecto, selecciona el ícono Configuración en el menú de íconos 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 Restablecer conexión de Git.

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

    Diagrama que muestra la progresión de la página Configuración del proyecto a la página Configurar Git. Los proyectos nuevos mostrarán un botón para configurar Git, y los proyectos existentes mostrarán un botón para restablecer la conexión de Git, pero ambos botones dirigen a la página para configurar Git.

  4. Obtén la URL de SSH de tu repositorio de Git. Estos son los formatos de los 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
    • Phabricator: ssh://username@example.com/diffusion/MYCALLSIGN/<repository-name>.git

    En el caso de GitHub, para los repositorios nuevos (repositorios que aún no contienen ningún archivo), GitHub mostrará la URL de SSH en la pestaña Code 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 el portapapeles.

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

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

    Para usar URLs con puertos Git personalizados o no estándar con Looker, agrega 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 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, se te pedirá que elijas una opción de un menú desplegable). Copia la clave de implementación en el portapapeles y, luego, selecciona el vínculo Configuración de la clave de implementación para tu repositorio para abrir la página Claves de implementación 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 Deploy keys / Add new.

  8. Agrega un título para la clave de implementación. El nombre no es importante, pero te recomendamos que incluyas "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 que ingreses tu 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 a tu repositorio.

  13. Regresa a la ventana de Looker y, en la página Configure Git, selecciona Test and Finalize Setup.

Desde aquí, puedes volver a intentar configurar la clave de implementación o seleccionar Omitir pruebas y finalizar la configuración para conservar la configuración actual.

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

Cómo configurar un repositorio de Git sin formato

Si aún no creaste un repositorio de Git remoto o si solo quieres configurarlo rápidamente para que otras personas puedan beneficiarse de tu LookML, puedes configurar un repositorio de Git sin formato. Si configuras un repositorio de Git sin procesar, se creará un repositorio de Git local en tu instancia de Looker, en lugar de conectarse a un repositorio remoto.

Cuando seleccionas la opción para crear un repositorio sin formato, Looker lo crea en tu servidor de Looker y comienza el historial de Git para el repositorio.

Cuando creas un proyecto nuevo durante el proceso de generación de un modelo, el proyecto se configura automáticamente con un repositorio sin procesar.

Para configurar un proyecto de LookML con un repositorio de Git sin formato, haz lo siguiente:

  1. Abre tu proyecto o crea un proyecto de LookML nuevo.
  2. En tu proyecto, selecciona el ícono Configuración en el menú de íconos 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 Restablecer conexión de Git.

    Si restableces tu conexión de Git, se conservará el historial de Git para 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 preservar el historial de todas las ramas, consulta la página Prácticas recomendadas para migrar a un nuevo repositorio de Git.

  4. Selecciona Set up a bare repository instead en la parte inferior de la página Configure Git.

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

    Después de crear el repositorio de Git, Looker mostrará un diálogo Bare Repository Created.

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

En el caso de los proyectos configurados con un repositorio sin procesar, puedes usar Restablecer conexión de Git posteriormente 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 sin procesar, Looker crea un repositorio en tu servidor de Looker y comienza el historial de Git para el repositorio. Si, posteriormente, conectas tu proyecto de LookML a un repositorio de Git que tiene un historial de Git, Looker no podrá conciliar los dos históricos de Git y no podrás realizar ninguna acción de Git.

Cómo conectar un nuevo proyecto de LookML a un repositorio de Git no vacío

Configurar Git para el control de versiones es un paso clave para crear un nuevo proyecto de LookML. Por lo general, cada proyecto debe 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 mueves un proyecto de LookML existente entre instancias
  • Cuando resucitas el código de un proyecto de LookML dañado o inactivo para usarlo en un proyecto nuevo

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

  1. Para crear un proyecto de LookML nuevo, selecciona Proyecto en blanco como punto de partida. Un proyecto en blanco es el punto de partida porque se propagará con objetos LookML de un repositorio existente, en lugar de un esquema de base de datos o una consulta SQL.
  2. Configura Git para tu proyecto con HTTPS o SSH, con la URL del proyecto no 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 producción desde el panel Acciones de Git.
  4. Una vez que hayas extraído de producción, selecciona Deploy to Production.

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

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

Si estás configurando un flujo de trabajo de Git con un repositorio en varias instancias, consulta la publicación de la comunidad sobre flujos de trabajo de Git con un repositorio en varias instancias: desarrollo, pruebas y producción para obtener más información.

Prueba tu conexión de Git

Looker proporciona una prueba de conexión de Git para verificar tu conexión. 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 de Git mostrará el texto Probar conexión de Git para que soluciones el problema.

También puedes acceder a la herramienta de prueba de conexión de Git seleccionando Probar conexión de Git en el panel Acciones de Git:

Luego, la herramienta de prueba de conexión de Git muestra los pasos que está realizando para probar la conexión de Git:

  1. Cómo examinar git remote
  2. Se resolverá el nombre de host del servicio de git
  3. Las herramientas de redes del servicio de git están en funcionamiento
  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 muestra una marca de verificación verde a su izquierda. Si un paso no se realiza correctamente, Looker muestra una marca de verificación roja a la izquierda del paso y también un mensaje de error.

En el siguiente ejemplo, se muestra una prueba correcta:

Diálogo de prueba de conexión de Git que muestra una lista de pasos con marcas de verificación verdes junto a ellos 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 se completaron correctamente:

  • 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 fallaron:

  • Verify authorization credentials
  • Ensure credentials allow write access

Diálogo de prueba de conexión de Git que muestra una lista de pasos correctos y fallidos. En el paso Verificar las credenciales de autorización, aparece el error Cannot AUTH to remote (Looker deploy key).