Como executar pacotes de integração contínua

Pré-lançamento:este produto ou recurso está sujeito aos "Termos de ofertas pré-GA" na seção Termos gerais de serviço dos Termos específicos de serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Se você encontrar um problema durante a prévia pública da integração contínua, informe-o usando o formulário do Issue Tracker da prévia da integração contínua do Looker.

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 Como criar um pacote de integração contínua para saber como configurar isso.
• Acionamento manual de 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 ver os resultados da execução da integração contínua.

Acionamento automático de solicitações de pull

Se você tiver ativado seu 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 LookML. (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.

Observação: para validadores no conjunto de CI configurados para realizar validação incremental, o validador vai retornar erros que existem apenas no commit da solicitação de envio. Os validadores ativados para validação incremental não vão retornar um erro se ele já existir na versão de produção. Consulte a documentação do SQL Validator ou do Content Validator para mais informações sobre a validação incremental.

Consulte a página de documentação Como ver os resultados da execução da integração contínua para informações sobre como visualizar 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 IDE do Looker.

Para acionar manualmente uma nova execução de um conjunto de CI, siga estas etapas:

1. No Looker IDE, clique no ícone Integração contínua na barra de navegação do IDE.
2. Clique em Suítes para abrir a página Suítes.
3. Clique no botão Executar conjunto para o conjunto de CI que você quer executar. Se não houver conjuntos de CI para seu projeto, crie um.

4. Na caixa de diálogo Acionar uma execução manualmente, use as opções do Workspace para selecionar a ramificação que você quer validar. Consulte a seção Workspace para mais detalhes:

   • Para validar a versão de produção do seu projeto do LookML, clique em Produção.
   • Se quiser validar uma ramificação de desenvolvimento do seu projeto do LookML, clique em Modo de desenvolvimento. Use o menu suspenso Ramificação para selecionar qual ramificação de desenvolvimento validar.

5. Para acionar a execução do conjunto de CI, clique em Iniciar execução.

A execução da suíte de CI pode levar vários minutos, dependendo do tamanho do projeto, dos validadores incluídos na suíte e da configuração dela.

Depois de acionar uma execução, o Looker IDE vai mostrar a página Executar para o conjunto que você acionou. Quando 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 execução e voltar mais tarde para conferir os resultados.

Consulte a página de documentação Como ver os resultados da execução da integração contínua para informações sobre como visualizar os resultados.

Espaço de trabalho

Ao acionar manualmente uma execução de CI, use as opções do Workspace 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 na versão de produção, consulte o campo Ramificação de produção padrão na seção Resumo do Git da página Gerenciamento de ramificações nas Configurações do projeto do IDE do Looker:

• 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 com 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 ramificações de desenvolvimento no seu projeto:

• Para conferir as ramificações no seu projeto da LookML e identificar a ramificação de produção e as ramificações pessoais dos seus desenvolvedores, consulte a página Gerenciamento de ramificações nas Configurações do projeto no IDE do Looker.
• Para validar uma ramificação de desenvolvimento, ela precisa ser enviada ao repositório do LookML. No Looker IDE, isso significa que o desenvolvedor precisa clicar no botão Confirmar e enviar mudanças ou selecionar a opção Confirmar no painel de ações do Git no IDE.

Executar manualmente uma execução de CI anterior

Para execuções concluídas (aprovadas, reprovadas, com erros ou canceladas), um usuário do Looker com a permissão see_ci pode acionar manualmente uma nova execução da CI no IDE do Looker:

• Se você executar novamente uma execução acionada por uma solicitação de pull, 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 vai incluir 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 novamente uma execução de CI, siga estas etapas:

1. No Looker IDE, clique no ícone Integração contínua na barra de navegação do IDE.
2. Clique em Execuções para abrir a página Execuções.
3. Na página Execuções, clique no botão Ver execução da execução de CI que você quer cancelar.
4. Na página de resultados da execução selecionada, clique no botão Executar novamente na parte de cima da página.

Depois de clicar em Executar novamente, o Validador de conteúdo vai iniciar a execução e redirecionar você para a página Executar da nova execução.

Consulte a página de documentação Como ver os resultados da execução da integração contínua para informações sobre 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:

1. No Looker IDE, clique no ícone Integração contínua na barra de navegação do IDE.
2. Clique em Execuções para abrir a página Execuções.
3. Na página Execuções, clique no botão Ver execução da execução de CI que você quer cancelar.
4. Na página Executar da execução selecionada, clique no botão Cancelar na parte de cima da página.

Depois de clicar em Cancelar, a integração contínua vai cancelar a execução e mostrar o status Cancelado na página Executar.