Com a integração padrão do Looker Git, os desenvolvedores do Looker confirmam as alterações na ramificação de desenvolvimento e depois mesclam a ramificação de desenvolvimento na ramificação de produção. Depois, ao implantar no ambiente do Looker, o Looker usa o commit mais recente na ramificação de produção. Consulte a página de documentação Como usar o controle de versões e a implantação para ver o fluxo de trabalho padrão do Git e outras opções para implementações avançadas do Git.
Para implementações avançadas do Git em que você não quer que o commit mais recente da ramificação de produção seja usado no ambiente do Looker, um administrador do Looker pode ativar o modo de implantação avançado. Quando ativado, o modo de implantação avançada permite que um desenvolvedor com permissão deploy especifique um SHA ou uma tag de confirmação diferente para implantar no ambiente de produção do Looker, em vez de usar a confirmação mais recente na ramificação de produção. Se você quiser implantar uma confirmação de uma ramificação diferente, use o webhook do modo de implantação avançado ou o endpoint da API.
O modo de implantação avançado ajuda a consolidar repositórios em fluxos de trabalho do desenvolvedor em vários ambientes, em que cada ambiente aponta para uma versão diferente de uma base de código. Ela também permite que um ou vários desenvolvedores ou administradores tenham mais controle sobre as mudanças implantadas na produção.
Quando o modo de implantação avançado está ativado, o Looker não solicita que os desenvolvedores implantem as alterações na produção. Em vez disso, o Looker solicita que os desenvolvedores mesclem as mudanças na ramificação de produção. A partir daí, as alterações só podem ser implantadas das seguintes maneiras:
- Usando o gerenciador de implantação
- Acionar um webhook
- Usando um endpoint de API
Como ativar o modo de implantação avançado
Para ativar o modo de implantação avançado:
- No ambiente de desenvolvimento integrado do Looker, acesse a página Configuração do projeto. Para isso, selecione o ícone Configurações no menu e a guia Configuração.
- Na página Configuração do projeto, marque a caixa de seleção ao lado de Ativar o modo de implantação avançada na seção Implantação.
- Selecione o botão Save Project Configuration para salvar as alterações.
Controle de versão com o modo de implantação avançado
Quando o modo de implantação avançado está ativado, o implantar na produção do Looker não é mais uma opção para os desenvolvedores. Em vez disso, quando o desenvolvedor faz um commit, o botão do Git pede que ele mescle as mudanças na ramificação principal, em vez de implantar na produção.
As mudanças são implantadas na produção usando um webhook, a API ou o gerenciador de implantação.
Deployment Manager
Para projetos com o modo de implantação avançado ativado, os desenvolvedores do Looker que têm a permissão deploy podem usar o gerenciador de implantação para implantar um commit ou uma tag no ambiente de produção do Looker.
Para acessar o Deployment Manager, selecione o ícone Implantar no menu suspenso.
O Deployment Manager mostra todas as confirmações e tags que foram implantadas anteriormente usando o modo de implantação avançado.
Se você ainda não usou o modo de implantação avançado para implantar um commit, clique no botão Selecionar commit para conferir o histórico de confirmações que os desenvolvedores do Looker mesclaram à ramificação de produção.
Para projetos que usaram o modo de implantação avançado para implantar uma confirmação, o histórico de confirmação também mostrará as tags associadas a uma confirmação, se houver, e indicará qual confirmação é a versão atual que está sendo usada para produção.
Se a ramificação de produção tiver confirmações mais recentes do que a implantada, o gerenciador de implantação vai mostrar essas informações e a confirmação mais recente que os desenvolvedores do Looker mesclaram à ramificação de produção.
Como implantar uma confirmação do Deployment Manager
Há várias maneiras de implantar uma confirmação pelo Deployment Manager:
- Para implantar uma confirmação que ainda não foi implantada, clique no botão Selecionar commit para selecionar todas as confirmações que foram mescladas à ramificação de produção remota. Se você quiser implantar uma confirmação de uma ramificação diferente, use o webhook do modo de implantação avançado ou o endpoint da API.
- Para implantar a confirmação mesclada mais recentemente na ramificação de produção remota, clique no botão Implantar mais recente.
- Para implantar uma confirmação ou tag que já foi implantada, clique no menu de três pontos Opções no Deployment Manager e depois em Implantar na produção.
Se você escolher uma confirmação que não tenha sido implantada anteriormente, o Deployment Manager exibirá o menu Implantar confirmação. Para implantar um commit no menu Deploy Commit, siga estas etapas:
- Para implantar a confirmação sem atribuir a ela uma tag, selecione Implantar sem inclusão de tags e escolha Implantar no ambiente. Caso contrário, mantenha a opção Tag e implantação selecionada.
Especifique uma tag para a confirmação. Uma tag do Git marca a importância da confirmação no histórico do repositório, como o número ou o nome da versão. Observe o seguinte sobre as tags do Git:
- As tags do Git precisam ser exclusivas no repositório Git. Não é possível usar a mesma tag para duas confirmações diferentes no repositório.
- As tags do Git não podem conter espaços ou determinados caracteres especiais. Consulte a documentação de referência do Git para conhecer as regras de nomenclatura de referências no Git.
Também é possível adicionar uma descrição à tag para dar mais detalhes sobre a confirmação.
Selecione Deploy to Environment para implantar o commit na versão de produção da sua instância do Looker.
Depois de implantar um commit, o gerenciador de implantação vai marcá-lo como a versão atual no ambiente de produção do Looker.
Como implantar com webhooks
Para projetos com o modo de implantação avançado, é possível usar o webhook de implantação para implantar alterações na produção.
Para configurar o webhook de implantação, primeiro adicione um segredo de webhook ao seu projeto do Looker na página Configuração do projeto. Adicionar um secret do webhook garante que somente as partes autorizadas possam acionar o webhook de implantação.
Dois webhooks estão disponíveis para implantar alterações na produção com o modo de implantação avançado ativado. Um webhook é para implantar o cabeçalho de uma ramificação e o outro é para implantar uma tag ou SHA do Git específica.
O webhook para implantar o cabeçalho de uma ramificação usa este formato:
<Looker URL>/webhooks/projects/<LookML project name>/deploy/branch/<Git branch name>
O webhook para implantar um SHA ou uma tag de confirmação usa este formato:
<Looker URL>/webhooks/projects/<LookML project name>/deploy/ref/<commit SHA or tag>
Substitua as informações entre colchetes angulares < >v1.0 do projeto e_faa na instância docsexamples.dev.looker.com do Looker:
https://docsexamples.dev.looker.com/webhooks/projects/e_faa/deploy/ref/v1.0
Como implantar com a API
Em projetos com o modo de implantação avançado, é possível usar a API Looker para implantar mudanças na produção.
Para implantar com a API, o usuário da API que faz a chamada precisa ter a permissão deploy. Consulte as páginas de documentação Autenticação da API Looker e Introdução à API para mais informações sobre como autenticar e usar a API Looker.
Para implantar com a API, use o endpoint deploy_ref_to_production. Esse endpoint pode ser chamado de várias maneiras. Os exemplos a seguir são para os métodos HTTPS e SDK.
HTTPS
Para implantar manualmente usando o endpoint de API deploy_ref_to_production, consulte os exemplos a seguir, que usam o método HTTPS. Para mais informações e exemplos de como chamar manualmente a API usando solicitações CURL, consulte o arquivo readme do GitHub Como autenticar na API (em inglês) ou use o APIs Explorer. É possível instalar o APIs Explorer na sua instância do Looker no Marketplace do Looker.
Use os exemplos a seguir em uma solicitação HTTPS para implantar o cabeçalho de uma ramificação, uma SHA de confirmação específica ou uma tag pelo endpoint de API deploy_ref_to_production:
Implantar o cabeçalho de uma ramificação:
<HOST_URL>/api/4.0/projects/<PROJECT_ID>/deploy_ref_to_production?branch=<BRANCH_NAME>
Implantar um SHA ou uma tag de confirmação:
<HOST_URL>/api/4.0/projects/<PROJECT_ID>/deploy_ref_to_production?ref=<SHA_OR_TAG>
SDK
Como alternativa, use um dos SDKs do Looker em vez de fazer solicitações manuais à API. Os SDKs lidam com detalhes de autenticação, serialização de parâmetros e respostas e outras questões.
A implantação com o deploy_ref_to_production e o método do SDK fica assim:
Implantar a cabeça de uma ramificação:
deploy_ref_to_production(<PROJECT_ID>, {branch: <BRANCH_NAME>})
Implantar um SHA ou uma tag de confirmação:
deploy_ref_to_production(<PROJECT_ID>, {ref: <SHA_OR_TAG>})