ontrack-github-ingestion-validation-data

GitHub Action used to inject data into validations in Ontrack.

Example usage

- name: 'my-validation'
  uses: nemerosa/[email protected]

Inputs

Project identification

By default, the current repository is used to identify the Ontrack project where the validation must be created. If need be, another repository can be specified.

owner

The name of the repository owner where the validation is to be set. If not set, the current repository owner will be used.

repository

The name of the repository where the validation is to be set. If not set, the current repository will be used.

Build identification

By default, the current workflow run ID will be used to identify the build to validate. It's also possible to use the actual build name or its label.

build-name

Name of the Ontrack build where to create the validation. If not set and if build-label is not set either, the current workflow run ID will be used to identify the build.

build-label

Release property (label) of the Ontrack build where to create the validation. If not set and if build-name is not set either, the current workflow run ID will be used to identify the build.

Validation

validation

Name of the validation stamp to create. Defaults to the current step name.

validation-status

One of PASSED, FAILED, WARNING, etc. Required if the target validation stamp has not been configured for data validation.

Validation data

One of the following options must be given.

validation-data

YAML object describing the validation.

Two required fields:

• type - FQCN of the validation type in Ontrack
• data - JSON/YAML representation of the validation data

For example, for a test summary:

with:
  validation-data: |-
    type: "net.nemerosa.ontrack.extension.general.validation.TestSummaryValidationDataType"
    data:
      passed: 15
      skipped: 8
      failed: 5

test-summary-validation-data

Shortcut for some test summary validation data.

For example:

with:
  test-summary-validation-data: |-
    passed: 15
    skipped: 8
    failed: 5

metrics-validation-data

Shortcut for some metrics validation data.

For example:

with:
  metrics-validation-data: |-
    position: 2.1
    speed: 15.0
    acceleration: 7.1

file-validation-data-type and file-validation-data-path

Indicates the path and type of a file containing the validation data.

Several types are supported.

metrics

Example:

with:
  file-validation-data-type: metrics
  file-validation-data-path: path/to/metrics.yaml

The file must be flat YAML file containing the metrics. For example:

position: 2.1
speed: 15.0
acceleration: 7.1

junit

Gets a test summary from a JUnit XML report.

Example:

with:
  file-validation-data-type: junit
  file-validation-data-path: path/to/report/directory

The path must be a directory containing XML JUnit report. For example:

<?xml version="1.0" encoding="UTF-8"?>
<testsuite name="..." tests="7" skipped="0" failures="0" errors="0" timestamp="2022-05-04T09:45:17" hostname="..." time="3.538">
    <!-- ... -->
</testsuite>

Only the tests, skipped, failures and errors attributes of the testsuite root are used. The rest of the attributes and elements is ignored.

Misc

logging

If set to true, logs additional information on the console.