Migração por autoatendimento do Looker (original) para o Looker (Google Cloud Core)

Este documento descreve as etapas técnicas para migrar sua instância atual do Looker do ambiente Looker (original) para o Looker (Google Cloud Core).

O Looker (Google Cloud Core) é um ambiente de implantação que se integra profundamente à plataforma do Google Cloud . O Looker (Google Cloud Core) é hospedado na infraestrutura do Google Cloud , pode ser gerenciado diretamente pelo console do Google Cloud e tem integrações profundas com muitos outros produtos, serviços e recursos do Google Cloud.

O Looker (Google Cloud Core) não permite a migração de uma instância do Looker (original) para uma instância do Looker (Google Cloud Core) com FIPS ativado, porque as instâncias do Looker (original) não são compatíveis com o FIPS.

Antes de começar

  1. Conheça os princípios e as ferramentas do Google Cloud lendo a seguinte documentação:
  2. Fale com o representante da sua conta sobre a migração e se a instância do Looker (original) está qualificada. Se a instância estiver qualificada e você tiver feito upgrade do contrato do Looker (original) para cobrir o Looker (Google Cloud Core), siga as etapas neste documento para migrar a instância.

  3. Para receber as permissões necessárias para se preparar para a migração, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto do Google Cloud em que a instância do Looker (Google Cloud Core) vai residir:

    • Criar uma instância do Looker (Google Cloud Core): Administrador do Looker (roles/looker.admin).
    • Atribua papéis do IAM no projeto do Google Cloud : Administrador do IAM do projeto (roles/resourcemanager.projectIamAdmin).
    • Criar um bucket do Cloud Storage: Administrador do Storage (roles/storage.admin).

    Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

    Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

  4. Para gerenciar a instância do Looker (original) em preparação para a migração, é preciso ter o papel de Administrador do Looker nessa instância.

  5. Crie uma nova instância "vazia" do Looker (Google Cloud Core).

    Selecione a edição adequada, o tipo de conexão de rede (conexões públicas seguras ou conexões privadas) e outros atributos de configuração (CMEK, VPC-SC) para que a nova instância do Looker (Google Cloud Core) tenha os recursos necessários. Alguns dos recursos do Looker (Google Cloud Core) dependem da edição selecionada ou do tipo de rede escolhido.

    Deixe a instância "vazia". Não preencha com dados como arquivos de modelo, usuários, conexões, análises, dashboards ou pastas. Durante a etapa de importação, todas as configurações ou conteúdos serão apagados e substituídos pelos dados da migração.

    No entanto, os atributos de configuração do Looker (Google Cloud Core) especificados pelo console do Google Cloud ou que só podem ser especificados durante a criação da instância não são substituídos durante o processo de migração.

Visão geral

De modo geral, o processo de migração consiste nas etapas a seguir.

  1. Verifique se a instância do Looker (original) está pronta para a migração.
  2. Exporte os dados da sua instância do Looker (original).
  3. Importe os dados para a nova instância "vazia" do Looker (Google Cloud Core).
  4. Finalize a configuração da instância do Looker (Google Cloud Core).
  5. Desativar a instância do Looker (original).

As seções a seguir fornecem detalhes sobre cada uma dessas etapas.

Verificar se a instância do Looker (original) está pronta para migração

Sua instância do Looker (original) precisa atender aos seguintes pré-requisitos para ser qualificada para migração:

  • Sua instância do Looker (original) precisa ser gerenciada pelo Google (ou seja, não hospedada pelo cliente) e hospedada no Google Cloud ou na Amazon Web Services.

  • Sua instância do Looker (original) precisa usar uma versão que esteja dentro de uma versão mensal da versão atual do Looker (Google Cloud Core). Para encontrar a versão atual do Looker (Google Cloud Core), consulte as notas da versão do Looker e encontre o anúncio de implantação mais recente.

Além disso, realize as seguintes atividades antes da migração:

  • Há um pequeno conjunto de diferenças de recursos entre o Looker (original) e o Looker (Google Cloud Core). Analise essas diferenças para garantir que os recursos do Looker (Google Cloud Core) atendam às suas necessidades.

  • A migração copia todos os projetos do Modo de Produção e os arquivos de modelo que eles contêm, mas não os projetos do Modo de Desenvolvimento que pertencem a usuários individuais. Para garantir que os arquivos do Modo de Desenvolvimento sejam transferidos pela migração, confirme todos os arquivos em todos os projetos do Modo de Desenvolvimento para repositórios Git antes de iniciar a migração.

  • O Looker (Google Cloud Core) é compatível apenas com os métodos de autenticação OAuth do Google, SAML e OpenID Connect.

  • Durante a migração, duas instâncias do Looker (uma do Looker original e outra do Looker (Google Cloud Core)) vão ser executadas em paralelo por um período. Qualquer atividade automática que ocorra (como alertas e entregas de dados programadas, além de atividades em segundo plano que acessam bancos de dados de back-end) pode ser duplicada. Para evitar atividades duplicadas, exclua os alertas e as programações automáticas na instância do Looker (original) ou do Looker (Google Cloud Core).

Exportar os dados da sua instância do Looker (original)

A exportação de dados das instâncias do Looker (original) requer duas etapas:

  1. Crie um local para armazenar os dados da migração.
  2. Inicie a exportação.

Consulte a documentação Importação ou exportação de dados única para uma instância do Looker (Google Cloud Core) para saber quais dados são e não são incluídos em uma exportação.

Criar um local para armazenar os dados de migração

Realize todas as operações a seguir no mesmo projeto do Google Cloud em que você criou a instância do Looker (Google Cloud Core).

  1. Crie um novo bucket do Cloud Storage (por exemplo, <bucket-name>).
    • Esse bucket será usado para armazenar os dados da migração.
    • Siga as instruções na página de documentação Criar buckets.
    • O <bucket-name> precisa ser exclusivo em todo o Google Cloud. Recomendamos prefixar o nome do bucket com um identificador exclusivo, como o ID do projeto.
  2. Escolha um nome para uma pasta dentro do bucket do Cloud Storage (por exemplo, <folder-name>). Não crie a pasta agora. Especifique o nome da pasta durante a solicitação de exportação. Ele será criado automaticamente durante o processo de exportação.
  3. Crie um keyring e uma chave no Cloud KMS (por exemplo, <kms_keyring_id> e <kms-key-id>).
  4. Crie uma nova conta de serviço especificamente para a migração (por exemplo, <export-service-account>).

  5. Conceda ao <export-service-account> dois papéis específicos do IAM:

  6. Crie uma chave de conta de serviço associada a <export-service-account> e faça o download do arquivo de chave JSON.

Solicitar a exportação

Depois de garantir que sua instância está pronta para a migração, criar uma instância "vazia" do Looker (Google Cloud Core) e criar um local para armazenar os dados de migração, insira as seguintes informações na página Exportar no painel de admin Administrador da sua instância do Looker (original):

  • O nome do bucket do Cloud Storage que você criou.
  • O nome da pasta do Cloud Storage: uma pasta com esse nome será criada automaticamente durante a exportação. Quando a exportação for concluída, os arquivos vão aparecer em uma subpasta com carimbo de data/hora dentro dessa pasta no bucket do Cloud Storage que você criou.
  • O nome da chave do KMS.
  • O texto JSON que contém a chave da conta de serviço.

Depois de inserir as informações na página Exportar, clique em Solicitar exportação para iniciar o processo.

O processo de exportação leva de minutos a horas. Quando a exportação for concluída, você vai encontrar vários arquivos de exportação (em formato não legível por humanos) no bucket e na pasta do Cloud Storage. Esses arquivos são inseridos na etapa de importação a seguir.

Importar os dados para a nova instância "vazia" do Looker (Google Cloud Core)

Depois que os dados da instância forem exportados, será possível importá-los para sua instância do Looker (Google Cloud Core).

Siga as instruções na página Como importar dados do Cloud Storage para uma instância do Looker (Google Cloud Core), apontando os comandos para o bucket e a pasta em que os arquivos de exportação foram colocados.

A operação de importação leva de minutos a horas. Quando ela for concluída, sua instância do Looker (Google Cloud Core) será reiniciada com todos os dados migrados.

Finalizar a configuração da instância do Looker (Google Cloud Core)

Neste ponto, os administradores do Looker podem acessar o URL da instância e fazer login na instância para finalizar a configuração.

O processo de migração copia o máximo possível da configuração da instância do Looker (original). No entanto, alguns itens não podem ser migrados ou funcionam de maneira um pouco diferente no Looker (Google Cloud Core) e precisam ser ajustados.

Alguns itens que exigem atenção especial incluem:

Configurações gerais (no painel Administrador do Looker)

A maioria das opções de Configurações gerais (e outras configurações no painel Administrador) não é copiada automaticamente porque costuma ser diferente ou não existe da mesma forma no Looker (Google Cloud Core). Revise e defina todas as configurações no contexto da configuração escolhida do Looker (Google Cloud Core). Consulte as páginas de documentação Administrar uma instância do Looker (Google Cloud Core) no Looker e Administrar uma instância do Looker (Google Cloud Core) no console do Google Cloud para mais informações sobre as configurações no Looker (Google Cloud Core).

Usuários

O Looker (Google Cloud Core) é compatível apenas com os métodos de autenticação OAuth do Google, SAML e OpenID Connect.

Se a instância do Looker (original) também tiver sido configurada para o OAuth do Google, os registros do usuário e os atributos deles serão copiados (desde que estejam associados ao mesmo ID do Google e endereço de e-mail em ambas as instâncias). Um administrador do IAM do projeto precisa conceder a cada usuário o papel do IAM de administrador do Looker ou de usuário da instância do Looker no projeto do Google Cloud em que a instância está localizada.

Se a instância do Looker (original) foi configurada para SAML ou OpenID Connect, verifique se o campo Mesclar usuários usando do método de autenticação indica apenas métodos de autenticação compatíveis com o Looker (Google Cloud Core).

Se alguns usuários da instância do Looker (original) estavam se autenticando por um mecanismo que não é compatível com o Looker (Google Cloud Core), como LDAP ou e-mail e senha, essas contas de usuário precisarão ser recriadas e convertidas em um método de autenticação compatível.

Para evitar que contas de usuário duplicadas sejam criadas ao converter usuários ou para resolver problemas de contas duplicadas criadas durante a migração, consulte Resolver problemas de contas duplicadas do Looker na mudança de e-mail.

Conexões de banco de dados

O Looker (Google Cloud Core) é compatível com um conjunto de dialetos de banco de dados um pouco diferente do Looker (original). Todas as propriedades de configuração das conexões de banco de dados (incluindo string de conexão e senha, se aplicável) são copiadas. No entanto, a topologia de rede diferente no Looker (Google Cloud Core) pode impedir que as conexões de banco de dados funcionem imediatamente. Por exemplo, se os bancos de dados forem acessados por firewalls ou túneis específicos da instância do Looker (original), talvez seja necessário reconfigurar os firewalls ou túneis. Teste cada conexão e restabeleça-a, se necessário.

Conexões de banco de dados usando OAuth

A migração do Looker (original) para o Looker (Google Cloud Core) não retém os tokens de acesso ou de atualização do OAuth para as conexões de banco de dados de usuários individuais com o BigQuery ou o Snowflake. Após a migração, os usuários do Looker (Google Cloud Core) vão precisar autenticar novamente o OAuth ao acessar uma Análise ou um painel que faça referência a uma conexão de banco de dados OAuth. Os usuários também podem se autenticar novamente nos bancos de dados acessando a página Conta e selecionando Fazer login para cada banco de dados no título Credenciais de conexão do OAuth. Todas as programações ou alertas automatizados que pertencem a um único usuário e fazem referência a uma conexão OAuth vão parar de funcionar até que o usuário faça login com as credenciais do OAuth.

Conexões de repositório do Git

Se a instância estiver usando repositórios Git simples, eles vão funcionar sem modificações (copiados, mas não compartilhados). No entanto, se a instância se conectar a repositórios remotos, talvez seja necessário verificar e reativar essas conexões, de forma semelhante às conexões de banco de dados.

Outras configurações de rede

A instância do Looker pode ter outros tipos de conexões de rede, tanto de entrada quanto de saída (por exemplo, no contexto de conectividade privada, central de ações, Marketplace, e-mail etc.). Essas conexões de rede também precisam ser verificadas.

URL para acessar a instância do Looker (Google Cloud Core)

A instância do Looker (Google Cloud Core) vem com um URL principal atribuído aleatoriamente. Se a instância precisar ser acessada por um URL específico, configure um domínio personalizado.

Programações e alertas

Se as instâncias do Looker (original) e do Looker (Google Cloud Core) estiverem ativas ao mesmo tempo, elas poderão gerar ações agendadas e alertas duplicados e realizar operações em segundo plano duplicadas que acessam bancos de dados conectados. Essas atividades devem ser desativadas em uma das instâncias assim que possível.

Todas as programações ou alertas automatizados que pertencem a um único usuário e fazem referência à conexão OAuth individual dele vão parar de funcionar até que o usuário faça login com as credenciais do OAuth.

Janelas de manutenção

Ao contrário do Looker (original), uma política de manutenção pode ser especificada para o Looker (Google Cloud Core).

Atividade do sistema para clientes elite

Os dados de atividade do sistema Elite não são copiados como parte da migração. A instância do Looker (Google Cloud Core) vai começar com um histórico novo.

Domínio personalizado

É possível criar um domínio personalizado para sua instância do Looker (Google Cloud Core). É preciso definir os registros DNS para garantir a implantação do certificado SSL. Além disso, atualize o URL de callback no cliente de autenticação para o domínio personalizado depois que ele for ativado e o método de autenticação for configurado. Não é possível criar domínios personalizados para o Looker (Google Cloud Core) usando um domínio looker.com.

Se você quiser criar um domínio personalizado para sua instância do Looker (Google Cloud Core) usando o URL personalizado da sua instância do Looker (original), configure o domínio personalizado depois que a migração for concluída e você confirmar que a instância do Looker (Google Cloud Core) está pronta para ser usada. Depois que o domínio personalizado for ativado, os usuários vão ver a instância do Looker (Google Cloud Core), e não a do Looker (original), ao acessar o URL da instância.

Não configure o SAML ou o OpenID Connect para a instância do Looker (Google Cloud Core) até que ela esteja pronta para uso, os registros DNS tenham sido atualizados e o domínio personalizado tenha sido ativado.

Favoritos

Se você estiver usando um URL personalizado na sua instância do Looker (original) (que não usa o domínio looker.com), esse processo de migração vai manter os favoritos dos usuários se você criar um domínio personalizado para sua instância do Looker (Google Cloud Core) usando o mesmo URL da instância do Looker (original).

Depois que o domínio personalizado for ativado, os favoritos do conteúdo do Looker (original), como https://www.yourcustomdomain.com/dashboard/123, vão apontar para o conteúdo na instância do Looker (Google Cloud Core). Observação: as edições Enterprise e Embed do Looker (Google Cloud Core) usam slugs de conteúdo alfanuméricos nos URLs em vez de IDs de conteúdo numéricos, mas um favorito com um ID de conteúdo ainda vai redirecionar corretamente para o mesmo conteúdo.

Esse processo não pode ser usado com URLs do Looker (original) que usam o domínio looker.com.

Esta não é uma lista completa. Teste todos os aspectos da instância que são mais importantes para você antes de considerar a migração concluída.

Depois que a migração for concluída e você tiver certeza de que não vai precisar de outra exportação, exclua o <export-service-account> que você criou anteriormente, o que inutiliza a chave JSON que foi compartilhada para ele.

Desativar a instância do Looker (original)

Depois que a instância migrada do Looker (Google Cloud Core) estiver funcionando de maneira satisfatória, envie aos usuários o URL da instância e instrua-os a começar a acessá-la e parar de acessar a instância do Looker (original).

Solução de problemas

As seções a seguir podem ajudar a resolver problemas durante a importação ou exportação.

Problemas durante a exportação

Se houver um problema com a exportação dos dados do Looker (original), o status ERRO vai aparecer na página Exportar do painel Administrador. Clique no status ERRO para ver uma mensagem de erro.

As causas comuns de erros são as seguintes:

  • O bucket do Cloud Storage, a chave do KMS ou o <export-service-account> é inválido.
  • O <export-service-account> não tem as permissões necessárias.

É útil confirmar o status desses objetos antes de enviar a solicitação de exportação.

Problemas durante a importação

Se a operação de importação não for concluída após quatro horas (ou possivelmente mais, se a instância de origem for muito grande) ou se ela for encerrada com erro, talvez seja necessário abrir um tíquete com o Cloud Customer Care para resolver o problema. Há relativamente poucos diagnósticos diretamente visíveis para o cliente nessa operação.

A seguir