Como executar pacotes de integração contínua

As execuções de integração contínua (CI) podem ser acionadas de várias maneiras:

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 de validação solicitação de envio automáticas, a CI valida o commit de solicitação de envio mais recente e retorna todos os erros nessa versão do repositório.

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

Acionamento automático do dbt Cloud

Se você ativou o pacote de CI com a opção Acionar em solicitações de envio 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 do dbt Cloud foi projetada para verificar se as mudanças de esquema feitas no dbt vão interromper o conteúdo do LookML. Durante a execução, o Looker realiza as seguintes ações:

  1. Recebe a notificação do dbt Cloud após a conclusão do job.
  2. Extrai os detalhes do esquema temporário criado pelo dbt Cloud para essa execução específica.
  3. Substitui o atributo de usuário configurado (por exemplo, o atributo de esquema da conexão) pelo nome desse esquema temporário.
  4. Executa os validadores de CI nesse esquema temporário.

Isso permite detectar mudanças interruptivas (como colunas descartadas ou tabelas renomeadas) antes que as mudanças do dbt sejam mescladas à produção. Quando a execução termina, o valor do atributo do usuário é revertido para o valor padrão dos usuários de CI.

Acionamento automático em uma programação

Se você ativou o pacote de CI com a opção 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 Visualizar resultados da execução de integração contínua para saber 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 ambiente de desenvolvimento integrado do Looker.

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

  1. No ambiente de desenvolvimento integrado do Looker, clique no ícone Integração contínua na barra de navegação do ambiente de desenvolvimento integrado.
  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 o 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 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 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 de CI e da configuração do pacote de CI.

Depois de acionar uma execução, o ambiente de desenvolvimento integrado do Looker 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 saber 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 do repositório ou uma ramificação de desenvolvimento do repositório.

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 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 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 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.

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 ambiente de desenvolvimento integrado do Looker:

  • Se você executar novamente uma execução acionada por uma solicitação de envio, a integração contínua será executada na 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 no HEAD da ramificação no momento da nova execução, que vai incluir todas as confirmações subsequentes feitas 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 ambiente de desenvolvimento integrado do Looker, clique no ícone Integração contínua na barra de navegação do ambiente de desenvolvimento integrado.
  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 saber 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 ambiente de desenvolvimento integrado do Looker, clique no ícone Integração contínua na barra de navegação do ambiente de desenvolvimento integrado.
  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.