As execuções de integração contínua (CI) podem ser acionadas de várias maneiras:
- Automaticamente quando uma solicitação de envio é enviada ao repositório do seu projeto do LookML por um desenvolvedor do Looker. Consulte a página Como criar um pacote de integração contínua para saber como configurar isso.
- Automaticamente quando uma solicitação de envio é enviada para um projeto do LookML importado. Consulte a página Como criar um pacote de integração contínua para saber como configurar isso.
- Automaticamente quando um job de CI do dbt Cloud é concluído (consulte a página Como criar um pacote de integração contínua para saber como configurar isso).
- Automaticamente em uma programação recorrente (consulte a página Como criar um pacote de integração contínua para saber como configurar isso).
- Acionar manualmente uma nova execução de um pacote de CI no ambiente de desenvolvimento integrado do Looker.
- Executar manualmente uma execução de CI anterior no ambiente de desenvolvimento integrado do Looker.
Depois que os testes de validação forem concluídos, você poderá analisar os resultados, conforme descrito na página de documentação Como visualizar os resultados da execução da integração contínua.
Acionamento automático de solicitações de pull
Se você tiver ativado o pacote de CI com Acionar em solicitações de pull do Looker, a CI vai acionar uma execução de validação automaticamente quando um desenvolvedor do Looker enviar uma solicitação de envio para seu repositório do LookML. Se quiser, você pode especificar que as solicitações de pull apenas para determinadas ramificações no seu repositório acionem execuções automáticas de CI.
Para execuções automáticas de validação de solicitação de envio, a CI valida o commit mais recente da solicitação de envio e retorna todos os erros nessa versão do repositório.
Consulte a página de documentação Como visualizar os resultados da execução da integração contínua para saber como visualizar os resultados.
Acionamento automático de solicitações de pull de projetos importados
Se você tiver ativado o pacote de CI em um projeto downstream (spoke) com a opção Acionar em solicitações de pull de projetos importados, a CI vai acionar uma execução de validação automaticamente no projeto spoke quando um desenvolvedor abrir ou atualizar uma solicitação de envio no repositório de um projeto upstream (hub) inscrito.
Durante uma execução de CI acionada por uma solicitação de envio de projeto importado, o Looker realiza as seguintes ações:
- Valida a versão de produção do projeto spoke enquanto fixa temporariamente o projeto hub importado ao commit da solicitação de envio.
- Grava o resultado da execução de CI do projeto spoke de volta na solicitação de envio no repositório do projeto hub.
Consulte a página de documentação Como visualizar os resultados da execução da integração contínua para saber como visualizar os resultados.
Acionamento automático do dbt Cloud
Se você tiver ativado o pacote de CI com Acionar em solicitações de pull do dbt Cloud, a CI vai acionar uma execução de validação automaticamente quando o job de CI do dbt Cloud especificado for concluído.
Uma execução de CI acionada por um job de CI da dbt Cloud foi projetada para verificar se as mudanças de esquema feitas na dbt vão corromper o conteúdo do LookML. Durante a execução, o Looker realiza as seguintes ações:
- Recebe a notificação do dbt Cloud após a conclusão do job.
- Extrai os detalhes do esquema temporário criado pelo dbt Cloud para essa execução específica.
- Substitui o atributo de usuário configurado (por exemplo, o atributo de esquema da sua conexão) pelo nome desse esquema temporário.
- Executa os validadores de CI nesse esquema temporário.
Isso permite detectar alterações interruptivas (como colunas descartadas ou tabelas renomeadas) antes que as alterações do dbt sejam mescladas à produção. Quando a execução termina, o valor do atributo do usuário volta ao valor padrão para os usuários de CI.
Acionamento automático em uma programação
Se você tiver ativado o pacote de CI com Acionar em uma programação, a CI vai acionar uma execução de validação automaticamente na programação especificada.
Para execuções de validação programadas automáticas, a CI valida a versão de produção do repositório e retorna todos os erros nessa versão.
Consulte a página de documentação Como visualizar os resultados da execução da integração contínua para saber como visualizar os resultados.
Acionar manualmente uma nova execução de um pacote de CI
Um usuário do Looker com a permissão see_ci pode acionar manualmente uma execução de CI no ambiente de desenvolvimento integrado do Looker.
Para acionar manualmente uma nova execução de um pacote de CI, siga estas etapas:
- No ambiente de desenvolvimento integrado do Looker, clique no ícone Integração contínua na barra de navegação do ambiente.
- Clique em Suítes para abrir a página Suítes.
- Clique no botão Executar pacote do pacote de CI que você quer executar. Se não houver pacotes de CI para seu projeto, crie um.
Na caixa de diálogo Acionar uma execução manualmente, use as opções de Espaço de trabalho para selecionar a ramificação que você quer validar (consulte a seção Espaço de trabalho para mais detalhes):
- Para validar a versão de produção do seu projeto do LookML, clique em Produção.
- Se você quiser validar uma ramificação de desenvolvimento do seu projeto do LookML, clique em Modo de desenvolvimento. Use o menu suspenso Branch para selecionar qual ramificação de desenvolvimento será validada.
Para acionar a execução do pacote de CI, clique em Iniciar execução.
O pacote de CI pode levar vários minutos para ser executado, dependendo do tamanho do projeto, dos validadores incluídos no pacote de CI e da configuração dele.
Depois que você acionar uma execução, o ambiente de desenvolvimento integrado do Looker vai mostrar a página Executar do conjunto acionado. Depois que os testes de validação forem concluídos, a página Executar vai mostrar os resultados de cada um dos validadores. Você pode sair da página Executar enquanto os testes de validação estão em andamento e voltar depois para conferir os resultados.
Consulte a página de documentação Como visualizar os resultados da execução da integração contínua para saber como visualizar os resultados.
Espaço de trabalho
Ao acionar manualmente uma execução de CI, use as opções do espaço de trabalho para validar a versão de produção ou uma ramificação de desenvolvimento do repositório.
Para a opção Produção, se você quiser identificar qual ramificação ou commit é usado para a versão de produção, consulte o IDE do Looker no campo Ramificação de produção padrão da seção Resumo do Git da página Gerenciamento de ramificações das Configurações do projeto:
- Para projetos configurados com o modo de implantação avançado, a versão de produção é um commit ou uma tag selecionada no gerenciador de implantação por um desenvolvedor do Looker que tem a permissão
deploy. - Para projetos sem o modo de implantação avançado, a versão de produção é a ramificação configurada no campo Nome da ramificação de produção do Git na página Configuração do projeto das Configurações do projeto.
Para a opção Modo de desenvolvimento, observe o seguinte para validar as ramificações de desenvolvimento no seu projeto:
- Para ver as ramificações no seu projeto do LookML e identificar a ramificação de produção e as ramificações pessoais dos desenvolvedores, consulte a página Gerenciamento de ramificações das Configurações do projeto no ambiente de desenvolvimento integrado do Looker.
- Para validar uma ramificação de desenvolvimento, ela precisa ser enviada ao repositório do LookML. No ambiente de desenvolvimento integrado do Looker, isso significa que o desenvolvedor precisa clicar no botão Confirmar mudanças e enviar ou selecionar a opção Confirmar no painel "Ações do Git" no ambiente de desenvolvimento integrado.
Como executar manualmente uma execução de CI anterior
Para execuções que foram concluídas (se a execução foi aprovada, falhou, apresentou erro ou foi cancelada), um usuário do Looker com a permissão see_ci pode acionar manualmente uma nova execução da CI no ambiente de desenvolvimento integrado do Looker:
- Se você executar novamente uma execução acionada por solicitação de pull (acionada por uma solicitação de envio no repositório do projeto ou em um projeto importado), a integração contínua será executada no mesmo commit da execução original.
- Se você executar novamente uma execução acionada manualmente, a integração contínua será executada no estado de produção ou no HEAD da ramificação no momento da nova execução, o que incluirá todos os commits subsequentes feitos desde a execução inicial da CI.
Além disso, se você tiver editado o pacote de CI desde a execução inicial, uma nova execução vai incluir todas as mudanças feitas no pacote de CI desde a execução inicial.
Para repetir uma execução de CI, siga estas etapas:
- No ambiente de desenvolvimento integrado do Looker, clique no ícone Integração contínua na barra de navegação do ambiente.
- Clique em Execuções para abrir a página Execuções.
- Na página Execuções, clique no botão Ver execução da execução de CI que você quer cancelar.
- Na página de resultados da execução selecionada, clique no botão Executar novamente na parte de cima da página.
Depois que você clicar em Executar novamente, o Validador de Conteúdo vai iniciar a execução e retornar à página Executar para a nova execução.
Consulte a página de documentação Como visualizar os resultados da execução da integração contínua para saber como visualizar os resultados.
Como cancelar uma execução de CI
Se você quiser cancelar uma execução de CI em andamento, siga estas etapas na página Executar:
- No ambiente de desenvolvimento integrado do Looker, clique no ícone Integração contínua na barra de navegação do ambiente.
- Clique em Execuções para abrir a página Execuções.
- Na página Execuções, clique no botão Ver execução da execução de CI que você quer cancelar.
- Na página Executar da execução selecionada, clique no botão Cancelar na parte de cima da página.
Depois que você clicar em Cancelar, a integração contínua vai cancelar a execução e mostrar o status Cancelada na página Execução.