Como configurar e testar uma conexão do Git

Quando você cria um novo projeto, ele existe apenas no modo de desenvolvimento para permitir que você desenvolva seu modelo em um ambiente seguro que não afete outros usuários. Quando estiver tudo pronto para publicar seu projeto, a próxima etapa é configurar uma conexão do Git.

Configurar uma conexão do Git para seu projeto permite implantar o LookML no Modo de produção. Assim, outros usuários podem explorar seu modelo de dados, criar painéis e adicionar o LookML ao seu modelo. Para uma configuração mais rápida, use um repositório básico. Para uma integração Git mais robusta, crie seu próprio repositório Git e siga as instruções desta página para conectá-lo à instância do Looker.

Integrar o Looker ao Git

O Looker usa o Git para registrar mudanças e gerenciar versões de arquivos. Cada projeto do LookML corresponde a um repositório Git. Sempre que um usuário está no Modo de Desenvolvimento, ele está em sua própria ramificação Git.

Para o gerenciamento de arquivos de origem do LookML, o Looker pode ser configurado com qualquer provedor Git que use uma chave SSH ou HTTPS para autenticação. As etapas gerais são as mesmas, independentemente da plataforma usada. Nesta página, o GitHub é usado como exemplo para conectar um projeto do Looker ao Git após a criação de um repositório Git.

Para acessar as opções de integração do Git, é preciso ativar o Modo de Desenvolvimento.

Você pode configurar a integração do Git usando um dos seguintes protocolos:

  • HTTPS: protocolo de transferência de hipertexto seguro. Com o HTTPS, o Looker acessa seu repositório Git com um nome de usuário e uma senha (ou token de acesso) fornecidos por você, conforme descrito em Como se conectar ao Git usando HTTPS.
  • SSH: Secure Shell. Com o SSH, o Looker acessa seu repositório Git usando uma chave de implantação gerada no site do provedor do Git, conforme descrito em Como se conectar ao Git usando SSH.

Como se conectar ao Git usando HTTPS

Em projetos LookML configurados com autenticação HTTPS, o Looker se conecta ao provedor Git com uma ou mais contas de usuário configuradas por você. O Looker usa um nome de usuário e uma senha (ou token de acesso) para fazer login no provedor Git e realizar operações do Git em nome dos desenvolvedores do LookML.

Se sua conta Git usa autenticação de dois fatores, acesse seu provedor Git e crie tokens de acesso para usar em vez de senhas. Acesse a postagem na comunidade Como configurar a conexão HTTPS do Git com 2FA ativada para conferir as instruções de criação de tokens de acesso pessoal para provedores Git comuns.

Com a autenticação HTTPS, é possível configurar seu projeto do LookML para usar uma única conta do Git em todo o projeto ou configurar o projeto para usar as contas individuais do Git dos desenvolvedores para executar as operações do Git.

Para a autenticação HTTPS do GitHub, observe o seguinte:

Autenticação HTTPS de conta única

Se você configurar o projeto LookML com uma única conta Git, o Looker usará essa conta para fazer login no provedor Git e confirmar mudanças em nome dos desenvolvedores. O Looker faz essas confirmações usando o nome de usuário do Looker do desenvolvedor para que você saiba qual desenvolvedor fez cada confirmação. É possível conferir o histórico de confirmações do projeto na interface do provedor Git ou selecionando a opção History no menu Git do ambiente de desenvolvimento integrado do Looker. Consulte Como executar comandos do Git no Looker para mais informações sobre os menus do Git no Looker.

Para a autenticação HTTPS de conta única, a conta de usuário do Git especificada precisa ter acesso de leitura e gravação ao seu repositório Git. Os desenvolvedores do LookML não precisam ter as próprias contas de usuário do Git.

Autenticação HTTPS de várias contas com atributos do usuário

Se você configurar um projeto LookML com várias contas, ele usará a conta Git individual de cada desenvolvedor do Looker para realizar operações Git. Você também precisa configurar uma conta de usuário genérica do Git, com pelo menos acesso de leitura, que o Looker usará para extrair a versão de produção dos arquivos.

As tarefas e os requisitos abaixo são necessários para a autenticação do Git com atributos de usuário:

  • Cada um dos desenvolvedores do LookML precisa ter a própria conta de usuário com o provedor Git. Cada conta de usuário do Git precisa ter acesso de leitura e gravação ao repositório do projeto.
  • O administrador do Looker precisa configurar contas de usuário do Looker com atributos de usuário que correspondam ao nome de usuário e à senha do Git (ou token de acesso se as contas de usuário do Git tiverem autenticação de dois fatores).
  • Os atributos do usuário para senhas de conta Git (ou tokens de acesso) precisam estar ocultos. Quando você criar o atributo de senha ou token de acesso, selecione Yes na opção Hide Values e digite o URL do provedor Git no campo Lista de permissões do domínio.
  • Os atributos de usuário para nome e senha (ou token de acesso) do Git precisam ser preenchidos para cada desenvolvedor do Looker. Os atributos do usuário podem ser configurados por um administrador do Looker ou pelo usuário do Looker.

O exemplo a seguir mostra a página Administrador de Atributos do usuário, em que um administrador do Looker configurou atributos de usuário para o nome de usuário Git e o token de acesso do usuário.

Tabela na página Administrador de atributos do usuário que exibe os atributos de usuário do tipo string github_token e github_username.

O exemplo a seguir mostra a página Conta de um usuário do Looker em que ele inseriu as credenciais do Git nos campos de atributo do usuário.

Como configurar a autenticação HTTPS do Git

Para configurar um projeto do LookML com a autenticação HTTPS Git, siga estas etapas:

  1. Confira o URL HTTPS do seu repositório Git. No caso do GitHub, para novos repositórios (que ainda não contêm nenhum arquivo), o GitHub mostrará o URL como parte da configuração inicial. Selecione o botão HTTPS na guia Código para receber o URL HTTPS. Em seguida, selecione o ícone Copiar URL para a área de transferência para copiá-lo para a área de transferência.

    Para acessar os repositórios atuais do GitHub (repositórios que já contêm arquivos), você pode acessar o URL HTTPS na guia Código do repositório e selecionar o botão Código. Selecione o link HTTPS. Selecione o ícone Copiar URL para a área de transferência para copiar o URL HTTPS para sua área de transferência.

  2. Acesse seu projeto do LookML e selecione o ícone Configurações na barra de navegação.

  3. Na página Configuração do projeto, na guia Configuração, clique no botão Configurar Git (para projetos novos) ou no botão Redefinir conexão Git (para projetos existentes que foram conectados ao Git anteriormente).

  4. Selecione o botão Configurar Git ou Redefinir conexão Git para abrir a página Configurar Git.

    Redefinir a conexão do Git preserva o histórico do Git da ramificação principal. Ele também preserva o histórico da ramificação pessoal de cada desenvolvedor do Looker depois de extrair, mesclar e implantar. Para preservar o histórico de todas as ramificações, consulte a página de práticas recomendadas Como migrar para um novo repositório Git.

  5. Na página Configurar Git do Looker, cole o URL HTTPS do repositório Git no campo URL do repositório e selecione Continuar.

    O Looker vai detectar o provedor Git e atualizar a janela com informações sobre o repositório Git.

    Se o Looker não detectar o provedor Git, ele vai solicitar que você escolha uma opção em um menu suspenso.

  6. Selecione sua opção de login do Git:

  7. Nos campos Nome de usuário e Senha/Token de acesso pessoal, digite as credenciais que o projeto do LookML usará para acessar o Git. Isso é necessário independentemente da configuração de login do Git:

    • Se você selecionou Usar uma combinação única e constante de nome de usuário e senha/token de acesso pessoal, esses são o nome de usuário e a senha (ou token de acesso) do Git que sua instância do Looker vai usar para todas as operações Git. Essa conta de usuário do Git precisa ter acesso de leitura e gravação ao repositório Git.
    • Se você selecionou Usar atributos do usuário para nome de usuário e senha/token de acesso pessoal, esses são o nome de usuário e a senha (ou token de acesso) do Git que sua instância do Looker usará para extrair a versão de produção do repositório. Essa conta de usuário do Git precisa ter pelo menos acesso de leitura ao repositório Git.

    Se sua conta Git usar autenticação de dois fatores ou se você estiver usando o GitHub (que exige um token de acesso pessoal em vez de uma senha), acesse o provedor Git e crie tokens de acesso para usar em vez de senhas. Acesse a postagem na comunidade Como configurar a conexão HTTPS do git com a 2FA ativada para conferir as instruções de criação de tokens de acesso pessoal para provedores Git comuns.

  8. Se você selecionar Use user atributos for username and password/personal access token, o Looker vai mostrar os menus suspensos Username User Attribute e Personal Access Token User Attribute na seção Credenciais do modo de desenvolvimento. Use os menus suspensos para selecionar os atributos do usuário para as credenciais do Git de um desenvolvedor.

    Os usuários do Looker podem editar os valores dos campos de atributo do usuário na página Conta, ou os administradores do Looker podem editar os valores dos atributos de um usuário na página de administração Usuários.

  9. Selecione o botão Continue Setup.

O Git agora está configurado para seu projeto do LookML. Aqui é possível validar o LookML, criar a confirmação inicial e implantar na produção para disponibilizar o projeto no Modo de produção. Você também pode:

Como se conectar ao Git usando SSH

Com a autenticação SSH, você cria uma chave de implantação para seu provedor Git. O Looker gera o par de chaves SSH e mostra a chave pública na UI, conforme mostrado na etapa 4. O Looker usa essa chave de implantação para fazer login no seu provedor Git e confirmar mudanças em nome dos desenvolvedores do Looker. O Looker faz confirmações usando o nome de usuário do Looker de um desenvolvedor para que você saiba qual foi o processo. É possível conferir o histórico de confirmações do projeto na interface do provedor Git ou selecionando a opção History no menu Git do ambiente de desenvolvimento integrado do Looker. Consulte Como executar comandos do Git no Looker para mais informações sobre os menus do Git no Looker.

Para configurar um projeto do LookML com a autenticação SSH do Git, siga estas etapas:

  1. Abra seu projeto ou crie um novo projeto do LookML.
  2. No projeto, selecione o ícone Settings no menu à esquerda para abrir a página Project Configuration.

  3. Na página Project Configuration, execute uma das seguintes ações para abrir a página Configure Git:

    • Em um projeto sem conexão Git, selecione o botão Configurar Git.
    • Em um projeto que já esteja configurado com uma conexão Git, selecione o botão Redefinir conexão Git.

    Redefinir a conexão do Git preserva o histórico do Git da ramificação principal. Ele também preserva o histórico da ramificação pessoal de cada desenvolvedor do Looker depois de extrair, mesclar e implantar. Para preservar o histórico de todas as ramificações, consulte a página de práticas recomendadas Como migrar para um novo repositório Git.

    Diagrama mostrando a progressão da página de configurações do projeto para a página de configuração do Git. Os novos projetos vão mostrar um botão "Configurar Git", e os projetos existentes vão mostrar um botão "Redefinir o Git Connect", mas os dois botões levam à página "Configurar Git".

  4. Verifique o URL SSH do seu repositório Git. Estes são os formatos para provedores Git comuns:

    • 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
    • Phabrificador: ssh://username@example.com/diffusion/MYCALLSIGN/<repository-name>.git

    No caso do GitHub, para novos repositórios (repositórios que ainda não contêm nenhum arquivo), o GitHub exibirá o URL SSH na guia Código como parte da configuração inicial. Selecione o botão SSH para acessar o URL do SSH e depois selecione o ícone da área de transferência para copiá-lo para a área de transferência.

    Para acessar os repositórios atuais do GitHub (repositórios que já contêm arquivos), acesse a guia Código do repositório e clique no botão Código para ver o URL do SSH. Selecione o link Usar SSH. É possível selecionar o ícone da área de transferência para copiar para a área de transferência.

  5. Na página Configurar Git do Looker, cole o URL do SSH do seu repositório Git no campo URL do repositório e selecione Continuar.

    Os URLs com portas Git personalizadas ou não padrão podem ser usados com o Looker. Basta adicionar o número da porta não padrão ao URL do Git. Por exemplo: ssh://git@corporate.git.server.com:22/myorganization/myproject.git

    Você precisa incluir o ssh:// para que isso funcione corretamente.

  6. O Looker detectará o provedor Git e exibirá uma chave de implantação para seu repositório. Se o Looker não detectar o provedor Git, ele vai solicitar que você escolha uma opção no menu suspenso. Copie a chave de implantação para a área de transferência e selecione o link Implantar configurações da chave para seu repositório para abrir a página Implantar chaves do GitHub para seu repositório do GitHub.

  7. Na guia Configurações do GitHub, na página Implantar chaves, selecione o botão Adicionar chave de implantação:

    O GitHub exibe a página Implantar chaves / Adicionar nova.

  8. Adicione um título para a chave de implantação. O nome não é importante, mas você pode querer incluir "Looker" e o título do seu projeto para acompanhá-lo no futuro.

  9. Cole a chave de implantação que você copiou do Looker .

  10. Selecione a opção Permitir acesso de gravação.

  11. Selecione o botão Adicionar chave. Nesse momento, o provedor Git pode solicitar que você digite sua senha. Nesse caso, digite sua senha e selecione Confirmar senha.

  12. O GitHub mostrará todas as chaves de implantação que foram adicionadas ao seu repositório.

  13. Volte para a janela do Looker e, na página Configurar Git, selecione Testar e finalizar a configuração.

Aqui, tente configurar a chave de implantação novamente ou selecione Pular testes e finalizar configuração para manter as configurações atuais.

O Git agora está configurado para seu projeto do LookML. Aqui é possível validar o LookML, criar a confirmação inicial e implantar na produção para disponibilizar o projeto no Modo de produção. Você também pode:

Como configurar um repositório Git básico

Se você ainda não criou um repositório Git remoto ou se quer apenas configurar rapidamente para que outras pessoas se beneficiem do LookML, configure um repositório Git em branco. A configuração de um repositório Git básico cria um repositório Git local na instância do Looker, em vez de se conectar a um repositório remoto.

Quando você seleciona a opção para criar um repositório raiz, o Looker cria o repositório no servidor do Looker e inicia o histórico do Git.

Para configurar um projeto do LookML com um repositório Git básico:

  1. Abra seu projeto ou crie um novo projeto do LookML.
  2. No projeto, selecione o ícone Settings no menu à esquerda para abrir a página Project Configuration.

  3. Na página Project Configuration, execute uma das seguintes ações para abrir a página Configure Git:

    • Em um projeto sem conexão Git, selecione o botão Configurar Git.
    • Em um projeto que já esteja configurado com uma conexão Git, selecione o botão Redefinir conexão Git.

    Redefinir a conexão do Git preserva o histórico do Git da ramificação principal. Ele também preserva o histórico da ramificação pessoal de cada desenvolvedor do Looker depois de extrair, mesclar e implantar. Para preservar o histórico de todas as ramificações, consulte a página de práticas recomendadas Como migrar para um novo repositório Git.

  4. Selecione Configurar um repositório bare na parte de baixo da página Configurar Git, localizada acima do botão Continuar.

  5. Na caixa de diálogo Configure Bare Git Repository, selecione Create Repository (Criar repositório).

    Depois que o repositório Git for criado, o Looker vai mostrar a caixa de diálogo Bare Repository Created.

O Git agora está configurado para seu projeto do LookML. Aqui é possível validar o LookML, criar a confirmação inicial e implantar na produção para disponibilizar o projeto no Modo de produção. Você também pode:

Para projetos configurados com um repositório simples, você poderá usar Redefinir conexão Git depois, se quiser conectar o projeto a um provedor Git (consulte os procedimentos para usar HTTPS ou SSH). No entanto, não se conecte a um repositório Git que já tenha um histórico Git. Se você tiver configurado seu projeto do LookML com um repositório simples, o Looker vai criar um no servidor do Looker e iniciar o histórico do Git. Se você conectar seu projeto do LookML posteriormente a um repositório Git que tenha um histórico do Git, o Looker não conseguirá reconciliar os dois históricos Git e você não poderá realizar nenhuma ação do Git.

Conectar um novo projeto do LookML a um repositório Git não vazio

Configurar o Git para controle de versões é uma etapa fundamental na criação de um novo projeto do LookML. Normalmente, cada projeto precisa ter o próprio repositório. No entanto, pode ser necessário configurar um projeto com um repositório Git que contenha LookML já existente, como nas seguintes situações:

  • Ao mover um projeto do LookML existente entre instâncias
  • Quando você está recuperando o código de um projeto LookML corrompido ou extinto para uso em um novo projeto.

Esta seção descreve as práticas recomendadas para configurar um novo projeto LookML com um repositório Git atual e não vazio para desenvolvimento posterior do LookML.

  1. Crie um novo projeto do LookML selecionando Blank Project como ponto de partida. Um projeto em branco é o ponto de partida, porque será preenchido com objetos LookML de um repositório existente, em vez de um esquema de banco de dados ou consulta SQL.
  2. Configure o Git para seu projeto usando HTTPS ou SSH, usando o URL do projeto não vazio na seção URL do repositório da página Configurar Git.
  3. Depois de configurar o Git para seu projeto, extraia da produção no painel Git Actions.
  4. Depois de extrair da produção, selecione Deploy to Production.

As alterações feitas no LookML no seu projeto não afetarão o repositório original. Em vez disso, serão salvas na versão local do repositório.

Se você quiser usar um repositório público específico como a base de um projeto em branco do LookML, mas não tiver acesso de gravação a ele, siga as instruções descritas na seção Como clonar um repositório Git público da página de documentação Como criar um novo projeto do LookML.

Se você estiver configurando um fluxo de trabalho do Git usando um repositório em várias instâncias, consulte a postagem da Comunidade sobre Fluxo de trabalho do Git usando um repositório em várias instâncias: desenvolvimento, preparo e produção para mais informações.

Como testar sua conexão do Git

O Looker oferece um teste de conexão do Git para verificar sua conexão com o Git. O teste de conexão do Git verifica se você configurou o URL correto do Git e se o host do Git pode ser acessado pelo Looker . O teste de conexão do Git também verifica se você forneceu uma chave de implantação válida e se ela tem acesso de gravação ao repositório Git.

Se o Looker não conseguir se conectar ao seu repositório Git, o botão Git vai mostrar o texto Testar conexão Git para solicitar que você solucione o problema de conexão.

Também é possível acessar a ferramenta de teste de conexão do Git selecionando Test Git Connection no painel Git actions:

Em seguida, a ferramenta de teste de conexão do Git exibirá as etapas necessárias para testar a conexão do Git:

  1. Examinar o git remoto
  2. O nome do host para o serviço git será resolvido
  3. A rede para o serviço Git está operacional
  4. Verificar credenciais de autorização
  5. Verificar se as credenciais permitem o acesso de gravação

Se uma etapa for bem-sucedida, o Looker vai mostrar uma marca de seleção verde à esquerda da etapa. Se uma etapa não for bem-sucedida, o Looker vai mostrar uma marca de seleção vermelha à esquerda da etapa e uma mensagem de erro.

O exemplo a seguir mostra um teste bem-sucedido:

Caixa de diálogo &quot;git Connection Test&quot; exibindo uma lista de etapas com marcas de seleção verdes ao lado delas para indicar que todas foram concluídas.

No exemplo a seguir, o repositório Git não tem uma chave de implantação configurada para a conexão do Looker. As marcas de seleção verdes à esquerda das três primeiras etapas indicam que elas foram bem-sucedidas:

  • Examine git remote
  • Host name for git service will resolve
  • Networking to the git service is operational

As marcas de verificação vermelha à esquerda das últimas duas etapas indicam que estas etapas falharam:

  • Verify authorization credentials
  • Ensure credentials allow write access

Caixa de diálogo &quot;Teste de conexão do Git&quot; exibindo uma lista de etapas bem-sucedidas e com falha. Na etapa &quot;Verificar credenciais de autorização&quot;, há um erro que diz &quot;Não é possível fazer AUTENTICAÇÃO para remoto&quot; (chave de implantação do Looker).