Como executar pacotes de integração contínua

Pré-lançamento: esse produto ou recurso está sujeito aos Termos das Soluções 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 do Looker, informe-o usando o formulário Looker Continuous Integration - Preview Issue Tracker (em inglês).

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 projeto do LookML por um desenvolvedor do Looker. Consulte a página Criar um pacote de integração contínua para saber como configurar isso.
• Acionando manualmente uma nova execução de um pacote de CI no Looker IDE.
• Executando novamente uma execução de CI anterior no Looker IDE.

Depois que os testes de validação forem concluídos, você poderá analisar os resultados, conforme descrito na página de documentação Visualizar resultados da execução de integração contínua.

Acionamento automático de solicitações de envio

Se você ativou o pacote 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 envio ao repositório do LookML. Opcionalmente, você pode especificar que as solicitações de envio apenas para determinadas ramificações no 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 pacote de CI configurados para realizar a 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 validador de SQL ou do validador de conteúdo para mais informações sobre a validação incremental.

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

Acionamento manual de 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 Looker IDE.

Para acionar manualmente uma nova execução de um pacote 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 Pacotes para abrir a página Pacotes.
3. Clique no botão Executar pacote do pacote de CI que você quer executar. Se você não tiver pacotes de CI para seu projeto, pode criar um pacote de CI.

4. Na caixa de diálogo Acionar uma execução manualmente, use as opções do 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 projeto do LookML, clique em Produção.
   • Se você quiser validar uma ramificação de desenvolvimento do projeto 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 pacote de CI, clique em Iniciar execução.

A execução do pacote de CI pode levar vários minutos, dependendo do tamanho do projeto, dos validadores incluídos no pacote e da configuração dele.

Depois de acionar uma execução, o Looker IDE vai mostrar a página Executar do pacote acionado. 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 retornar mais tarde para conferir os resultados.

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

Espaço de trabalho

Ao acionar manualmente uma execução de CI, você pode usar 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 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 no Looker IDE:

• 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 deploy permissão.
• 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 projeto:

• Para conferir as ramificações no 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 Looker IDE.
• 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 mudanças e enviar ou selecionar a opção Confirmar no painel Ações do Git no IDE.

Executar novamente uma execução de CI anterior

Para execuções concluídas (se a execução foi aprovada, falhou, apresentou erros ou foi cancelada), um usuário do Looker com a permissão see_ci pode acionar manualmente uma nova execução de CI no Looker IDE:

• Se você executar novamente uma execução acionada por uma solicitação de envio, 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, que vai incluir todos os commits subsequentes feitos desde a execução inicial de 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 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 Visualizar 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 retornar à página Executar da nova execução.

Consulte a página de documentação Visualizar resultados da execução de 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, faça isso na página Executar seguindo 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 Visualizar 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.