Skip to content
check

GitHub Action

Conftest

v0.4.0 Latest version

Conftest

check

Conftest

Write tests against structured configuration data using Open Policy Agent

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Conftest

uses: instrumenta/[email protected]

Learn more about this action in instrumenta/conftest-action

Choose a version

Conftest

A GitHub Action for using Conftest in your workflows.

You can use the action as follows:

on: push
name: Validate
jobs:
  conftest:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@master
    - name: test
      uses: instrumenta/conftest-action@master
      with:
        files: deployment.yaml

The Conftest Action has a small number of properties which map to the parameters for Conftest itself. These are passed to the action using with, as demonstrated with files in the above example.

Property Default Description
files - Required which files to test
policy policy Where to find the policy folder or files
namespace main The Rego namespace to use for testing
output stdout How to format the output from Conftest (stdout, json or tap)

Helm

Conftest also has a Helm plugin which makes testing Helm charts easier, and that plugin is also available as an Action.

You can use the action as follows:

on: push
name: Validate
jobs:
  conftest:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@master
    - name: test
      uses: instrumenta/conftest-action/helm@master
      with:
        chart: mysql

The Conftest Helm Action has a small number of properties which map to the parameters for Conftest itself. These are passed to the action using with, as demonstrated with chart in the above example.

Property Default Description
chart - Required which chart directory to test
policy policy Where to find the policy folder or files
namespace main The Rego namespace to use for testing
output stdout How to format the output from Conftest (stdout, json or tap)