Run Cerberus GitHub Action

This action trigger a Cerberus campaign execution and check for the result.

Usage

- uses: cerberustesting/cerberus-cicd-github-action@v1
  with:
    host: https://jftl.cerberus-testing.com
    campaign: API_NonRegression_UAT
    apikey: ${{ secrets.APIKEY }}
    author: ${{ github.event.pusher.name }}

In this example, the Cerberus action trigger the execution of the campaign on the cerberus instance behind the host, using the APIKEY. The author is used for the tag automatic generation, in order to link the execution with the people who trigger it.

Options

host

Your Cerberus host.

- uses: cerberustesting/cerberus-cicd-github-action@v1
  with:
    host: https://my_instance.cerberus-testing.com

campaign

The Campaign name you want to execute.

- uses: cerberustesting/cerberus-cicd-github-action@v1
  with:
    campaign: My_Campaign

author

The name of the people that trigger the execution. It can be a generic name, or the name of the committer

- uses: cerberustesting/cerberus-cicd-github-action@v1
  with:
    author: ${{ github.event.pusher.name }}

apikey

The apikey of your cerberus instance. You can hardcode it directly, of use the Secrets

- uses: cerberustesting/cerberus-cicd-github-action@v1
  with:
    apikey: AS23DVFERS45677GFDDVGREZ3345TGGHH554EDR

- uses: cerberustesting/cerberus-cicd-github-action@v1
  with:
    apikey: ${{ secrets.APIKEY }}

iterationnb

Optional

The max number of control iteration until the check time out. default to 500 (leeding to 25 min timeout with default iteration duration of 3 sec)

- uses: cerberustesting/cerberus-cicd-github-action@v7
  with:
    iterationnb: 700

Default value: 500

iterationdur

Optional

The duration between 2 iteration contols. default to 3 (sec)

- uses: cerberustesting/cerberus-cicd-github-action@v7
  with:
    iterationdur: 5

Default value: 3

Examples

This section contains sample workflows that show how to use cerberus-action.

Run Cerberus Tests

The following workflow shows how to use cerberus-action in a simple scenario:

name: My Quality Workflow
on: [push]

jobs:
  build:
    name: Run Cerberus Tests
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@master
    - name: cerberus-action
      uses: cerberustesting/cerberus-cicd-github-action@v1
      with:
        host: https://jftl.cerberus-testing.com
        campaign: API_NonRegression_UAT
        apikey: ${{ secrets.APIKEY }}
        author: ${{ github.event.pusher.name }}