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.
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 simples. 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 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. 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: 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 do 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
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:
- O GitHub não aceita senhas de conta para autenticar operações do Git no 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 oferece suporte aos 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 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 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 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 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 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 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 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 de usuário para senhas de conta do Git (ou tokens de acesso) 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 autenticação HTTPS do Git, siga estas etapas:
Acesse o URL HTTPS do repositório do Git. No caso do GitHub, para novos repositórios (que ainda não contêm arquivos), o GitHub mostrará o URL como parte da configuração inicial. Selecione o botão HTTPS na guia Código para ver 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 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.
Acesse 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, acesse o botão Configurar Git (para projetos novos) ou o botão Redefinir conexão do Git (para projetos conectados anteriormente ao Git).
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 Migrar para um novo repositório do Git.
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 o provedor Git e atualizar a janela com informações sobre o repositório Git.
Se o Looker não detectar seu provedor do Git, ele vai pedir que você escolha uma opção no menu suspenso.
Selecione a opção de login do Git:
- Usar uma única combinação constante de nome de usuário e senha/token (consulte Autenticação HTTPS de uma única conta).
- Use atributos de usuário para nome de usuário e senha/token. Consulte Autenticação HTTPS do atributo do usuário.
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 é 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, 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 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 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 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 seu provedor Git e crie tokens de acesso para usar no lugar das 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.
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 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.
Selecione o botão Continuar configuração.
O Git agora está configurado para seu projeto do LookML. Aqui, você pode validar seu LookML, criar a confirmação 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.
- Se você for um administrador do Looker, acesse as configurações do projeto para exigir a validação do LookML e definir 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 autenticação SSH 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á 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 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.
Receba o URL SSH do 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 - 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 exibirá o URL do SSH na guia Código 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 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 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.
Na guia Configurações do GitHub, na página Chaves de implantação, 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 talvez você queira 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 Add key. Neste ponto, o provedor do Git pode solicitar que você insira sua senha. Se sim, insira sua senha e selecione Confirmar senha.
O GitHub vai mostrar todas as chaves de implantação adicionadas ao repositório.
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 agora está configurado para seu projeto do 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:
- Use o menu do Git para acessar os comandos do Git.
- Use o menu do Git para testar sua conexão.
- Se você for administrador do Looker, acesse as 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 apenas 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 simples:
- 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á está configurado com uma conexão do Git, selecione o botão Redefinir conexão do 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 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.
Selecione Configurar um repositório simples na parte de baixo da página Configurar o 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 seu projeto do 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:
- Use o menu do Git para acessar os comandos do Git.
- Use o menu do Git para testar sua conexão.
- Se você for um administrador do Looker, acesse as configurações do projeto para exigir a validação do LookML e definir as opções de integração do Git.
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 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 ele será preenchido com objetos LookML de um repositório existente, em vez 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. as alterações serão salvas na sua 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 sua 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 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 do Git, o botão Git vai mostrar o texto Testar conexão do Git para que você resolva o problema.
Você também pode acessar a ferramenta de teste de conexão do Git selecionando Test Git Connection no painel Git actions:
A ferramenta de teste de conexão do Git mostra as etapas necessárias para testar a conexão do Git:
- Examinar o repositório remoto do Git
- O nome do host para o serviço do Git será resolvido
- A rede para o serviço do 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 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 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
