Um endpoint de implantação do webhook solicita que a instância do Looker implante alterações de um branch do Git, um commit SHA ou um nome de tag e, em seguida, envie as alterações para a versão de produção do seu projeto. Para a maioria dos projetos, o Looker lida com as integrações do Git e implanta as atualizações na produção para que você não precise configurar um webhook de implantação.
No entanto, será necessário usar um webhook de implantação para enviar alterações à produção se uma das seguintes circunstâncias se aplicar:
- Você envia atualizações para a ramificação de produção remota fora do ambiente de desenvolvimento integrado do Looker, o que é comum em fluxos de trabalho de desenvolvimento com ambientes de preparo.
- Você quer usar um webhook para implantar com o modo de implantação avançada, que permite especificar a ramificação, o commit SHA ou o nome da tag usada na versão de produção do projeto do Looker.
- Você configurou seu projeto do Looker com solicitações de envio do Git. Isso significa que você precisa acionar um webhook de implantação depois de mesclar uma solicitação de envio para enviar essas alterações ao seu ambiente de produção do Looker. A maioria dos serviços de hospedagem Git tem maneiras de automatizar isso se você adicionar o webhook à interface do seu provedor Git.
Se você é um administrador do Looker, pode configurar o webhook de implantação para exigir um secret para que apenas partes autorizadas possam acioná-lo.
Os desenvolvedores do Looker que não são administradores podem ver a página Configurações do projeto, mas não podem alterar as opções nela.
Como adicionar um secret de implantação
Para definir um secret de implantação do webhook no seu projeto:
- No Modo de desenvolvimento, abra o projeto e selecione o ícone de configurações na barra de navegação do ambiente de desenvolvimento integrado para abrir o painel de configurações do projeto.
- Selecione Configuração no painel de configurações do projeto.
- Role para baixo até a seção Webhook Deploy Secret e clique em Set Webhook Secret. O Looker gera automaticamente um token secreto. Você pode usar esse secret gerado automaticamente ou digitar seu próprio token.
- Se você estiver usando a chave secreta gerada automaticamente ou criando sua própria chave secreta, copie a chave secreta de implantação do webhook e cole-a em um arquivo de texto para tê-la à mão se precisar adicionar a chave secreta ao webhook do seu repositório. Copie-o neste momento. Depois de sair ou atualizar a página Configurações do projeto, você perderá o acesso à chave secreta de implantação do webhook e precisará alterá-la ou removê-la para recuperar o acesso ao projeto.
- Clique em Save Project Configuration.
O webhook de implantação do projeto agora requer esse secret. Para projetos que usam uma instância de preparo do Looker, é preciso incluir o secret de implantação do webhook no cabeçalho HTTP para implantar na produção. Para projetos com integração solicitação de envio Git, acesse a interface do seu provedor do Git para adicionar o secret ao webhook do seu repositório.
Como configurar o secret para o webhook do seu repositório Git
Para projetos com integração solicitação de envio Git, se você adicionou um segredo de webhook de implantação ao seu projeto LookML, será necessário acessar a interface do seu provedor Git para adicionar o segredo ao webhook do seu repositório. Como exemplo, veja como fazer isso usando o GitHub:
Acesse as configurações do repositório do seu projeto no site do provedor do Git.
DICA: se você configurou seu projeto para a integração do Git, use a opção Ver projeto no Git no menu Git do projeto no Looker.
Nas configurações do repositório, clique em Webhooks.
Encontre o webhook do projeto do LookML e clique no botão Edit.
Na caixa de texto Secret, cole a chave secreta de implantação do webhook que você copiou da seção Secret Deploy Deploy no Looker.
Clique em Atualizar webhook.
O secret do webhook agora é necessário para implantar alterações na versão de produção do seu projeto. Se precisar, mude o secret ou remova-o do seu projeto.
Como alterar um secret de implantação
Depois que um secret de implantação do webhook for adicionado ao projeto, se você for um administrador do Looker, poderá alterá-lo fazendo o seguinte:
- No seu projeto, selecione o ícone Configurações na barra de navegação.
- Role para baixo até a seção Webhook Deploy Secret e clique em Reset Secret. O Looker gerará automaticamente um novo token secreto. Você pode usar esse secret gerado automaticamente ou digitar seu próprio token.
- Se você estiver usando a chave secreta gerada automaticamente ou criando sua própria chave secreta, copie a chave secreta de implantação do webhook e cole-a em um arquivo de texto para tê-la sempre que precisar adicionar a chave secreta ao webhook para seu repositório. Copie-o da área de transferência neste momento. Depois de sair ou atualizar a página Configurações do projeto, você perderá o acesso ao secret de implantação do webhook e terá que voltar e alterá-lo ou removê-lo completamente.
- Clique em Save Project Configuration.
Se o projeto estiver configurado com a integração solicitação de envio do Git, você também precisará acessar a interface do seu provedor do Git para atualizar a chave secreta do webhook para seu repositório.
Como remover um secret de implantação
Depois que um secret de implantação do webhook for adicionado ao projeto, se você for um administrador do Looker, poderá removê-lo fazendo o seguinte:
- No seu projeto, selecione o ícone Configurações na barra de navegação.
- Role para baixo até a seção Webhook Deploy Secret e clique em Remove Secret. Neste ponto, é possível cancelar a operação e manter a chave secreta de implantação clicando em Não remover.
- Para remover permanentemente o secret de implantação do webhook do seu projeto, clique em Salvar configuração do projeto.
Seu projeto não requer mais um secret para o webhook de implantação. Se o projeto estiver configurado com a integração de solicitação de envio do Git, será possível acessar a interface do provedor do Git para remover a chave secreta do webhook do repositório. O Looker não verificará mais um secret no provedor do Git. Por isso, não há problema se o webhook do repositório do Git ainda tiver um secret configurado. Se você quiser remover a chave secreta do seu repositório Git, consulte Como configurar a chave secreta para o webhook do seu repositório Git para mais informações sobre como editar a chave secreta na interface de um provedor Git.