OpenShift Provider Compatibility Tool (opct)

OpenShift Provider Compatibility Tool (OPCT) is used to orchestrate workflows for conformance test suites on OpenShift/OKD installations on cloud providers or hardware.

Documentation

• OPCT Overview
• User Guide
• Development Guide

Getting started

• Download OPCT

OS="$(uname -s | tr '[:upper:]' '[:lower:]')"

case "$(uname -m)" in
  x86_64|amd64)
    ARCH="amd64"
    ;;
  arm64|aarch64)
    ARCH="arm64"
    ;;
  *)
    echo "Unsupported architecture: $(uname -m)" >&2
    exit 1
    ;;
esac

BINARY="opct-${OS}-${ARCH}"

curl -fL \
  -o /usr/local/bin/opct \
  "https://github.com/redhat-openshift-ecosystem/opct/releases/download/latest/${BINARY}"

chmod +x /usr/local/bin/opct

• Setup a dedicated node to run the test environment (preferred to prevent disruption)

opct adm e2e-dedicated taint-node

• Run regular conformance tests

opct run --wait

• Check the status (optional when not using --wait on run)

opct status --wait

• Collcet the results

opct retrieve

• Read the report

opct report *.tar.gz

• Destroy the environment

opct destroy

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.