Welcome to OCS-CI’s documentation!

This is a documentation for the OCS-CI project. OCS-CI is a testing framework based on pytest to test Red Hat OCS features and functionality using AWS and other supported platforms.

Package documentations:

• ocs_ci modules
  • ocs_ci package

Contents:

• Code review/contribution best practices in OCS-CI
• Coding guidelines for OCS-CI project
• Getting Started
  • Prerequisites
  • Installing
  • Initial Setup
  • Tests
• Supported platforms
  • AWS
  • vSphere
  • Azure
  • IBM Cloud
  • Openshift Dedicated
  • ROSA
• Usage
• usage for getting various ocs image versions
• usage for cleanup
  • AWS
  • vSphere
• usage to shutdown AWS nodes when nodes are not in use
• Usage for ocs-build tool
  • Required configuration
  • Required arguments
  • Useful arguments
  • Examples
• Upgrade
  • Deployment
  • Upgrade execution
  • Live upgrade
  • Stage upgrade
• Results
  • Report Portal
• Writing tests
  • Pytest marks
  • Bugzilla decorator
  • Skipping tests based on ocs version
  • Base test classes for teams
  • Constants and Defaults
  • Fixture usage
  • Other notes
• Stable Branch
  • Overview
  • Definition of Stable
  • Impact on the Development Process
  • Automation
  • Resolving failed tests
• Config directory
  • OCS CI Config
  • Custom config
  • Example of accessing config/default data
  • Priority of loading configs:
• Guidelines for fixtures usage in OCS-CI
  • Basic information
  • Use cases
  • Avoid
  • Examples of fixtures and tests
• Debugging
  • SSH to the host
  • OC debug
  • Enable debug log level for rook-ceph-operator
• Unit tests
  • How to run the unit tests myself?
  • What tests are available?
  • How to run particular test only?
  • Pytest integration tests
• Tracking of workarounds
  • How to track a workaround?
  • Example
• OCS-CI Release Branches
  • Goals
  • Supported versions and use-cases
  • Usage
  • Creating Release Branches
  • Backporting Changes
  • Fixes related to specific release versions
• Common Use cases and FAQ
  • Using ocs-ci to deploy OCP cluster without default OCS installation
  • ENABLE HUGE PAGES
  • Using multiple instances of Vault KMS in OCS-CI
  • How to report test results from ocs-ci not executed by ocs-ci jenkins?
  • How to execute tests on a cluster not deployed by ocs-ci?
  • How to use alternative mirrors/repositories for OCP installer/client download
• Multi-cluster test example
  • Example test
  • Execution of the example test

Indices and tables

• Index

• Module Index

• Search Page