Migración de autoservicio de Looker (original) a Looker (Google Cloud Core)

En este documento, se describen los pasos técnicos para migrar tu instancia existente de Looker del entorno de Looker (original) a Looker (Google Cloud Core).

Looker (Google Cloud Core) es un entorno de implementación que se integra estrechamente en Google Cloud Platform. Looker (Google Cloud Core) está alojado en la infraestructura de Google Cloud; puedes administrarlo directamente a través de la consola de Google Cloud. Además, tiene integraciones profundas con muchos de los otros productos, servicios y capacidades de Google Cloud.

Antes de comenzar

  1. Revisa la siguiente documentación para familiarizarte con los principios y las herramientas de Google Cloud:
  2. Habla con tu representante de cuenta sobre la migración y si tu instancia de Looker (original) es apta. Si tu instancia es apta y actualizaste tu contrato existente de Looker (original) para que abarque Looker (Google Cloud Core), puedes completar los pasos que se indican en este documento para migrar tu instancia.

  3. Si quieres obtener los permisos que necesitas para prepararte para la migración, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto de Google Cloud en el que residirá la instancia de Looker (Google Cloud Core):

    • Crea una instancia de Looker (Google Cloud Core): Administrador de Looker (roles/looker.admin).
    • Asigna roles de IAM dentro de tu proyecto de Google Cloud: Administrador de IAM del proyecto (roles/resourcemanager.projectIamAdmin).
    • Crea un bucket de Cloud Storage: Administrador de almacenamiento (roles/storage.admin).

    Si quieres obtener más información para otorgar roles, consulta Administra el acceso.

    Es posible que también puedas obtener los permisos necesarios a través de los roles personalizados o de otros roles predefinidos.

  4. Para administrar la instancia de Looker (original) como preparación para la migración, debes tener el rol de administrador de Looker en esa instancia.

  5. Crea una nueva instancia “vacía” de Looker (Google Cloud Core).

    Asegúrate de seleccionar la edición, el tipo de conexión de red (IP pública o privada) y otros atributos de configuración (CMEK y VPC-SC) adecuados para tu nueva instancia de Looker (Google Cloud Core) para asegurarte de que tenga las capacidades necesarias. Algunas de las funciones de Looker (Google Cloud Core) dependen de la edición seleccionada o del tipo de red seleccionado.

    Deja la instancia “vacía”; no la propagues con ningún dato, como archivos del modelo, usuarios, conexiones, exploraciones, paneles o carpetas. Durante el paso de importación, se borrarán todos los parámetros de configuración o el contenido y se reemplazarán por los datos de la migración.

    Sin embargo, los atributos de configuración de Looker (Google Cloud Core) que se especifican a través de la consola de Google Cloud o que solo se pueden especificar durante la creación de instancias no se reemplazan durante el proceso de migración.

Descripción general

En términos generales, el proceso de migración consta de los pasos siguientes.

  1. Asegúrate de que tu instancia de Looker (original) esté lista para la migración.
  2. Exporta los datos de tu instancia de Looker (original).
  3. Importar los datos a la nueva instancia “vacía” de Looker (Google Cloud Core)
  4. Finaliza la configuración de la instancia de Looker (Google Cloud Core).
  5. Retira la instancia de Looker (original).

En las siguientes secciones, se proporcionan detalles sobre cada uno de estos pasos.

Asegúrate de que tu instancia de Looker (original) esté lista para la migración

Tu instancia de Looker (original) debe cumplir con los siguientes requisitos previos para ser apta para la migración:

  • Google debe administrar (es decir, no alojar el cliente) la instancia de Looker (original) y alojarse en Google Cloud o Amazon Web Services.

  • Tu instancia de Looker (original) debe usar una versión que se encuentre dentro de una actualización mensual de la versión actual de Looker (Google Cloud Core). Para encontrar la versión actual de Looker (Google Cloud Core), consulta las notas de la versión de Looker y encuentra el anuncio de implementación más reciente.

Además, realiza las siguientes actividades antes de la migración:

  • Hay un pequeño conjunto de diferencias de funciones entre Looker (original) y Looker (Google Cloud Core). Revisa estas diferencias para asegurarte de que las funciones de Looker (Google Cloud Core) satisfagan tus necesidades actuales.

  • La migración copia todos los proyectos de Modo de producción y los archivos de modelos que contienen, pero no los proyectos de Modo de desarrollo que pertenecen a usuarios individuales. Para asegurarte de que los archivos de Modo de desarrollo se transfieran a través de la migración, debes confirmar todos los archivos de todos los proyectos de Modo de desarrollo en repositorios de Git antes de iniciar la migración.

  • Looker (Google Cloud Core) solo admite los métodos de autenticación Google OAuth, SAML y OpenID Connect.

  • Durante la migración, se ejecutarán en paralelo dos instancias de Looker (una de Looker (original) y otra de Looker (Google Cloud Core) durante un período. Cualquier actividad automática que tenga lugar (como alertas e informes programados, así como la actividad en segundo plano que accede a bases de datos de backend) puede duplicarse. Para evitar la actividad duplicada, borra las alertas y los programas automáticos en la instancia de Looker (original) o en Looker (Google Cloud Core).

Exporta los datos de tu instancia de Looker (original)

Para exportar los datos de tus instancias de Looker (original) se requieren dos pasos:

  1. Crea un lugar para almacenar los datos de migración.
  2. Inicia la exportación.

Crea un lugar para almacenar los datos de migración

Realiza todas las operaciones siguientes en el mismo proyecto de Google Cloud en el que creaste la instancia de Looker (Google Cloud Core).

  1. Crea un bucket de Cloud Storage nuevo (por ejemplo, <bucket-name>).
    • Este bucket se usará para almacenar los datos de la migración.
    • Sigue las instrucciones de la página de documentación Crear buckets.
    • Ten en cuenta que el <bucket-name> debe ser único en todo Google Cloud. Te recomendamos que uses un prefijo en el nombre del bucket con un identificador único, como el ID del proyecto.
  2. Elige un nombre para una carpeta dentro del bucket de Cloud Storage (por ejemplo, <folder-name>). No crees la carpeta ahora. Especifica el nombre de la carpeta durante la solicitud de exportación. Se creará automáticamente durante el proceso de exportación.
  3. Crea un llavero de claves y una clave en Cloud KMS (por ejemplo, <kms_keyring_id> y <kms-key-id>).
  4. Crea una cuenta de servicio nueva específicamente para la migración (por ejemplo, <export-service-account>).

  5. Otorga a <export-service-account> dos roles de IAM específicos:

  6. Crea una clave de cuenta de servicio que esté asociada con <export-service-account> y descarga el archivo de claves JSON.

Solicita la exportación

Una vez que te asegures de que tu instancia está lista para la migración, creaste una instancia “vacía” de Looker (Google Cloud Core) y creaste un lugar para almacenar los datos de migración, ingresa la siguiente información en la página Exportar del panel Administrador de tu instancia de Looker (original):

  • El nombre del bucket de Cloud Storage que creaste.
  • El nombre de la carpeta de Cloud Storage; se creará automáticamente una carpeta con este nombre durante la exportación. Cuando se complete la exportación, los archivos de exportación aparecerán en una subcarpeta con marca de tiempo dentro de esta carpeta en el bucket de Cloud Storage que creaste.
  • El nombre de la clave de KMS.
  • El texto JSON que contiene la clave de la cuenta de servicio.

Una vez que hayas ingresado la información en la página Exportar, haz clic en Solicitar exportación para iniciar la exportación.

El proceso de exportación tarda entre minutos y horas. Cuando se complete la exportación, verás varios archivos de exportación (en un formato no legible por humanos) en tu bucket y carpeta de Cloud Storage. Estos archivos son la entrada para el siguiente paso de importación.

Importa los datos a la nueva instancia “vacía” de Looker (Google Cloud Core)

Una vez que se exporten los datos de tu instancia, puedes importarlos a tu instancia de Looker (Google Cloud Core).

Sigue las instrucciones de la página Importa tus datos desde Cloud Storage a una instancia de Looker (Google Cloud Core) y apunta los comandos al bucket y a la carpeta en los que se ubicaron los archivos de exportación.

En pocas palabras, esto implica lo siguiente:

  1. Otorga los siguientes roles para acceder al bucket y la clave de KMS a la cuenta de servicio de Looker (no a <export-service-account>):
  2. Activa la importación a través de la consola de Google Cloud o gcloud CLI

La operación de importación tarda de minutos a horas. Cuando se complete, tu instancia de Looker (Google Cloud Core) se reiniciará con todos los datos migrados.

Finaliza la configuración de la instancia de Looker (Google Cloud Core)

En este punto, los administradores de Looker pueden navegar a la URL de la instancia y acceder a ella para finalizar la configuración.

El proceso de migración copia la mayor cantidad posible de la configuración de instancias de Looker (original). Sin embargo, algunos elementos no se pueden migrar o funcionan de manera diferente en Looker (Google Cloud Core), por lo que se deben ajustar.

Entre los aspectos que suelen requerir atención especial se incluyen los siguientes:

Configuración general (en el panel **Administrador** de Looker)

La mayoría de los parámetros de configuración general (y otros parámetros de los que se encuentran en el panel **Administrador**) no se copian automáticamente, ya que suelen ser diferentes o no existen de la misma forma en Looker (Google Cloud Core). Debes revisar y ajustar cuidadosamente todos los parámetros de configuración en el contexto de la configuración que elegiste de Looker (Google Cloud Core). Consulta las páginas de documentación Administra una instancia de Looker (Google Cloud Core) desde Looker y Administra una instancia de Looker (Google Cloud Core) desde la consola de Google Cloud para obtener más información sobre los parámetros de configuración en Looker (Google Cloud Core).

Usuarios

Looker (Google Cloud Core) solo admite los métodos de autenticación Google OAuth, SAML y OpenID Connect.

Si la instancia de Looker (original) también se configuró para OAuth de Google, se copiarán los registros del usuario y sus atributos (siempre y cuando estén asociados con el mismo ID de Google y la misma dirección de correo electrónico en ambas instancias). Un administrador de IAM del proyecto debe otorgar a cada usuario el rol de IAM de administrador de Looker o usuario de la instancia de Looker en el proyecto de Google Cloud en el que se encuentra la instancia.

Si la instancia de Looker (original) se configuró para OpenID Connect o SAML, asegúrate de que el campo Combinar usuarios con del método de autenticación solo indique los métodos de autenticación compatibles con Looker (Google Cloud Core).

Si algunos usuarios de la instancia de Looker (original) se estaban autenticando con un mecanismo que no es compatible con Looker (Google Cloud Core) (como LDAP o correo electrónico/contraseña), esas cuentas de usuario deberán volver a crearse y convertirse en un método de autenticación compatible.

Conexiones de base de datos

Looker (Google Cloud Core) admite un conjunto ligeramente diferente de dialectos de bases de datos que Looker (original). Se copian todas las propiedades de configuración para las conexiones de bases de datos (incluidas la string de conexión y la contraseña, si corresponde). Sin embargo, es posible que las diferentes topologías de red de Looker (Google Cloud Core) impidan que las conexiones de la base de datos funcionen de inmediato. Por ejemplo, si se accede a las bases de datos a través de firewalls o túneles específicos de la instancia de Looker (original), es posible que debas volver a configurar los firewalls o túneles. Debes probar cada conexión y restablecerla si es necesario.

Conexiones del repositorio de Git

Si la instancia usa repositorios de Git vacíos, estos deberían funcionar sin modificaciones (se copian, pero no se comparten). Sin embargo, si la instancia se conecta a repositorios remotos, es posible que estas conexiones deban verificarse y volver a habilitarse, de manera similar a las conexiones de bases de datos.

Otra configuración de red

La instancia de Looker puede tener otros tipos de conexiones de red, tanto entrantes como salientes (por ejemplo, en el contexto de una IP privada, Action Hub, Marketplace, correo electrónico, etcétera). Estas conexiones de red también deben verificarse.

URL para acceder a la instancia de Looker (Google Cloud Core)

La instancia de Looker (Google Cloud Core) incluye una URL principal que se asigna de forma aleatoria. Si se debe acceder a la instancia a través de una URL específica, puedes configurar un dominio personalizado.

Programaciones y alertas

Si las instancias de Looker (original) y Looker (Google Cloud Core) están activas en simultáneo, pueden generar alertas y acciones programadas duplicadas, además de realizar operaciones duplicadas en segundo plano que acceden a las bases de datos conectadas. Estas actividades deben inhabilitarse en una de las instancias tan pronto como sea posible.

Períodos de mantenimiento

A diferencia de Looker (original), se puede especificar una política de mantenimiento para Looker (Google Cloud Core).

Actividad del sistema Elite

Los datos de actividad del sistema Elite no se copian como parte de la migración. La instancia de Looker (Google Cloud Core) comenzará con un historial nuevo.

Dominio personalizado

Puedes crear un dominio personalizado para tu instancia de Looker (Google Cloud Core). Debes configurar los registros DNS para garantizar la implementación del certificado SSL. Además, asegúrate de actualizar la URL de devolución de llamada en tu cliente de autenticación al dominio personalizado una vez que el dominio personalizado esté habilitado y configurado el método de autenticación. No se pueden crear dominios personalizados para Looker (Google Cloud Core) con un dominio looker.com.

Si quieres crear un dominio personalizado para tu instancia de Looker (Google Cloud Core) con la URL personalizada de tu instancia de Looker (original), el dominio personalizado se debe configurar después de que se complete la migración y después de confirmar que la instancia de Looker (Google Cloud Core) esté lista para usarse. Una vez que se habilite el dominio personalizado, los usuarios verán la instancia de Looker (Google Cloud Core) y no la de Looker (original) cuando visiten la URL de la instancia.

No configures SAML ni OpenID Connect para la instancia de Looker (Google Cloud Core) hasta que la instancia esté lista para usarse, se hayan actualizado los registros DNS y se haya habilitado el dominio personalizado.

Favoritos

Si usas una URL personalizada en tu instancia de Looker (original) (que no usa el dominio looker.com), este proceso de migración debe mantener los favoritos de los usuarios si creas un dominio personalizado para tu instancia de Looker (Google Cloud Core) con la misma URL que tu instancia de Looker (original).

Una vez que se habilite el dominio personalizado, los favoritos del contenido de Looker (original), como https://www.yourcustomdomain.com/dashboard/123, apuntarán al contenido de la instancia de Looker (Google Cloud Core). Nota: Las ediciones Enterprise y Embed de Looker (Google Cloud Core) usan slugs de contenido alfanumérico en sus URLs en lugar de IDs de contenido numéricos, pero un favorito con un ID de contenido seguirá redireccionando correctamente al mismo contenido.

Este proceso no se puede usar con URLs (originales) de Looker que usen el dominio looker.com.

Esta lista no es exhaustiva. Prueba todos los aspectos de la instancia que sean más importantes para ti antes de considerar que la migración está completa.

Una vez que se complete la migración y estés seguro de que no necesitarás otra exportación, puedes borrar el archivo <export-service-account> que creaste anteriormente, lo que deja inútil la clave JSON que se le compartió.

Retira la instancia de Looker (original)

Una vez que la instancia migrada de Looker (Google Cloud Core) funcione de manera satisfactoria, podrás enviar a tus usuarios la URL de la instancia y, luego, indicarles que comiencen a acceder a ella y dejen de hacerlo a la instancia de Looker (original).

Soluciona problemas

Las siguientes secciones pueden ayudarte a resolver problemas durante la importación o exportación.

Problemas durante la exportación

Si hay un problema con la exportación de tus datos de Looker (original), aparecerá el estado ERROR en la página Export del panel Administrador. Cuando haces clic en el estado ERROR, se muestra un mensaje de error.

Las fuentes comunes de errores son las siguientes:

  • El bucket de Cloud Storage, la clave de KMS o <export-service-account> no son válidos.
  • <export-service-account> no tiene los permisos necesarios.

Es útil confirmar el estado de estos objetos antes de enviar tu solicitud de exportación.

Problemas durante la importación

Si la operación de importación no finaliza después de cuatro horas (o posiblemente más si la instancia de origen era muy grande) o si se sale por error, es posible que debas abrir un ticket con Atención al cliente de Cloud para resolver el problema. Hay relativamente pocos diagnósticos que el cliente pueda ver directamente para esta operación.

Próximos pasos