openshift-virtualization-tests

Set up your Python environment using 'uv', configure dependencies, and run your first test suite against an OpenShift cluster.

Learn how to use pytest markers (tier2, tier3, gating, special_infra), filter by test domains, and execute tests inside containers.

Explore VM lifecycle, scheduling, compute configurations, and multi-architecture capabilities under the virt/ domain.

Understand network topologies, SR-IOV, L2 bridging, IPv6 setups, and network policy tests in the network/ domain.

Validate persistent storage, CDI (Containerized Data Importer), volume modes, and dynamic provisioning in the storage/ domain.

Test cluster-level configurations, prometheus metrics, logging pipelines, and node features under infrastructure/ and observability/.

Execute disruptive testing, upgrade operator validations, and disaster recovery scenarios via chaos/ and data_protection/ suites.

Master fixture scoping, dependency injection, and proper noun-based naming conventions across root, shared, and domain-specific conftest.py files.

How to manage OpenShift resource creation, utilize TimeoutSampler for polling, and avoid defensive programming anti-patterns.

Manage global parameters (global_config.py) and domain-specific constants (utilities/constants/) for multi-cloud and multi-arch test runs.

Follow the mandatory Software Test Plan (STP) and Software Test Description (STD) docstring workflow before implementing any code.

Step-by-step guide to writing independent test cases, defining clear assertions, reusing utilities, and properly tagging special infrastructure needs.

Learn the difference between product bugs (Jira markers) and automation issues (xfail quarantines) and how to manage failing tests.

Reference documentation for domain-specific utility functions located in utilities/ and custom classes in libs/.

Guide to using pyhelper-utils, ocp-resources, and openshift-python-wrapper for cluster interactions instead of raw scripts.

Use uv, tox, and pre-commit to enforce Google-format docstrings, strict type hinting, and 100% dead-code elimination.

How to structure PRs, adhere to the single-topic rule, sign commits (DCO), and successfully pass gating CI checks.

Design tests that dynamically adjust to amd64, arm64, and s390x topologies using platform constants and conditional logic.

Deep dive into tests/scale/ and operator upgrade routines, managing massive test state safely.