fetch-releases

Fetch Releases

This skill fetches the list of available OpenShift releases from the Sippy API. It can return all OCP releases or just the latest version.

When to Use This Skill

Use this skill when you need to:

• Determine the latest OCP release version
• Get a list of all available OCP releases
• Provide a default release version when the user hasn't specified one

Prerequisites

1. Python 3: Python 3.6 or later

   • Check: python3 --version
   • Uses only standard library (no external dependencies)

2. Network Access: Must be able to reach the public Sippy API

   • Check: curl -s https://sippy.dptools.openshift.org/api/releases | head -c 100

Implementation Steps

Step 1: Get the Latest Release

To get just the latest OCP release version:

release=$(python3 plugins/ci/skills/fetch-releases/fetch_releases.py --latest)
echo "$release"
# Output: 4.22

Step 2: List All Releases

To list all available OCP releases:

# JSON format (includes GA dates)
python3 plugins/ci/skills/fetch-releases/fetch_releases.py --format json

# Simple list, one per line
python3 plugins/ci/skills/fetch-releases/fetch_releases.py --format list

Step 3: Use with Other Skills

The primary use case is providing a default release to other skills:

# Determine release
release="${user_specified_release:-$(python3 plugins/ci/skills/fetch-releases/fetch_releases.py --latest)}"

# Use with fetch-test-report
python3 plugins/ci/skills/fetch-test-report/fetch_test_report.py "<test_name>" --release "$release"

Output Format

--latest

Prints a single release version string:

4.22

--format json (default)

[
  {"release": "4.22"},
  {"release": "4.21", "ga": "2025-06-17T00:00:00Z"},
  {"release": "4.20", "ga": "2025-10-21T00:00:00Z"},
  {"release": "4.19", "ga": "2025-06-17T00:00:00Z"}
]

Releases without a ga field are still in development.

--format list

4.22
4.21
4.20
4.19
4.18

Error Handling