Getting Started

Follow the steps below to get started using the OPCT CLI to schedule a conformance workflow.

Prerequisites

• An OpenShift/OKD cluster installed
• KUBECONFIG environment variable set with cluster admin permissions

Install

Install the OPCT CLI using the following command:

curl -fsSL https://redhat-openshift-ecosystem.github.io/opct/install.sh | bash

The installer detects your OS/architecture, verifies the published checksum, and installs opct into $HOME/.local/bin.

To pin a specific release or change the destination directory:

curl -fsSL https://redhat-openshift-ecosystem.github.io/opct/install.sh \
  | OPCT_VERSION=v0.6.7 INSTALL_DIR="$HOME/bin" bash

If the install directory is not already on your PATH, the installer prints the export PATH=... line to add to your shell profile.

See Also

• Review the installer source before piping it to a shell
• Use the latest release

Setup

Select a dedicated compute node to be used to host the test environment:

opct adm e2e-dedicated taint-node

See Also

• opct adm e2e-dedicated taint-node CLI reference
• Reference Diagram
• Cluster Validation User Guide

Run

Schedule the default workflow and monitor its execution:

opct run --watch

See Also

• opct run
• Reference Diagram
• Cluster Validation User Guide

Results

Once the workflow completes, retrieve the results:

opct retrieve

Generate the consolidated report:

opct report --save-to ./results opct*.tar.gz

Explore the results by navigating to the Web UI to review the checks, recommendations, and e2e logs.

Destroy

Destroy the test environment:

opct destroy

That's it! You have successfully scheduled the conformance test workflow on an OpenShift cluster using the OPCT CLI, collected the results, and gathered performance data from the cluster.