Com a integração do Git do Looker predefinida, os programadores do Looker consolidam as respetivas alterações no ramo de desenvolvimento e, em seguida, unem o ramo de desenvolvimento ao ramo de produção. Em seguida, quando implementa no ambiente do Looker, o Looker usa a confirmação mais recente no ramo de produção. (Consulte a página de documentação Usar o controlo de versões e implementar para ver o fluxo de trabalho Git predefinido e outras opções para implementações Git avançadas.)
Para implementações avançadas do Git em que não quer que a confirmação mais recente no ramo de produção seja usada para o seu ambiente do Looker, um administrador do Looker pode ativar o modo de implementação avançado. Quando ativado, o modo de implementação avançado permite que um programador com autorização deploy especifique um SHA ou uma etiqueta de commit diferente para implementar no seu ambiente de produção do Looker, em vez de usar o commit mais recente no ramo de produção. Se quiser implementar uma confirmação a partir de um ramo diferente, pode usar o webhook ou o ponto final da API do modo de implementação avançado.
O modo de implementação avançado ajuda a consolidar repositórios em fluxos de trabalho de programadores com vários ambientes, em que cada ambiente aponta para uma versão diferente de uma base de código. Também dá a um ou vários programadores ou administradores um maior controlo sobre as alterações implementadas na produção.
Quando o modo de implementação avançado está ativado, o Looker não pede aos programadores que implementem as respetivas alterações na produção. Em alternativa, o Looker pede aos programadores que unam as respetivas alterações ao ramo de produção. A partir daí, as alterações só podem ser implementadas das seguintes formas:
- Usando o gestor de implementação
- Acionar um webhook
- Usar um ponto final da API
Ativar o modo de implementação avançado
Para ativar o modo de implementação avançado:
- No IDE do Looker, navegue para a página Configuração do projeto selecionando o ícone Definições no menu de ícones e, de seguida, selecionando o separador Configuração.
- Na página Configuração do projeto, selecione a caixa de verificação junto a Ativar modo de implementação avançado na secção Implementação.
- Selecione o botão Guardar configuração do projeto para guardar a alteração.
Controlo de versões com o modo de implementação avançado
Quando o modo de implementação avançado está ativado, a implementação em produção a partir do Looker deixa de ser uma opção para os programadores. Em alternativa, quando o programador faz uma consolidação, o botão do Git pede-lhe que una as alterações ao ramo principal, em vez de lhe pedir que faça a implementação para produção.
As alterações são implementadas na produção através de um webhook, da API ou do gestor de implementação.
Gestor de implementação
Para projetos com o modo de implementação avançado ativado, os programadores do Looker que tenham a autorização deploy podem usar o gestor de implementação para implementar uma confirmação ou uma etiqueta no respetivo ambiente de produção do Looker.
Pode aceder ao gestor de implementação selecionando o ícone Implementar no menu de ícones.
O gestor de implementação mostra todas as confirmações e etiquetas que foram implementadas anteriormente através do modo de implementação avançado.
Se ainda não usou o modo de implementação avançado para implementar uma confirmação, clique no botão Selecionar confirmação para ver o histórico de confirmações com as confirmações que os seus programadores do Looker uniram ao ramo de produção.
Para projetos que usaram o modo de implementação avançado para implementar uma confirmação, o histórico de confirmações também mostra as etiquetas associadas de uma confirmação, se existirem, e indica qual é a versão atual que está a ser usada para produção.
Se a ramificação de produção tiver commits mais recentes do que o commit implementado, o gestor de implementação apresenta estas informações e mostra o commit mais recente que os programadores do Looker uniram à ramificação de produção.
Implementar uma confirmação a partir do Gestor de implementações
Existem várias formas de implementar uma confirmação a partir do gestor de implementação:
- Para implementar uma confirmação que ainda não foi implementada, clique no botão Selecionar confirmação para selecionar entre todas as confirmações que foram unidas ao ramo de produção remoto. (Se quiser implementar uma confirmação a partir de um ramo diferente, use o webhook do modo de implementação avançado ou o ponto final da API.)
- Para implementar a confirmação unida mais recentemente no ramo de produção remoto, clique no botão Implementar mais recente.
- Para implementar uma confirmação ou uma etiqueta que tenha sido implementada anteriormente, clique no respetivo menu de Opções de três pontos no gestor de implementação e, de seguida, em Implementar em produção.
Se escolher um commit que não tenha sido implementado anteriormente, o gestor de implementação apresenta o menu Implementar commit. Para implementar uma confirmação a partir do menu Implementar confirmação, siga estes passos:
- Para implementar a confirmação sem lhe atribuir uma etiqueta, selecione Implementar sem etiquetar e, de seguida, Implementar no ambiente. Caso contrário, mantenha a opção Etiquetar e implementar selecionada.
Especifique uma etiqueta para a confirmação. Uma etiqueta Git marca a importância da confirmação no histórico do repositório, como um número de lançamento ou um nome de versão. Tenha em atenção o seguinte acerca das etiquetas Git:
- As etiquetas Git têm de ser exclusivas no repositório Git. Não pode usar a mesma etiqueta para duas confirmações diferentes no seu repositório.
- As etiquetas Git não podem conter espaços nem determinados carateres especiais. Consulte a documentação de referência do Git para ver as regras de atribuição de nomes a referências no Git.
Opcionalmente, pode adicionar uma descrição à etiqueta para fornecer mais detalhes sobre a confirmação.
Selecione Implementar no ambiente para implementar a confirmação na versão de produção da sua instância do Looker.
Depois de implementar uma confirmação, o gestor de implementação marca a confirmação como a versão atual no seu ambiente de produção do Looker.
Implementação com webhooks
Para projetos com o modo de implementação avançado, pode usar o webhook de implementação para implementar alterações na produção.
Para configurar o webhook de implementação, primeiro tem de adicionar um segredo de webhook para o seu projeto do Looker na página Project Configuration. A adição de um segredo de webhook garante que apenas as partes autorizadas podem acionar o webhook de implementação.
Estão disponíveis dois webhooks para implementar alterações na produção com o modo de implementação avançado ativado. Um webhook destina-se à implementação da parte principal de um ramo e o outro destina-se à implementação de uma etiqueta ou um SHA do Git específico.
O webhook para implementar o cabeçalho de um ramo usa este formato:
<Looker URL>/webhooks/projects/<LookML project name>/deploy/branch/<Git branch name>
O webhook para implementar um SHA de commit ou uma etiqueta usa este formato:
<Looker URL>/webhooks/projects/<LookML project name>/deploy/ref/<commit SHA or tag>
Substitua as informações entre parênteses angulares < >v1.0 para o projeto e_faa na instância do docsexamples.dev.looker.com Looker:
https://docsexamples.dev.looker.com/webhooks/projects/e_faa/deploy/ref/v1.0
Implementação com a API
Para projetos com o modo de implementação avançado, pode usar a API Looker para implementar alterações na produção.
Para fazer a implementação com a API, o utilizador da API que faz a chamada tem de ter a autorização deploy. Consulte as páginas de documentação Autenticação da API Looker e Introdução à API para mais informações sobre a autenticação e a utilização da API Looker.
Para fazer a implementação com a API, use o ponto final deploy_ref_to_production. Este ponto final pode ser chamado de várias formas diferentes. Os exemplos seguintes destinam-se aos métodos HTTPS e SDK.
HTTPS
Para fazer a implementação manual através do ponto final da API deploy_ref_to_production, consulte os seguintes exemplos, que usam o método HTTPS. Para mais informações e exemplos de chamadas manuais à API através de pedidos CURL, consulte o ficheiro Readme Como autenticar na API do GitHub ou use o API Explorer. Pode instalar o Explorador de APIs na sua instância do Looker a partir do Looker Marketplace.
Use os seguintes exemplos num pedido HTTPS para implementar o início de um ramo ou um SHA ou uma etiqueta de confirmação específicos através do ponto final da API deploy_ref_to_production:
Implemente o início de um ramo:
<HOST_URL>/api/4.0/projects/<PROJECT_ID>/deploy_ref_to_production?branch=<BRANCH_NAME>
Implemente um SHA de consolidação ou uma etiqueta:
<HOST_URL>/api/4.0/projects/<PROJECT_ID>/deploy_ref_to_production?ref=<SHA_OR_TAG>
SDK
Em alternativa, use um dos SDKs do Looker em vez de fazer pedidos manuais à API. Os SDKs processam os detalhes da autenticação, da serialização de parâmetros e respostas, e outras questões.
A implementação com o elemento deploy_ref_to_production com o método do SDK tem o seguinte aspeto:
Implemente o início de um ramo:
deploy_ref_to_production(<PROJECT_ID>, {branch: <BRANCH_NAME>})
Implemente um SHA de consolidação ou uma etiqueta:
deploy_ref_to_production(<PROJECT_ID>, {ref: <SHA_OR_TAG>})