Um conjunto 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 permissão manage_ci
pode configurar o seguinte em um conjunto 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 para seu repositório).
- Quais validadores de CI serão executados.
- Opções adicionais para cada teste de validação. Consulte as páginas de documentação de cada validador para saber mais:
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 permissão
manage_ci
(incluída no conjunto de permissões do administrador).
Criar um conjunto de CI
É possível configurar e executar os validadores na página Suites do ambiente de desenvolvimento integrado do Looker:
Para criar um conjunto de CIs, siga estas etapas:
- No IDE do Looker, clique no ícone Integração contínua na barra de navegação do IDE.
- Clique na guia Suites para abrir a página Suites.
- Na página Pacotes, você pode criar um novo pacote ou editar um pacote existente:
- Para criar um novo pacote, clique no botão Criar pacote.
- Para editar um pacote, clique no botão Editar pacote.
- Insira um nome para o nome do pacote. Se você estiver editando um pacote, clique no ícone de lápis para editar o nome dele.
(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 pull para seu repositório. Consulte a seção Gatilhos desta página para mais informações.
Se você ativar o acionamento de solicitações de pull para um conjunto de CI, poderá usar o campo Only for target branch para especificar que apenas solicitações de pull para branches específicos no repositório devem acionar uma execução do conjunto de CI. Consulte a seção Gatilhos desta página para mais informações.
Opcionalmente, ative os alternadores de validador para ativar um validador e configurar as opções dele. Consulte as páginas de documentação de cada validador para saber mais:
Salve as mudanças:
- Se você estiver criando um novo pacote, clique no botão Criar pacote.
- Se você estiver editando um pacote, clique no botão Atualizar pacote.
Gatilhos
As execuções de 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 do LookML.
- Manualmente, usando o botão Run suite na página Suites do ambiente de desenvolvimento integrado do Looker.
- Manualmente, refazendo uma execução anterior de CI, na página Runs do ambiente de desenvolvimento integrado do Looker.
Para configurar um conjunto de CI para acionamento automático em solicitações de pull, ative a opção Acionar em solicitações de pull do Looker. Para usar o acionamento de solicitações de pull, o repositório do Git precisa ser configurado pelo administrador do Looker na página Integração contínua Admin do Looker.
Se você ativar os acionadores de solicitações de envio para um conjunto de CI, poderá especificar que as solicitações de envio para ramificações específicas no repositório devem acionar uma execução do conjunto de CI. Para limitar os acionadores automáticos de solicitações de pull de execuções de CI a filiais específicas no repositório, insira uma lista separada por vírgulas das filiais no campo Somente para a ramificação de destino.
Por exemplo, se um repositório tiver três branches chamadas main
, release_1
e dev
, você poderá inserir main, release_1
no campo Only for target branch. Isso significa que as execuções de CI serão acionadas quando um desenvolvedor do Looker enviar uma solicitação de pull 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 conjunto de CI.
Como excluir um pacote
Para excluir 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 na guia Suites para abrir a página Suites.
- Na página Pacotes, clique no botão Editar pacote.
- Na página da suíte, clique no botão Excluir suíte.
- Na caixa de diálogo de confirmação, clique no botão Excluir pacote.