Configura y prueba una conexión de Git

Cuando creas un proyecto nuevo, este solo existe en modo de desarrollo para que puedas desarrollar tu modelo en un entorno seguro que no afecte a otros usuarios. Una vez que estés listo para publicar tu proyecto, el siguiente paso es configurar una conexión de Git.

Configurar una conexión Git para tu proyecto te permite implementar tu LookML en modo de producción, lo que permite a otros usuarios explorar tu modelo de datos, compilar paneles y agregar LookML a tu modelo. Para una configuración más rápida, usa un repositorio simple. Para lograr una integración más sólida de Git, crea tu propio repositorio de Git y sigue las instrucciones de esta página a fin de 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 y, cada vez que un usuario está en el modo de desarrollo, se encuentra en su propia rama de Git. Los repositorios de Git se denominan repositorios.

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, independientemente de la plataforma que uses. En esta página, se usa GitHub como ejemplo para conectar un proyecto de Looker a Git una vez que se creó 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: Protocolo de transferencia de hipertexto seguro Con HTTPS, Looker accede a su repositorio de Git con el nombre de usuario y la contraseña (o el token de acceso) que usted proporcionó, como se describe en Conectarse a Git mediante HTTPS a continuación.
  • 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 mediante SSH a continuación.

Conéctate a Git mediante HTTPS

GitHub no acepta contraseñas de cuentas para autenticar operaciones de Git en github.com. Consulta la entrada de blog de GitHub para obtener más información. Para conectar un proyecto de Looker a GitHub con HTTPS, usa la configuración para desarrolladores en GitHub a fin de crear un token de acceso personal. Para los proyectos de Looker existentes que se conectan a GitHub mediante HTTPS, restablece tu conexión de Git con un token de acceso personal desde GitHub.

Para los proyectos de LookML configurados con autenticación HTTPS, Looker se conecta a su proveedor de Git con una o más cuentas de usuario que usted configura con su proveedor de Git. Looker usa un nombre de usuario y una contraseña (o token de acceso) para acceder a su proveedor de Git y realizar operaciones de Git en nombre de sus 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 este tema de la comunidad a fin de obtener instrucciones para crear tokens de acceso personal de 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 tus cuentas individuales de Git y desarrolladores a fin de que realicen sus operaciones de Git.

Autenticación HTTPS de una sola cuenta

Si configura su proyecto de LookML con una sola cuenta de Git, Looker usa esa cuenta de Git para acceder a su 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 pueda identificar qué desarrollador hizo cada confirmación. Para ver el historial de confirmaciones de tu proyecto, ve a la interfaz de tu proveedor de Git o selecciona 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 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 múltiples cuentas con atributos de usuario

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

Los siguientes requisitos y tareas son necesarios para la autenticación de Git con atributos de usuario:

  • Cada uno de sus desarrolladores de LookML debe tener su propia cuenta de usuario con su proveedor de Git. Cada cuenta de usuario de Git debe tener acceso de lectura y escritura al repositorio del proyecto.
  • Tu 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 cuentas de Git (o tokens de acceso) deben estar ocultos. Cuando crees el atributo de contraseña o token de acceso, selecciona Yes en la opción Hide Values y, luego, ingresa la URL del proveedor de Git en el campo Domain Allowlist.
  • Se deben completar los atributos de usuario para el nombre y la contraseña de Git (o token de acceso) de cada desarrollador de Looker. Un administrador de Looker puede configurar los atributos de usuario o el usuario de Looker.

A continuación, se muestra un ejemplo de la página de administrador Atributos del usuario en la que un administrador de Looker configuró los atributos del usuario para el nombre de usuario y el token de acceso de Git:

A continuación, se muestra un ejemplo de la página Cuenta de un usuario de Looker en la que el usuario ingresó sus credenciales de Git en los campos de sus atributos de usuario:

Configura la autenticación HTTPS de Git

Para configurar un proyecto de LookML con autenticación HTTPS de Git, haz lo siguiente:

  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 archivos), GitHub te mostrará la URL como parte de la configuración inicial. Asegúrese de hacer clic en el botón HTTPS para obtener la URL HTTPS. Luego, haga clic en el botón Copiar para copiarla en el portapapeles:

    Para ver los repositorios existentes de GitHub (repositorios que ya contienen archivos), ve a la pestaña Código del repositorio y haz clic en el botón Código. Asegúrese de hacer clic en el vínculo HTTPS. Puedes hacer clic en el ícono del portapapeles para copiarlo:

  2. Navegue a su proyecto LookML, haga clic en el ícono de Configuración en la barra de navegación y desplácese hacia abajo hasta la sección Configurar Git (para proyectos nuevos) o la sección Restablecer conexión de Git (para proyectos existentes que ya se conectaron a Git):

    Si restableces tu conexión de Git, se conservará el historial de Git para la rama principal. También conservará el historial de cada rama personal de cada desarrollador de Looker una vez que extraiga, combine e implemente. Para conservar el historial de todas las ramas, consulta el artículo del Centro de ayuda Migra a un repositorio de Git nuevo.

  3. En la sección Configurar Git de Looker, pegue la URL HTTPS de su repositorio de Git en el campo URL del repositorio y, luego, haga clic en Continuar.

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

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

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

  5. 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 seleccionó Usar una combinación única de nombre de usuario y contraseña/token de acceso personal, este es el nombre de usuario y la contraseña de Git (o token de acceso) que su instancia de Looker usará 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 seleccionó Use user attributes for username and password/ personal access token, use el nombre de usuario y la contraseña de Git (o token de acceso) que usará su 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 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 usar en lugar de contraseñas. Ve a este tema de la comunidad a fin de obtener instrucciones para crear tokens de acceso personal de proveedores de Git comunes.

  6. Si seleccionó Usar atributos de usuario para el nombre de usuario y el token de acceso personal o la contraseña, verá la configuración de atributos de usuario. Usa los menús desplegables para seleccionar los atributos de usuario para las credenciales de Git individuales de los desarrolladores:

    (Los usuarios de Looker pueden editar los valores de los campos de sus atributos de usuario en su 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).

  7. Haga clic en Continuar la configuración.

Git ya está configurado para tu proyecto de LookML. Desde aquí, puede validar su LookML y, luego, crear la confirmación inicial y, luego, implementarla en producción. De esta manera, su proyecto estará disponible en el modo de producción. También puede 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 muestra en el paso 4 a continuación. Looker usa esa clave de implementación para acceder a su proveedor de Git y confirmar los cambios en nombre de sus desarrolladores. Looker realiza confirmaciones con el nombre de usuario de Looker de un desarrollador para que puedas identificar qué desarrollador hizo cada confirmación. Para ver el historial de confirmaciones de tu proyecto, ve a la interfaz de tu proveedor de Git o selecciona 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 de Git de SSH, sigue estos pasos:

  1. Abre tu proyecto y selecciona Configuración en el panel de configuración del proyecto para ver la configuración. A continuación, realiza una de las siguientes acciones:

    • Para un proyecto nuevo, selecciona el botón Configurar Git en la sección de configuración del proyecto.
    • Para cambiar la configuración de Git de un proyecto existente, selecciona Reset Git Connection (Restablecer conexión de Git) en la sección de configuración del proyecto.

    Si restableces tu conexión de Git, se conservará el historial de Git para la rama principal. También conservará el historial de cada rama personal de cada desarrollador de Looker una vez que extraiga, combine e implemente. Para conservar el historial de todas las ramas, consulta el artículo del Centro de ayuda Migra a un repositorio de Git nuevo.

  2. Obtén la URL 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.
    • 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 archivos), GitHub te mostrará la URL SSH como parte de la configuración inicial. Asegúrese de hacer clic en el botón SSH para obtener la URL SSH. Luego, haga clic en el ícono del portapapeles para copiarla en el portapapeles:

    Para ver los repositorios existentes de GitHub (repositorios que ya contienen archivos), ve a la pestaña Código del repositorio y haz clic en el botón Código. Asegúrate de hacer clic en el vínculo Usar SSH. Puedes hacer clic en el ícono del portapapeles para copiarlo:

  3. En la sección Configurar Git de Looker, pegue la URL SSH para su repositorio de Git en el campo URL del repositorio y, luego, haga clic en Continuar.

    Las URL con puertos de Git personalizados o no estándar se pueden usar con Looker si agregan 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.

  4. 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 de una lista desplegable). Selecciona toda la clave de implementación y cópiala en el portapapeles. Luego, haz clic en el vínculo Deploy Key settings for your repository para abrir la página de implementación de claves de GitHub en tu repositorio de GitHub.

  5. En la página Implementar claves de GitHub, haz clic en el botón Agregar clave de implementación:

    GitHub muestra la página Implementar claves/Agregar nueva:

  6. 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 del proyecto para hacer un seguimiento de él en el futuro.

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

  8. Selecciona la opción Permitir acceso de escritura.
    Este es un paso importante porque Looker requiere esta configuración para realizar y, luego, implementar cambios en su modelo de LookML.

  9. Haz clic en el botón Agregar clave. (En este punto, tu proveedor de Git puede solicitarte que ingreses tu contraseña. Si es así, ingrese su contraseña y, luego, haga clic en Confirmar contraseña).

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

  11. Regrese a la ventana de Looker y haga clic en Test and Finalize Setup en la sección Configure Git. Si hay un problema con la configuración de Git, verás un error como el siguiente:

Desde aquí, puede intentar configurar la clave de implementación nuevamente o hacer clic en Omitir pruebas y finalizar configuración para mantener su configuración actual.

Git ya está configurado para tu proyecto de LookML. Desde aquí, puede validar su LookML y, luego, crear la confirmación inicial y, luego, implementarla en producción. De esta manera, su proyecto estará disponible en el modo de producción. También puede realizar lo siguiente:

Configura un repositorio de Git simple

Si aún no creaste un repositorio de Git remoto o si solo deseas realizar la configuración rápidamente para que otros puedan beneficiarse de LookML, puedes configurar un repositorio de Git simple. La configuración de un repositorio de Git simple crea un repositorio de Git local en su instancia de Looker, en lugar de conectarse a un repositorio remoto.

Para configurar un proyecto de LookML con un repositorio de Git simple:

  1. Abre tu proyecto y selecciona Configuración en el panel de configuración del proyecto para ver la configuración. A continuación, realiza una de las siguientes acciones:

    • Para un proyecto nuevo, selecciona el botón Configurar Git en la sección de configuración del proyecto.
    • Para cambiar la configuración de Git de un proyecto existente, selecciona Reset Git Connection (Restablecer conexión de Git) en la sección de configuración del proyecto.

    Si restableces tu conexión de Git, se conservará el historial de Git para la rama principal. También conservará el historial de las ramas personales de cada desarrollador de Looker una vez que extraigan y combinen los datos para después implementarlos. Para conservar el historial de todas las ramas, consulta el artículo del Centro de ayuda Migra a un repositorio de Git nuevo.

  2. En el cuadro de diálogo Configurar Git de Looker, haga clic en Configurar un repositorio simple.

  3. En el cuadro de diálogo Configurar el repositorio de Git de Bare, haz clic en Crear repositorio.

    Después de crear el repositorio de Git, Looker muestra un cuadro de diálogo que muestra la ruta al nuevo repositorio de Git:

Git ya está configurado para tu proyecto de LookML. Desde aquí, puede validar su LookML y, luego, crear la confirmación inicial y, luego, implementarla en producción. De esta manera, su proyecto estará disponible en el modo de producción. También puede realizar lo siguiente:

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

Configurar Git para el control de versiones es un paso clave en la creación de un proyecto nuevo 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 existente de LookML entre instancias
  • Cuando resucitas el código de un proyecto de LookML roto o en desuso 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 que no está vacío a fin de continuar con el desarrollo de LookML.

Este flujo de trabajo es solo para los repositorios a los que tienes acceso de escritura.

  1. Para crear un proyecto nuevo de LookML, seleccione 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 de 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 sección Configurar Git.
  3. Una vez que hayas configurado Git para tu proyecto, extrae de producción desde el panel Git Actions.
  4. Una vez que hayas realizado la extracción, selecciona Deploy to Production.

Los cambios que hagas 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 hay un repositorio público que te gustaría usar como base para un proyecto de LookML en blanco, pero no tienes acceso de escritura al repositorio, sigue las instrucciones que se describen en la sección sobre cómo clonar un repositorio de Git público de la página de documentación Crea un proyecto de LookML nuevo.

Si configuras un flujo de trabajo de Git con un repositorio en varias instancias, consulta el tema Comunidad en Flujo de trabajo de Git con un repositorio en varias instancias: desarrollo, etapa de 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 su 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 tenga acceso de escritura a tu repositorio de Git.

Si Looker no puede conectarse a su repositorio de Git, verá el botón Test Git Connection (Probar conexión de Git):

También puedes acceder a la herramienta de prueba de conexión de Git. Para ello, selecciona Probar conexión de Git en el panel de acciones de Git:

Luego, la herramienta de prueba de conexión de Git muestra los pasos necesarios para probar la conexión de Git. Este es un ejemplo de una prueba exitosa:

En este ejemplo, el repositorio de Git no tiene una clave de implementación configurada para la conexión de Looker: