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. Una vez que 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 a otros usuarios explorar tu modelo de datos, crear paneles y agregar LookML a tu modelo. Para una configuración más rápida, usa un repositorio sin procesar. Si deseas 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 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 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 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 creas un repositorio de Git.

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

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 mediante 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 con SSH.

Conéctate 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 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 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 de Git comunes.

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 cuenta única

Si configuras tu proyecto de LookML con una sola cuenta de Git, Looker usará 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 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. Tus 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, tu 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 requieren 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 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 entidades permitidas de dominio.
  • Los atributos del usuario para el nombre y la contraseña de Git (o el token de acceso) deben completarse para cada desarrollador de Looker. Un administrador de Looker o el usuario de Looker pueden configurar los atributos de usuario.

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

Tabla en la Página de administrador de atributos de usuario que muestra 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 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 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 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 Configuración del proyecto, en la pestaña Configuración, ve al botón Configurar Git (para proyectos nuevos) o al botón Restablecer conexión de Git (para proyectos existentes que se conectaron anteriormente a Git).

  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 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 de prácticas recomendadas Cómo migrar a un nuevo repositorio de Git.

  5. En la página Configure Git de Looker, pega la URL HTTPS de tu repositorio de Git en el campo Repository URL y, luego, selecciona Continue.

    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 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 Cómo configurar una conexión HTTPS de git con 2FA habilitada Publicación de Comunidad para ver instrucciones sobre cómo crear tokens de acceso personal para proveedores de Git comunes.

  8. Si seleccionaste Use user attribute for username and password/personal access token, Looker mostrará los menús desplegables Username User Attribute y Personal Access Token User Attribute en la sección Development Mode Credentials. 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 SSH, puedes crear 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 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 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 Configuración del proyecto, realiza una de las siguientes acciones para abrir la página Configurar 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. Si deseas conservar el historial de todas las ramas, consulta la página de prácticas recomendadas para migrar a un repositorio de Git nuevo.

    Diagrama que muestra el progreso desde la página Configuración del proyecto hasta la página Configurar 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 dirigirán a la página 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 Configure Git de Looker, pega la URL de SSH de tu repositorio de Git en el campo Repository URL y, luego, selecciona Continue.

    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, 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 Implementar la configuración de claves para tu repositorio para abrir la página Implementar claves de GitHub de 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 nueva (Deploy keys / Add new).

  8. Agrega un título para la clave de implementación. El nombre no es importante, pero podrías incluir "Looker". y el título de tu proyecto para hacer un seguimiento de él 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. Vuelve 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. Aquí puedes validar tu LookML y, luego, crear la confirmación inicial y, luego, implementarla en producción para que el proyecto esté disponible en el modo de producción. También puedes realizar lo siguiente:

Configura un repositorio de Git básico

Si aún no creaste un repositorio de Git remoto o si solo quieres configurarlo rápidamente para que otros puedan aprovechar tu LookML, puedes configurar un repositorio de Git vacío. Cuando configuras un repositorio de Git sin procesar, se crea 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 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 sin formato, haz lo siguiente:

  1. Abre tu proyecto o crea un proyecto nuevo de LookML.
  2. En tu proyecto, selecciona el ícono Settings en el menú de íconos de la izquierda para abrir la página Project Configuration.

  3. En la página Configuración del proyecto, realiza una de las siguientes acciones para abrir la página Configurar 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 de prácticas recomendadas Cómo migrar a un nuevo repositorio de Git.

  4. Selecciona Configurar un repositorio vacío en la parte inferior de la página Configurar 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. Aquí puedes validar tu LookML y, luego, crear la confirmación inicial y, luego, implementarla en producción para que el proyecto esté disponible en el modo de producción. También puedes realizar lo siguiente:

Para los proyectos configurados con un repositorio vacío, puedes usar posteriormente Reset Git Connection 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 posteriormente 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 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 versión es un paso clave en la creación de 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 existente de LookML 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 proyecto nuevo de LookML con un repositorio de Git existente que no esté 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 LookML en 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 para el 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 tiene éxito, Looker mostrará una marca de verificación verde a la izquierda. Si un paso no tiene éxito, Looker mostrará una marca de verificación roja a la izquierda y también un mensaje de error.

En el siguiente ejemplo, se muestra una prueba que se realizó correctamente:

Diálogo &quot;Git Connection Test&quot; que muestra una lista de pasos con marcas de verificación verdes a su lado para indicar que todos los pasos se realizaron 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 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. Un error en el paso Verificar credenciales de autorización indica que no se puede AUTH a remote (clave de implementación de Looker).