As execuções de integração contínua (CI) podem ser acionadas de várias maneiras:
- Automaticamente, quando um desenvolvedor do Looker envia uma solicitação de envio para o repositório do projeto LookML. Consulte a página Criar um pacote de integração contínua para saber como configurar isso.
- Acionar manualmente uma nova execução de um conjunto de CI no ambiente de desenvolvimento integrado do Looker.
- Executar manualmente uma execução de CI anterior no ambiente de desenvolvimento integrado do Looker.
Quando os testes de validação forem concluídos, você poderá analisar os resultados, conforme descrito na página de documentação Como conferir os resultados da execução da integração contínua.
Acionamento automático de solicitações de pull
Se você tiver ativado o conjunto de CI com a opção 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 pull para seu repositório LookML. Você pode especificar que as solicitações de pull para certas ramificações no repositório acionam execuções automáticas de CI.
Para execuções automáticas de validação de solicitações de pull, o CI valida o último commit de solicitação de pull e retorna todos os erros nessa versão do repositório.
Consulte a página de documentação Como conferir os resultados da execução da integração contínua para informações sobre como conferir os resultados.
Como acionar manualmente uma nova execução de um conjunto 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 conjunto de CI, siga estas etapas:
- No IDE do Looker, clique no ícone Integração contínua na barra de navegação do IDE.
- Clique em Suites para abrir a página Suites.
- Clique no botão Executar suíte do conjunto de CI que você quer executar. Se você não tiver nenhum conjunto de CI para o projeto, crie um.
Na caixa de diálogo Gatilhe uma execução manualmente, use as opções 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 a ramificação de desenvolvimento a ser validada.
Para acionar a execução do pacote de CI, clique em Iniciar execução.
A execução do conjunto de CI pode levar vários minutos, dependendo do tamanho do projeto, dos validadores incluídos no conjunto de CI e da configuração do conjunto de CI.
Depois de acionar uma execução, o Looker IDE vai mostrar a página Run do pacote acionado. Quando os testes de validação forem concluídos, a página Run vai mostrar os resultados de cada validador. Você pode sair da página Run enquanto os testes de validação estão em execução e depois retornar à página Run para conferir os resultados.
Consulte a página de documentação Como conferir os resultados da execução da integração contínua para saber como visualizar os resultados.
Espaço de trabalho
Quando você aciona manualmente uma execução de CI, é possível usar as opções do Espaço de trabalho para validar a versão de produção do repositório ou uma ramificação de desenvolvimento dele.
Para a opção Produção, se você quiser identificar qual ramificação ou confirmação é usada para a versão de produção, consulte o IDE do Looker no campo Default Production Branch da seção Resumo do Git da página Gerenciamento de ramificação 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 tag selecionado no gerenciador de implantação por um desenvolvedor do Looker que tenha 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 Git Production Branch Name na página Project Configuration das Project Settings.
Para a opção Modo de desenvolvimento, observe o seguinte para validar as ramificações de desenvolvimento no seu projeto:
- Para conferir 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 seu projeto no ambiente de desenvolvimento do Looker.
- Para validar uma ramificação de desenvolvimento, ela precisa ser enviada para seu repositório do LookML. No ambiente de desenvolvimento integrado do Looker, isso significa que o desenvolvedor precisa clicar no botão Commit Changes & Push ou selecionar a opção Commit no painel Git Actions no ambiente de desenvolvimento integrado.
Como executar novamente uma execução de CI anterior manualmente
Para execuções concluídas (se a execução foi bem-sucedida, falhou, apresentou um 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 PR, a integração contínua será executada com a mesma confirmação 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 na ramificação HEAD no momento da reexecução, o que inclui todos os commits subsequentes feitos desde a execução inicial da CI.
Além disso, se você tiver editado o conjunto de CI desde a execução inicial, uma nova execução vai incluir todas as mudanças feitas no conjunto de CI desde a execução inicial.
Para executar uma CI novamente, siga estas etapas:
- No IDE do Looker, clique no ícone Integração contínua na barra de navegação do IDE.
- Clique em Execuções para abrir a página Execuções.
- Na página Execuções, clique no botão Visualizar execução da execução de CI que você quer cancelar.
- Na página de resultados da execução selecionada, clique no botão Refazer na parte de cima da página.
Ao clicar em Refazer, o Validador de conteúdo inicia a execução e retorna à página Execução para a nova execução.
Consulte a página de documentação Como conferir os resultados da execução da integração contínua para saber como visualizar os resultados.
Como cancelar uma execução de CI
Para cancelar uma execução de CI em andamento, acesse a página Run e siga estas etapas:
- No IDE do Looker, clique no ícone Integração contínua na barra de navegação do IDE.
- Clique em Execuções para abrir a página Execuções.
- Na página Execuções, clique no botão Visualizar 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.