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 o projeto permite implantar o LookML no Modo de produção, o que permite que outros usuários explorem o modelo de dados, criem dashboards e adicionem o LookML ao modelo. Para uma configuração mais rápida, use um repositório nu. Para uma integração Git mais robusta, crie seu próprio repositório Git e siga as instruções nesta página para conectá-lo à sua instância do Looker.
Como integrar o Looker com o Git
O Looker usa o Git para registrar alterações 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 para qualquer plataforma. Nesta página, o GitHub é usado como um exemplo para conectar um projeto do Looker ao Git depois que você cria um repositório Git.
Para acessar as opções de integração do Git, é preciso ativar o Modo de Desenvolvimento.
É possível configurar a integração do Git usando um dos seguintes protocolos:
- HTTPS: é o 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 Git, conforme descrito em Como se conectar ao Git usando SSH.
Como se conectar ao Git usando HTTPS
Em projetos do LookML configurados com autenticação HTTPS, o Looker se conecta ao provedor Git com uma ou mais contas de usuário configuradas com esse provedor. O Looker usa um nome de usuário e uma senha (ou token de acesso) para fazer login no provedor Git e executar operações Git em nome dos desenvolvedores do LookML.
Se sua conta do Git usa autenticação de dois fatores, é possível acessar seu provedor Git e criar tokens de acesso para usar no lugar das senhas. Confira as instruções de como criar tokens de acesso pessoal para provedores Git comuns na postagem Como configurar a conexão HTTPS do Git com a 2FA ativada (em inglês).
Com a autenticação HTTPS, é possível configurar seu projeto do LookML para usar uma única conta Git para todo o projeto ou configurar o projeto para usar as contas Git individuais dos desenvolvedores para executar as operações Git.
Observe o seguinte para a autenticação HTTPS do GitHub:
- O GitHub não aceita senhas de conta para autenticar operações Git em github.com. Consulte a postagem do blog do GitHub (link em inglês) para mais informações. Para conectar um projeto do Looker ao GitHub usando HTTPS, use as configurações do desenvolvedor no GitHub para criar um token de acesso pessoal.
- O Looker não é compatível com os tokens de acesso pessoal detalhados do GitHub. Para conectar seu projeto do Looker ao GitHub usando HTTPS, use a opção Tokens (clássico) do GitHub ao criar um token de acesso pessoal.
Autenticação HTTPS de conta única
Se você configurar o projeto do LookML com uma única conta Git, o Looker usará essa conta para fazer login no provedor Git e confirmar as alterações em nome dos desenvolvedores. O Looker faz essas confirmações usando o nome de usuário do Looker do desenvolvedor. Assim, você consegue saber qual desenvolvedor realizou cada commit. Você pode conferir o histórico de commit do projeto na interface do provedor do 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 autenticação HTTPS de conta única, a conta de usuário do Git especificada precisa ter acesso de leitura e gravação ao 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 de usuário
Se você configurar seu projeto do LookML com várias contas, ele vai usar cada conta Git individual de cada desenvolvedor do Looker para executar 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 use para extrair a versão de produção dos arquivos.
As seguintes tarefas e requisitos 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 no 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 (ou tokens de acesso) de contas Git precisam estar ocultos. Quando você criar o atributo de token de acesso ou senha, selecione Sim na opção Ocultar valores e digite o URL do provedor Git no campo Lista de permissões do domínio.
- Os atributos de usuário de 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 Administrador de Atributos do usuário, em que um administrador do Looker configurou atributos de usuário para o nome de usuário do Git e o token de acesso do usuário.
O exemplo a seguir mostra a página Conta de um usuário do Looker em que o usuário 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 do Git, siga estas etapas:
Confira o URL HTTPS do seu repositório Git. No caso do GitHub, para novos repositórios (que ainda não contêm arquivos), o GitHub vai 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 repositórios existentes do GitHub (repositórios que já contêm arquivos), você pode ver o URL HTTPS acessando a guia Código do repositório e selecionando o botão Código. Selecione o link HTTPS. Se quiser copiar o URL HTTPS para a área de transferência, selecione o ícone Copiar URL para a área de transferência.
Navegue até seu projeto do LookML e selecione o ícone Configurações na barra de navegação.
Na página Configuração do projeto, na guia Configuração, clique no botão Configurar Git (para novos projetos) ou no botão Redefinir conexão Git (para projetos existentes que foram conectados ao Git anteriormente).
Selecione o botão Configure Git ou o botão Reset Git Connection para abrir a página Configure Git.
Redefinir sua conexão do Git preservar o histórico do Git da ramificação principal. Ele também vai preservar o histórico das ramificações pessoais de cada desenvolvedor do Looker depois que elas extrairem, mesclarem e implantarem. Para preservar o histórico de todas as ramificações, consulte a página de práticas recomendadas em Como migrar para um novo repositório Git.
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 seu provedor Git, ele vai solicitar que você escolha uma opção em um menu suspenso.
Selecione sua opção de login do Git:
- Use uma combinação única e constante de nome de usuário e senha/token. Consulte Autenticação HTTPS de conta única.
- Use atributos de usuário para nome de usuário e senha/token. Consulte Autenticação HTTPS de atributo do usuário.
Nos campos Username e Password/Personal Access Token, digite as credenciais que seu projeto do LookML usará para acessar o Git. Isso é necessário independente 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, esse será o nome de usuário e a senha (ou token de acesso) do Git que a instância do Looker usará em todas as operações do Git. Essa conta de usuário do Git precisa ter acesso de leitura e gravação ao repositório Git.
- Se você selecionou Use atributos do usuário para nome de usuário e senha/token de acesso pessoal, esses serão 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 Git precisa ter pelo menos acesso de leitura ao repositório Git.
Se sua conta do Git usa 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 seu provedor Git e crie tokens de acesso para usar no lugar das senhas. Veja as instruções de criação de tokens de acesso pessoal para provedores Git comuns na postagem Como configurar a conexão HTTPS do Git com a 2FA ativada .
Se você tiver selecionado Usar atributos de usuário para nome de usuário e senha/token de acesso pessoal, o Looker vai mostrar os menus suspensos Atributo de usuário de nome de usuário e Atributo de usuário de token de acesso pessoal na seção Credenciais do modo de desenvolvimento. Use os menus suspensos para selecionar os atributos de usuário para as credenciais do Git de um desenvolvedor individual.
Os usuários do Looker podem editar os valores dos campos de atributo na página Conta, ou os administradores do Looker podem editar os valores dos atributos de um usuário na página Usuários.
Selecione o botão Continuar configuração.
O Git agora está configurado para o projeto do LookML. Aqui é possível validar o LookML, criar o commit inicial e implantar na produção para disponibilizar o projeto no Modo de Produção. Você também pode:
- Use o menu do Git para acessar os comandos do Git.
- Use o menu do Git para testar sua conexão do Git.
- Se você for um administrador do Looker, acesse a página Configurações do projeto para exigir a validação do LookML e configurar as opções de integração do Git.
Como se conectar ao Git usando SSH
Com a autenticação SSH, você cria uma chave de implantação para o provedor Git. O Looker gera o par de chaves SSH e exibe a chave pública na UI, conforme mostrado na etapa 4. O Looker usa essa chave para fazer login no seu provedor Git e confirmar as alterações em nome dos desenvolvedores do Looker. O Looker usa o nome de usuário do Looker de um desenvolvedor para fazer confirmações. Você pode conferir o histórico de commit do projeto na interface do provedor do 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 a autenticação SSH do Git, siga estas etapas:
- Abra o projeto ou crie um novo projeto do LookML.
- No seu projeto, selecione o ícone Settings no menu à esquerda para abrir a página Project Configuration.
Na página Configuração do projeto, execute uma das seguintes ações para abrir a página Configurar Git:
- Em um projeto sem conexão Git, selecione o botão Configure Git.
- Para um projeto que já esteja configurado com uma conexão Git, selecione o botão Redefinir conexão Git.
Redefinir sua conexão do Git preservar o histórico do Git da ramificação principal. Ele também vai preservar o histórico das ramificações pessoais de cada desenvolvedor do Looker depois que elas extrairem, mesclarem e implantarem. Para preservar o histórico de todas as ramificações, consulte a página de práticas recomendadas em Como migrar para um novo repositório Git.
Consiga 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 - Fabricador:
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 exibirá o URL do SSH na guia Código como parte da configuração inicial. Selecione o botão SSH para receber o URL SSH e o ícone da área de transferência para copiar para a área de transferência.
Para repositórios existentes do GitHub (repositórios que já contêm arquivos), você pode ver o URL do SSH acessando a guia Código do repositório e selecionando o botão Código. Selecione o link Usar SSH. Você pode selecionar o ícone da área de transferência para copiar para a área de transferência.
- GitHub:
Na página Configurar Git do Looker, cole o URL SSH do repositório Git no campo URL do repositório e selecione Continuar.
URLs com portas Git personalizadas ou não padrão podem ser usados com o Looker adicionando 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É necessário incluir o
ssh://para que isso funcione corretamente.O Looker vai detectar seu provedor Git e exibir uma chave de implantação para seu repositório. Se o Looker não detectar seu provedor Git, ele vai solicitar que você escolha em um 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.
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 novas.
Adicione um título para a chave de implantação. O nome não é importante, mas é possível incluir "Looker" e o título do seu projeto para acompanhá-lo no futuro.
Cole a chave de implantação que você copiou do Looker .
Selecione a opção Permitir acesso de gravação.
Selecione o botão Adicionar chave. Nesse momento, seu provedor Git pode solicitar que você digite sua senha. Se sim, insira sua senha e selecione Confirmar senha.
O GitHub mostrará todas as chaves de implantação que foram adicionadas ao repositório.
Volte para a janela do Looker e, na página Configurar Git, selecione Testar e finalizar configuração.
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 o projeto do LookML. Aqui é possível validar o LookML, criar o commit inicial e implantar na produção para disponibilizar o projeto no Modo de Produção. Você também pode:
- Use o menu do Git para acessar os comandos do Git.
- Use o menu do Git para testar sua conexão do Git.
- Se você for um administrador do Looker, acesse a página Configurações do projeto para exigir a validação do LookML e configurar as opções de integração do Git.
Como configurar um repositório Git básico
Se você ainda não criou um repositório Git remoto ou se quer configurar rapidamente para que outras pessoas possam se beneficiar do seu LookML, é possível configurar um repositório Git básico. 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 o cria no servidor Looker e inicia o histórico do Git para o repositório.
Para configurar um projeto do LookML com um repositório Git básico:
- Abra o projeto ou crie um novo projeto do LookML.
- No seu projeto, selecione o ícone Settings no menu à esquerda para abrir a página Project Configuration.
Na página Configuração do projeto, execute uma das seguintes ações para abrir a página Configurar Git:
- Em um projeto sem conexão Git, selecione o botão Configure Git.
- Para um projeto que já esteja configurado com uma conexão Git, selecione o botão Redefinir conexão Git.
Redefinir sua conexão do Git preservar o histórico do Git da ramificação principal. Ele também vai preservar o histórico das ramificações pessoais de cada desenvolvedor do Looker depois que elas extrairem, mesclarem e implantarem. Para preservar o histórico de todas as ramificações, consulte a página de práticas recomendadas em Como migrar para um novo repositório Git.
Selecione Configurar um repositório vazio na parte inferior da página Configurar Git.
Na caixa de diálogo Configurar repositório Bare Git, selecione Criar repositório.
Depois que o repositório Git for criado, o Looker exibirá uma caixa de diálogo Bare Repository Created.
O Git agora está configurado para o projeto do LookML. Aqui é possível validar o LookML, criar o commit inicial e implantar na produção para disponibilizar o projeto no Modo de Produção. Você também pode:
- Use o menu do Git para acessar os comandos do Git.
- Use o menu do Git para testar sua conexão do Git.
- Se você for um administrador do Looker, acesse a página Configurações do projeto para exigir a validação do LookML e configurar as opções de integração do Git.
Para projetos configurados com um repositório básico, você poderá usar a opção 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 do Git. Se você tiver configurado o projeto do LookML com um repositório vazio, o Looker criará um repositório no servidor do Looker e iniciará o histórico do Git para o repositório. Se, em seguida, você conectar seu projeto do LookML a um repositório Git que tenha um histórico do Git, o Looker não poderá reconciliar os dois históricos do Git e você não poderá executar nenhuma ação do Git.
Como conectar um novo projeto do LookML a um repositório Git não vazio
Configurar o Git para controlar a versão é 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 o LookML existente, como nas seguintes situações:
- Quando você move um projeto do LookML entre instâncias
- Ao recuperar o código de um projeto do LookML corrompido ou extinto 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 não vazio para desenvolvimento posterior do LookML.
- 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, e não de um esquema de banco de dados ou consulta SQL.
- 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.
- Depois de configurar o Git para seu projeto, extraia-se da produção do painel Ações do Git.
- Depois de extrair da produção, selecione Implantar na produção.
As alterações que você fizer no LookML em seu projeto não afetarão o repositório original. Em vez disso, as alterações 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 do LookML em branco, 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 na Comunidade sobre fluxo de trabalho do Git usando um repositório em várias instâncias: desenvolvimento, preparo e produção para saber mais.
Como testar a conexão do Git
O Looker oferece um teste de conexão Git para verificar a conexão. O teste de conexão do Git verifica se você configurou o URL correto do Git e se o Looker pode acessar o host do Git . O teste de conexão do Git também verifica se você forneceu uma chave de implantação do Git válida e se essa chave 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 exibir o texto Test Git Connection para que você resolva o problema de conexão.
Você também pode 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 mostra as etapas necessárias para testar a conexão do Git:
- Examinar o git remoto
- O nome do host do serviço git vai resolver
- A rede com o serviço git está operacional
- Verificar as credenciais de autorização
- Verificar se as credenciais permitem acesso de gravação
Se uma etapa for bem-sucedida, o Looker exibirá 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:
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 concluídas com sucesso:
Examine git remoteHost name for git service will resolveNetworking to the git service is operational
As marcas de seleção vermelhas à esquerda das últimas duas etapas indicam que elas falharam:
Verify authorization credentialsEnsure credentials allow write access
