Add rosa-ocp-version endpoint

[dahorak]

This endpoint will allow us to get list of all available OCP versions from ROSA and also check if particular OCP version is available there (and get the latest z-stream version for that OCP version).

This is the help for the new endpoint:

$ rosa-ocp-version -h
usage: rosa-ocp-version [-h] [--debug] [--get-available-versions] [--check-available-version OCP_VERSION] --ocsci-conf OCSCI_CONF

Get information about available OCP versions from ROSA

options:
  -h, --help            show this help message and exit
  --debug, -d           Print logging messages (mainly useful for debugging).
  --get-available-versions, -a
                        Get all available OCP versions from ROSA
  --check-available-version OCP_VERSION, -c OCP_VERSION
                        Check if provided OCP version is available in ROSA, if available, returns latest z-stream version
  --ocsci-conf OCSCI_CONF
                        OCM Credentials configuration file in yaml format. Example file: --- AUTH: openshiftdedicated: token: '<TOKEN>'

There are two ways how to use rosa-ocp-version command:

• to get list of all available OCP versions in ROSA:

$ rosa-ocp-version --ocsci-conf path/to/credentials-file.yaml --get-available-versions
4.17.14
4.17.12
4.17.11
4.17.10
4.17.9
4.17.8
4.17.7
4.17.6
4.17.5
4.17.4
...

• and to check if provided OCP version is available in ROSA:

$ rosa-ocp-version --ocsci-conf path/to/credentials-file.yaml --check-available-version 4.17
4.17.14
$ echo $?
0

$ rosa-ocp-version --ocsci-conf path/to/credentials-file.yaml --check-available-version 4.18
Version 4.18 not available in ROSA.
$ echo $?
255

Additionally there is -d / --debug parameter which enables printing of logging messages useful for debugging.

[dahorak]

Verified locally (see the output in the Description).

[openshift-ci]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: dahorak, DanielOsypenko

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[dahorak]

Link to updated documentation: https://ocs-ci--11379.org.readthedocs.build/en/11379/usage.html

[vavuthu]

could you move this section to the beginning ( above # Usage for rosa-ocp-version tool )