Como configurar e testar uma conexão do Git

Quando você cria um projeto, ele só existe no Modo de desenvolvimento para que você possa desenvolver o 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.

A configuração de uma conexão do Git para o projeto permite implantar o LookML no Modo de produção, que permite que outros usuários explorem seu modelo de dados, criem painéis e adicionem o LookML a ele. Para uma configuração mais rápida, use um repositório simples. Para uma integração mais robusta do Git, crie seu próprio repositório e siga as instruções desta página para conectá-lo à sua instância do Looker.

Como integrar o Looker com o Git

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

Para o gerenciamento de arquivos de origem do LookML, o Looker pode ser configurado com qualquer provedor do Git que use uma chave SSH ou HTTPS para autenticação. As etapas gerais são as mesmas, não importa qual plataforma você usa. Esta página usa o GitHub como exemplo para conectar um projeto do Looker ao Git depois de criar um repositório do Git.

Para acessar as opções de integração do Git, é necessário ativar o Modo de desenvolvimento.

É possível 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 do 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 do Git usando uma chave de implantação gerada no site do seu provedor do Git, conforme descrito em Como se conectar ao Git usando SSH.

Como se conectar ao Git usando HTTPS

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

Se a sua conta do Git usa a autenticação de dois fatores, você pode acessar o provedor do Git e criar tokens de acesso para usar em vez de senhas. Acesse a postagem da comunidade Como configurar a conexão HTTPS do Git com a autenticação de dois fatores ativada para conferir instruções sobre como criar tokens de acesso pessoal para provedores comuns do Git.

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

Observe o seguinte para a autenticação HTTPS do GitHub:

Autenticação HTTPS de uma única conta

Se você configurar seu projeto LookML com uma única conta do Git, o Looker vai usar essa conta para fazer login no provedor do Git e confirmar as alterações em nome dos desenvolvedores. O Looker faz essas confirmações usando o nome de usuário do desenvolvedor no Looker para que você possa saber qual desenvolvedor fez cada confirmação. Você pode conferir o histórico de confirmação do projeto na interface do seu provedor de Git ou selecionando a opção History no menu do 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 uma única conta, a conta de usuário do Git especificada precisa ter acesso de leitura e gravação ao repositório do Git. Os desenvolvedores do LookML não precisam ter contas de usuário do Git.

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

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

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

  • Cada um dos desenvolvedores do LookML precisa ter uma conta de usuário com seu provedor do 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 do usuário que correspondem 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 de usuário para senhas de conta do Git (ou tokens de acesso) precisam estar ocultos. Ao criar o atributo de senha ou token de acesso, selecione Sim na opção Ocultar valores e insira o URL do provedor do Git no campo Lista de permissões do domínio.
  • Os atributos de usuário para nome e senha do Git (ou token de acesso) 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 de administrador Atributos do usuário, em que um administrador do Looker configurou atributos do usuário para o nome de usuário do Git e o token de acesso do usuário.

Tabela na página "Administrador de atributos do usuário" que mostra os atributos do 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 que 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 autenticação HTTPS do Git, siga estas etapas:

  1. Encontre o URL HTTPS do repositório Git. No caso do GitHub, para novos repositórios (repositórios que ainda não contêm arquivos), o GitHub mostra o URL como parte da configuração inicial. Selecione o botão HTTPS na guia Code para receber o URL HTTPS e, em seguida, selecione o ícone Copy URL to clipboard para copiar para a área de transferência.

    Para repositórios do GitHub já existentes (que já contêm arquivos), você pode conferir o URL HTTPS acessando a guia Code do repositório e selecionando o botão Code. Selecione o link HTTPS. Selecione o ícone Copiar URL para a área de transferência para copiar o URL HTTPS para a á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, acesse o botão Configurar Git (para novos projetos) ou o botão Redefinir conexão do Git (para projetos conectados anteriormente ao Git).

  4. Selecione o botão Configure Git ou Reset Git Connection para abrir a página Configure Git.

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

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

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

    Se o Looker não detectar seu provedor do Git, ele vai pedir que você escolha uma opção no menu suspenso.

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

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

    • Se você selecionou Usar uma única combinação de nome de usuário e senha/token de acesso pessoal, esse é o nome de usuário e a senha (ou token de acesso) do Git que a instância do Looker vai usar para todas as operações do Git. Essa conta de usuário do Git precisa ter acesso de leitura e gravação ao repositório.
    • Se você selecionou Usar atributos do usuário para nome de usuário e senha/token de acesso pessoal, esse é o nome de usuário e a senha (ou token de acesso) do Git que a instância do Looker vai 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.

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

  8. Se você selecionou Usar atributos do usuário para nome de usuário e senha/token de acesso pessoal, o Looker mostra os menus suspensos Atributo do usuário do nome de usuário e Atributo do usuário do token de acesso pessoal 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 específico.

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

  9. Selecione o botão Continuar configuração.

O Git já está configurado para seu projeto LookML. Aqui, você pode validar seu LookML, criar a confirmação inicial e implantar na produção para disponibilizar seu 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 do Git. O Looker gera o par de chaves SSH e exibe a chave pública na interface, conforme mostrado na etapa 4. O Looker usa essa chave de implantação para fazer login no seu provedor do Git e confirmar as alterações em nome dos desenvolvedores do Looker. O Looker faz as confirmações de envio usando o nome de usuário do Looker de um desenvolvedor para que você possa saber quem fez cada confirmação. Você pode conferir o histórico de confirmação do projeto na interface do seu provedor de Git ou selecionando a opção History no menu do 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 autenticação SSH Git, siga estas etapas:

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

  3. Na página Configuração do projeto, execute uma das seguintes ações para abrir a página Configurar Git:

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

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

    Diagrama mostrando a progressão da página "Project Settings" para a página "Configure Git". Os novos projetos vão mostrar um botão "Configurar Git", e os projetos atuais vão mostrar um botão "Redefinir conexão com o Git", mas ambos os botões levam à página "Configurar Git".

  4. Receba o URL SSH do repositório Git. Confira os formatos dos provedores de Git mais 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
    • Phabricator: 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 arquivos), o GitHub mostra o URL SSH na guia Code como parte da configuração inicial. Selecione o botão SSH para receber o URL do SSH e, em seguida, selecione o ícone da área de transferência para copiar o URL.

    Para repositórios do GitHub existentes (que já contêm arquivos), você pode conferir o URL SSH acessando a guia Code do repositório e selecionando o botão Code. Selecione o link Usar SSH. Você pode selecionar o ícone da área de transferência para copiar para a área de transferência.

  5. Na página Configure Git do Looker, cole o URL SSH do repositório do Git no campo Repository URL e selecione Continue.

    Para usar URLs com portas personalizadas ou não padrão do Git com o Looker, adicione o número de porta não padrão ao URL do Git. Por exemplo: ssh://git@corporate.git.server.com:22/myorganization/myproject.git

    Inclua ssh:// para que isso funcione corretamente.

  6. O Looker vai detectar seu provedor do Git e mostrar uma chave de implantação para o repositório. Se o Looker não detectar seu provedor do Git, você vai precisar escolher uma opção em um menu suspenso. Copie a chave de implantação para a área de transferência e selecione o link Configurações da chave de implantação para o repositório para abrir a página Chaves de implantação do repositório do GitHub.

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

    O GitHub mostra a página Deploy keys / Add new.

  8. Adicione um título para a chave de implantação. O nome não é importante, mas é recomendável incluir "Looker" e o título do projeto para acompanhar o andamento 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. Neste ponto, o provedor do Git pode solicitar que você insira sua senha. Se sim, digite sua senha e selecione Confirmar senha.

  12. O GitHub vai mostrar todas as chaves de implantação adicionadas ao repositório.

  13. Volte para a janela do Looker e, na página Configure Git, selecione Test and Finalize Setup.

Aqui, você pode tentar configurar a chave de implantação novamente ou selecionar Skip Tests and Finalize Setup para manter as configurações atuais.

O Git está configurado para seu projeto LookML. Aqui, você pode validar seu LookML, criar a confirmação inicial e implantar na produção para disponibilizar seu 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 fazer a configuração rapidamente para que outras pessoas possam aproveitar seu LookML, configure um repositório Git simples. A configuração de um repositório Git simples cria um repositório Git local na sua instância do Looker, em vez de se conectar a um repositório remoto.

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

Quando você cria um novo projeto durante o processo de geração de um modelo, ele é configurado automaticamente com um repositório simples.

Para configurar um projeto LookML com um repositório Git simples:

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

  3. Na página Configuração do projeto, execute uma das seguintes ações para abrir a página Configurar Git:

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

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

  4. Selecione Configurar um repositório simples na parte de baixo da página Configurar o Git.

  5. Na caixa de diálogo Configurar repositório Git simples, selecione Criar repositório.

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

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

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

Como conectar um novo projeto LookML a um repositório Git que não está vazio

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

  • Ao mover um projeto do LookML entre instâncias
  • Quando você está ressuscitando o código de um projeto do LookML inativo ou quebrado para uso em um novo projeto

Esta seção descreve as práticas recomendadas para configurar um novo projeto do LookML com um repositório Git atual e não vazio para continuar o desenvolvimento 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 ele 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, faça o pull da produção no painel Ações do Git.
  4. Depois de extrair da produção, selecione Implantar na produção.

As mudanças feitas no LookML no seu projeto não afetam o repositório original. Em vez disso, as mudanças são salvas na versão local do repositório.

Se você quiser usar um repositório público específico como base de um projeto vazio 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 público do Git 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, ambiente de testes 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. 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 do Git e se ela tem acesso de gravação ao repositório do Git.

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

Você também pode acessar a ferramenta de teste de conexão do Git selecionando Testar conexão do Git no painel Ações do Git:

A ferramenta de teste de conexão do Git mostra as etapas que está realizando para testar a conexão do Git:

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

Se uma etapa for concluída, o Looker vai mostrar uma marca de seleção verde à esquerda dela. Se uma etapa falhar, o Looker vai mostrar uma marca de seleção vermelha à esquerda dela e uma mensagem de erro.

O exemplo a seguir mostra um teste bem-sucedido:

Caixa de diálogo do teste de conexão do Git mostrando uma lista de etapas com marcas de seleção verdes ao lado delas para indicar que todas as etapas foram concluídas.

No exemplo abaixo, o repositório do 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 concluídas:

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

As marcas de seleção vermelhas à esquerda das duas últimas etapas indicam que elas falharam:

  • Verify authorization credentials
  • Ensure credentials allow write access

Caixa de diálogo do teste de conexão do Git mostrando uma lista de etapas bem-sucedidas e com falha. Um erro na etapa &quot;Verificar credenciais de autorização&quot; mostra a mensagem &quot;Não é possível fazer autenticação remota (chave de implantação do Looker)&quot;.