Skip to content

red-hat-data-services/ods-ci

Repository files navigation

ODS-CI

ODS-CI is a framework to test Red Hat OpenShift AI and its upstream project, Open Data Hub.

Requirements

  1. Linux distribution that supports Selenium automation on top of either a Chromium/Google-Chrome web browser using ChromeDriver or Firefox web browser using geckodriver:

    • relevant web driver binaries can be downloaded here: ChromeDriver or geckodriver
    • the ChromeDriver version must match the installed version of Chromium/Google-Chrome, for geckodriver see the release notes for particular release
    • install your web driver so that it's visible by Robot Framework during tests execution, e.g. into ~/.local/bin path
  2. Poetry tool installed and added to your $PATH.

Quick Start

  1. Move to the ods_ci folder inside ods-ci repo

    cd ods_ci
  2. Create a variables file for all of the global test values

    # Create the initial test variables from the example template variables file
    cp test-variables.yml.example test-variables.yml
  3. Edit the test variables file to include information required for this test run. You will need to add info required for test execution:

    • URLs based on the test case you are executing.
      • OpenShift Console.
      • Open Data Hub Dashboard.
      • JupyterHub.
    • Test user credentials.
    • Browser webdriver to use for testing.
  4. Run this script that will create the virtual environment, install the required packages and kickoff the Robot test suite.

   # Running all the tests
   sh run_robot_test.sh

   # Running Smoke test suite via tag
   sh run_robot_test.sh --include Smoke

   # Running a specific test via tag
   sh run_robot_test.sh --include ODS-XYZ

   # Running tests in Open Data Hub:
   # You need to set accordingly the PRODUCT, APPLICATIONS_NAMESPACE, MONITORING_NAMESPACE,
   # OPERATOR_NAMESPACE and NOTEBOOKS_NAMESPACE in test-variables.yaml (or pass them as parameters
   # when launching the tests) and overwrite some local variables used in the test suites
   # adding --variablefile ./ods_ci/test-variables-odh-overwrite.yml
   sh run_robot_test.sh \
    --test-variable PRODUCT:ODH \
    --test-variable APPLICATIONS_NAMESPACE:opendatahub \
    --test-variable MONITORING_NAMESPACE:opendatahub \
    --test-variable OPERATOR_NAMESPACE:openshift-operators \
    --test-variable NOTEBOOKS_NAMESPACE:opendatahub \
    --extra-robot-args '--variablefile test-variables-odh-overwrite.yml' \
    --include OpenDataHub
  • This run_robot_test.sh is a wrapper for creating the python virtual environment and running the Robot Framework CLI.
  • The wrapper script has several arguments and you can find details in the dedicated document file. See run_args.md
  • As alternative, you can run any of the test cases by creating the python virtual environment, install the packages in poetry.lock and running the robot command directly

Contributing

See CONTRIBUTING.md

ODS-CI Container Image

See build README on how you can build and use a container to run ODS-CI automation in OpenShift.

License

This project is open sourced under MIT License.