Um pacote de integração contínua (CI) é um conjunto de instruções de validação associado ao seu projeto do LookML. Um usuário do Looker com a manage_ci permissão pode configurar o seguinte em um pacote de CI:
- Como uma execução de validação de CI é acionada (manualmente no ambiente de desenvolvimento integrado do Looker ou automaticamente quando uma solicitação de envio é enviada ao seu repositório).
- Quais validadores de CI executar.
- Outras opções para cada teste de validação. Consulte as páginas de documentação de cada um dos validadores para mais detalhes:
Antes de começar
Antes de criar um pacote de CI, você precisa do seguinte:
- Uma instância do Looker que atenda aos requisitos de CI e que esteja ativada para CI.
- Uma conta de usuário do Looker com a
manage_cipermissão (essa permissão está incluída no conjunto de permissões de administrador).
Como criar um pacote de CI
É possível configurar e executar os validadores na página Pacotes no ambiente de desenvolvimento integrado do Looker:
Para criar 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 de desenvolvimento integrado.
- Clique na guia Pacotes para abrir a página Pacotes.
- Na página Pacotes, é possível criar um novo pacote ou editar um pacote atual:
- Para criar um novo pacote, clique no botão Criar pacote.
- Para editar um pacote atual, clique no botão Editar pacote.
- Insira um nome para o Nome do pacote. Se você estiver editando um pacote atual, clique no ícone de lápis para editar o nome do pacote.
- (Opcional) Ative a opção Acionar com base em uma programação se quiser configurar testes de validação automática em uma programação recorrente. Consulte a seção Acionar com base em uma programação desta página para mais informações.
(Opcional) Ative a opção Acionar em solicitações de pull do Looker se quiser configurar testes de validação automática sempre que um desenvolvedor do Looker enviar uma solicitação de envio ao seu repositório. Consulte a seção Acionar em solicitações de pull do Looker desta página para mais informações.
Se você ativar o acionamento de solicitação de envio para um pacote de CI, poderá usar o campo Somente para ramificação de destino para especificar que as solicitações de pull apenas para ramificações específicas no repositório acionem uma execução do pacote de CI. Consulte a seção Acionar em solicitações de pull do Looker desta página para mais informações.
Opcionalmente, ative as opções do validador para ativar um validador e configurar as opções dele. Consulte as páginas de documentação de cada um dos validadores para mais detalhes:
Salve as alterações:
- Se você estiver criando um novo pacote, clique no botão Criar pacote.
- Se você estiver editando um pacote atual, clique no botão Atualizar pacote.
Gatilhos
As execuções de CI podem ser acionadas de várias maneiras:
- Automaticamente, em uma programação recorrente.
- Automaticamente, quando uma solicitação de envio é enviada ao repositório do seu projeto do LookML por um desenvolvedor do Looker.
- Manualmente, usando o botão Executar pacote na página Pacotes no ambiente de desenvolvimento integrado do Looker.
- Manualmente, executando novamente uma execução de CI anterior na página Execuções do ambiente de desenvolvimento integrado do Looker.
Acionar com base em uma programação
É possível configurar um pacote de CI para ser acionado automaticamente em uma programação ativando a opção Acionar com base em uma programação.
Quando essa opção está ativada, é possível selecionar a frequência e os detalhes para executar automaticamente o pacote de CI:
- Mensalmente, em um dia e horário específicos
- Semanalmente, em um dia e horário específicos
- Diariamente, em um horário específico
- De hora em hora ou a cada 2, 3, 4, 6, 8 ou 12 horas, começando e terminando em horários específicos do dia
- Minutos a cada 5, 10, 15, 20 ou 30 minutos, começando e terminando em horários específicos do dia
- Meses específicos do ano, em um dia e horário específicos
- Dias específicos da semana em um horário específico
Acionar em solicitações de pull do Looker
Para configurar um pacote de CI para acionamento automático na solicitação de envio, ative a opção Acionar em solicitações de pull do Looker. Para usar o acionamento de solicitação de envio, o repositório Git precisa ser configurado pelo administrador do Looker na página de administração Integração contínua do Looker.
Se você ativar os acionadores solicitação de envio para um pacote de CI, poderá especificar que as solicitações de pull apenas para ramificações específicas no repositório acionem uma execução do pacote de CI. Para limitar os acionadores automáticos de solicitação de envio de execuções de CI a ramificações específicas no repositório, insira uma lista separada por vírgulas das ramificações no campo Somente para ramificação de destino.
Por exemplo, se um repositório tiver três ramificações chamadas main, release_1, e dev, você poderá inserir main, release_1 no campo Somente para ramificação de destino. Isso significa que as execuções de CI serão acionadas quando um desenvolvedor do Looker enviar uma solicitação de envio para a ramificação main ou release_1. Se um desenvolvedor do Looker enviar uma solicitação de envio para a ramificação dev, isso não vai acionar uma execução automática do pacote de CI.
Como excluir um pacote
Para excluir 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 de desenvolvimento integrado.
- Clique na guia Pacotes para abrir a página Pacotes.
- Na página Pacotes, clique no botão Editar pacote.
- Na página do pacote, clique no botão Excluir pacote.
- Na caixa de diálogo de confirmação, clique no botão Excluir pacote.