Acionar Teste por Commit Git

Pode acionar automaticamente testes automatizados do Apidog através de eventos de commit Git (como push, pull request) sem qualquer intervenção manual. Esta funcionalidade funciona em qualquer plataforma CI/CD, incluindo GitHub Actions, Jenkins, GitLab CI e outras.

Princípio Central: Acionamento por Evento + Execução de Comando CLI

O acionamento automático de testes do Apidog após um commit Git baseia-se num princípio universal:

Quer seja através de um Webhook ou do listener de eventos integrado fornecido pela plataforma CI/CD (por exemplo, on: push no GitHub Actions), a essência é a mesma:
monitorizar eventos de commit Git e executar o comando de teste do Apidog.

Desde que o seu ambiente CI/CD consiga responder a commits Git e executar um script de linha de comandos, pode integrar testes automatizados do Apidog.

Existem, geralmente, dois mecanismos de acionamento:

1. Mecanismos de eventos integrados (por exemplo, GitHub Actions, GitLab CI)

O GitHub Actions, por exemplo, fornece uma configuração de evento como:

Este método não requer configuração de Webhook. A plataforma monitoriza eventos internamente e é uma abordagem leve.

2. Webhooks externos (por exemplo, Jenkins, serviços autoalojados)

Ao utilizar Jenkins ou configurações multiplataforma, normalmente precisa de configurar Webhooks manualmente.

Exemplos Comuns de Integração CI/CD

Acionar testes automatizados através de mecanismos de eventos integrados:

Integrar com Github Actions

Integrar com Gitlab

Exemplo de Integração Multiplataforma: GitHub Actions + Jenkins

Cenário

O repositório de código está alojado no GitHub

O ambiente de execução da pipeline é Jenkins

Utilizar GitHub Webhook para acionar a pipeline do Jenkins

Executar apidog run no Jenkins para executar testes automatizados do Apidog

Passo 1: Configurar o Projeto Jenkins

Consulte Integrar com Jenkins para criar um projeto e configurá-lo com sucesso.

Interface de configuração do projeto Jenkins

Passo 2: Obter o URL do Webhook

O URL do Webhook é o ponto de entrada que o Jenkins utiliza para receber pedidos externos e acionar pipelines. Pode obter este URL de várias formas, como utilizando o plugin Generic Webhook Trigger.

No Jenkins Plugin Manager, procure e instale o plugin "Generic Webhook Trigger". Reinicie o Jenkins após a instalação.

Gestor de plugins do Jenkins a mostrar o plugin Generic Webhook Trigger

No Jenkins Dashboard, selecione o seu projeto e aceda a Configure. Ative Generic Webhook Trigger.
O URL do Webhook é: http://<your Jenkins host>/generic-webhook-trigger/invoke