zhongwei/gh-openshift-eng-ai-helpers-plugins-component-health

Fork 0

Files

Zhongwei Li 77cb91c246 Initial commit

2025-11-30 08:45:43 +08:00

2.9 KiB

Raw Permalink Blame History

Get Release Dates

Fetch OpenShift release dates and metadata from the Sippy API.

Overview

This skill retrieves release information for OpenShift releases, including:

GA (General Availability) dates
Development start dates
Previous release in the sequence
Release status (in development vs GA'd)

Usage

python3 plugins/component-health/skills/get-release-dates/get_release_dates.py \
  --release <release>

Arguments

--release (required): Release identifier (e.g., "4.21", "4.20", "4.17")

Examples

Get information for release 4.21

python3 plugins/component-health/skills/get-release-dates/get_release_dates.py \
  --release 4.21

Get information for release 4.17

python3 plugins/component-health/skills/get-release-dates/get_release_dates.py \
  --release 4.17

Output Format

Successful Query (Release Found)

{
  "release": "4.21",
  "found": true,
  "ga": "2026-02-17T00:00:00Z",
  "development_start": "2025-09-02T00:00:00Z",
  "previous_release": "4.20"
}

Release Not Found

{
  "release": "99.99",
  "found": false
}

Exit code: 1

Output Fields

release: The release identifier queried
found: Boolean indicating if release exists in Sippy
ga: GA date. Null means release is still in development.
development_start: When development started
previous_release: Previous release in sequence

Note: If the ga field is null, the release is still under active development and has not reached General Availability yet.

Prerequisites

Python 3.6 or later
Network access to sippy.dptools.openshift.org

API Endpoint

The script queries: https://sippy.dptools.openshift.org/api/releases

Use Cases

Verify Release Exists

Before analyzing a release, verify it exists in Sippy:

python3 get_release_dates.py --release 4.21
# Check "found": true in output

Get Release Timeline

Understand the development timeline:

python3 get_release_dates.py --release 4.17
# Check "development_start" and "ga" dates

Determine Release Status

Check if a release is in development or has GA'd:

python3 get_release_dates.py --release 4.21
# If "ga" is null -> still in development
# If "ga" has timestamp -> has reached GA

Error Handling

The script handles:

Network errors (connection failures)
HTTP errors (404, 500, etc.)
Release not found (exit code 1)
Invalid JSON responses

Notes

Uses Python standard library only (no external dependencies)
Release identifiers are case-sensitive
OKD releases use "-okd" suffix (e.g., "4.21-okd")
Special releases: "Presubmits", "aro-production", "aro-stage", "aro-integration"

2.9 KiB Raw Permalink Blame History