name: new-release description: Automate complete Multicluster Global Hub release workflow across 6 repositories including branch creation, OpenShift CI configuration, catalog OCP version management, bundle updates, and PR creation. REQUIRES explicit RELEASE_BRANCH specification (e.g., RELEASE_BRANCH=release-2.17). Supports two modes - CREATE_BRANCHES=true (create branches) or false (update via PR). Keywords: release branch, global hub, openshift/release, catalog, bundle, CI configuration, OCP versions. allowed-tools: [Read, Write, Bash, Glob, Grep]

Global Hub New Release Workflow

Automates the complete end-to-end workflow for cutting a new Multicluster Global Hub release across all 6 repositories with full automation.

Execution Instructions for Claude

CRITICAL - Synchronous Execution Required:

Run Synchronously: Execute the cut-release.sh script using the Bash tool WITHOUT the run_in_background parameter. The script must run synchronously to completion with a 600000ms (10 minute) timeout.
No BashOutput Calls: DO NOT use the BashOutput tool. The command runs synchronously and returns complete output when finished.

When to Use This Skill

Cutting a new Global Hub release (e.g., release-2.16, release-2.17)
Updating an existing release branch with new configurations
Setting up complete release infrastructure across all repositories
Automating the entire release checklist workflow
Creating coordinated PRs and branches for new releases

Important Requirements

RELEASE_BRANCH must be explicitly specified - The skill does NOT auto-detect release versions. You must provide the exact release branch name.

Two Operating Modes:

CREATE_BRANCHES=true: Create new release branches and push directly to upstream (for initial release creation)
CREATE_BRANCHES=false (default): Update existing release branches via PR (for updating current releases)

Version Mapping (ACM to Global Hub)

The skill uses ACM release branch names as the primary input and automatically calculates the corresponding Global Hub version.

Version Mapping Table

ACM Version	Release Branch	Global Hub Version	Bundle/Catalog Branch	OCP Versions
2.14	release-2.14	v1.5.0	release-1.5	4.15 - 4.19
2.15	release-2.15	v1.6.0	release-1.6	4.16 - 4.20
2.16	release-2.16	v1.7.0	release-1.7	4.17 - 4.21
2.17	release-2.17	v1.8.0	release-1.8	4.18 - 4.22
2.18	release-2.18	v1.9.0	release-1.9	4.19 - 4.23

Formulas:

Global Hub version: v1.X.0 where X = ACM_MINOR - 9
OCP versions: 4.(GH_MINOR + 10) to 4.(GH_MINOR + 14)

Example: ACM release-2.17 → Global Hub v1.8.0 → Bundle/Catalog release-1.8

Repository Workflow

The skill manages releases across 6 repositories, each with its own dedicated script:

Repository 1: multicluster-global-hub (Script 01)

Repository: stolostron/multicluster-global-hub

What it does (4-part workflow):

Update main branch: Creates new .tekton/ configuration files for new version (e.g., globalhub-1-8) with target_branch="main", updates Containerfile.* version labels
Create release branch: Creates ACM release branch (e.g., release-2.17) from updated main
Create PR to main: Creates PR to upstream main with new release configurations
Update previous release: Updates previous release branch's .tekton/ files to set target_branch to the previous release branch (e.g., globalhub-1-7 files updated to target_branch="release-2.16")

Key behavior:

New .tekton/ files (e.g., globalhub-1-8) created by copying old files (globalhub-1-7), not renaming
Old .tekton/ files (globalhub-1-7) remain on main with target_branch="main"
Previous release branch gets updated so its files point to itself (not main)
Ensures continuous file naming progression: globalhub-1-6 → globalhub-1-7 → globalhub-1-8

Outputs: 1 PR (new release configurations to main), direct pushes to release branches

Repository 2: openshift/release (Script 02)

Repository: openshift/release

What it does:

Updates main branch CI configuration (promotion, fast-forward)
Creates new release pipeline configuration
Auto-generates presubmit/postsubmit jobs using make update
Validates container engine availability (Docker or Podman)
Creates PR with all CI changes

Outputs: 1 PR (CI configuration)

Repository 3: operator-bundle (Script 03)

Repository: stolostron/multicluster-global-hub-operator-bundle

What it does:

Creates bundle branch using Global Hub version (e.g., release-1.8 from v1.8.0)
Updates images_digest_mirror_set.yaml with new image tags
Renames and updates tekton pipelines (pull-request and push)
Updates bundle image labels to new version
Updates konflux-patch.sh image references
Creates PR with all bundle changes

Outputs: 1 PR (bundle updates to main)

Repository 4: operator-catalog (Script 04)

Repository: stolostron/multicluster-global-hub-operator-catalog

What it does:

Creates catalog branch using Global Hub version (e.g., release-1.8)
Updates images-mirror-set.yaml with new image tags
Adds new OCP version pipelines (e.g., OCP 4.21 for release-1.8)
Removes old OCP version pipelines (e.g., OCP 4.16)
Updates existing OCP version pipelines (4.17-4.20)
Updates README.md with new version information
Updates GitHub Actions workflow for new release branch
Creates 2 PRs:
- Main PR: New release configuration to main branch
- Cleanup PR: Remove GitHub Actions from old release branch

OCP Version Formula: OCP_MIN = 4.(10 + GH_MINOR), OCP_MAX = OCP_MIN + 4

Outputs: 2 PRs (main release + cleanup)

Repository 5: glo-grafana (Script 05)

Repository: stolostron/glo-grafana

What it does:

Creates grafana branch using Global Hub version (e.g., release-1.8)
Renames and updates tekton pipelines (pull-request and push)
Updates branch references in pipeline files

Outputs: Branch creation only (no PR)

Repository 6: postgres_exporter (Script 06)

Repository: stolostron/postgres_exporter

What it does:

Creates postgres_exporter branch using ACM version (e.g., release-2.17)
Renames and updates tekton pipelines (pull-request and push)
Updates branch references in pipeline files

Outputs: Branch creation only (no PR)

Script Organization

.claude/skills/cut-release/
├── SKILL.md                          # This file
├── README.md                         # User documentation
└── scripts/
    ├── cut-release.sh                # Main orchestration script
    ├── 01-multicluster-global-hub.sh # Main repo (creates version bump PR)
    ├── 02-openshift-release.sh       # CI config (creates PR)
    ├── 03-bundle.sh                  # Bundle (creates PR)
    ├── 04-catalog.sh                 # Catalog (creates 2 PRs)
    ├── 05-grafana.sh                 # Grafana (branch only)
    └── 06-postgres-exporter.sh       # Postgres exporter (branch only)

Execution Modes

IMPORTANT: RELEASE_BRANCH environment variable is REQUIRED for all execution modes.

The main orchestration script supports three modes:

1. Interactive Mode (Default)

RELEASE_BRANCH=release-2.17 ./scripts/cut-release.sh

Prompts user to select which repositories to update (1-6, comma-separated, or all).

2. All Repositories Mode

RELEASE_BRANCH=release-2.17 ./scripts/cut-release.sh all

Updates all 6 repositories in sequence.

3. Selective Mode

RELEASE_BRANCH=release-2.17 ./scripts/cut-release.sh 1,2,3    # Update specific repos
RELEASE_BRANCH=release-2.17 ./scripts/cut-release.sh 3,4      # Update only bundle and catalog

4. CREATE_BRANCHES Mode (Create New Branches)

CREATE_BRANCHES=true RELEASE_BRANCH=release-2.17 ./scripts/cut-release.sh all

Creates new release branches and pushes directly to upstream (requires write access).

5. UPDATE Mode (Default - Create PRs)

CREATE_BRANCHES=false RELEASE_BRANCH=release-2.17 ./scripts/cut-release.sh all
# or simply:
RELEASE_BRANCH=release-2.17 ./scripts/cut-release.sh all

Updates existing release branches by creating pull requests.

6. Standalone Script Execution

Each script can be run independently:

RELEASE_BRANCH="release-2.17" GH_VERSION="v1.8.0" CREATE_BRANCHES=false ./scripts/03-bundle.sh

Environment Variables

The main orchestration script calculates and exports these variables for child scripts:

Variable	Description	Example	Required
`RELEASE_BRANCH`	ACM release branch	`release-2.17`	YES - Must be explicitly set
`CREATE_BRANCHES`	Operating mode (true/false)	`false`	Optional (default: false)
`GITHUB_USER`	GitHub username for PRs	`yanmxa`	Optional (auto-detected from git)
`ACM_VERSION`	ACM version number	`2.17`	Auto-calculated
`GH_VERSION`	Global Hub version	`v1.8.0`	Auto-calculated
`GH_VERSION_SHORT`	Short Global Hub version	`1.8`	Auto-calculated
`BUNDLE_BRANCH`	Bundle release branch	`release-1.8`	Auto-calculated
`BUNDLE_TAG`	Bundle image tag	`globalhub-1-8`	Auto-calculated
`CATALOG_BRANCH`	Catalog release branch	`release-1.8`	Auto-calculated
`CATALOG_TAG`	Catalog image tag	`globalhub-1-8`	Auto-calculated
`GRAFANA_BRANCH`	Grafana release branch	`release-1.8`	Auto-calculated
`GRAFANA_TAG`	Grafana tag	`globalhub-1-8`	Auto-calculated
`POSTGRES_TAG`	Postgres image tag	`globalhub-1-8`	Auto-calculated
`OCP_MIN`	Minimum OCP version number	`417`	Auto-calculated
`OCP_MAX`	Maximum OCP version number	`421`	Auto-calculated
`OPENSHIFT_RELEASE_PATH`	Path to openshift/release clone	`/tmp/openshift-release`	Optional
`WORK_DIR`	Working directory for repos	`/tmp/globalhub-release-repos`	Optional

Individual scripts can be run standalone by providing the required variables.

Platform Compatibility

All scripts are compatible with:

macOS (ARM/Apple Silicon and Intel) - Uses sed -i "" syntax
Linux (x86_64) - Uses sed -i syntax

Scripts automatically detect the OS and use the appropriate sed syntax.

Prerequisites

Git configured with your GitHub credentials
GitHub CLI (gh) authenticated with your account
Fork of https://github.com/openshift/release (for script 02)
Container engine (Docker or Podman) running (for script 02's make update)
Write access to all stolostron repositories

Workflow Summary

When running the complete workflow (cut-release.sh all):

Phase 1: Main Repository (Script 01)

Detects latest release and calculates next version
Creates release branch from main
Updates .tekton/ and Containerfile.*
Creates version bump PR to main branch

Phase 2: OpenShift CI (Script 02)

Validates container engine availability
Updates CI configurations for new release
Auto-generates job configurations
Creates PR to openshift/release

Phase 3: Bundle (Script 03)

Creates bundle release branch
Updates all bundle configurations and tekton pipelines
Creates PR to main branch

Phase 4: Catalog (Script 04)

Creates catalog release branch
Manages OCP version lifecycle (add newest, remove oldest)
Updates all catalog configurations
Creates 2 PRs (main release + old branch cleanup)

Phase 5: Grafana (Script 05)

Creates grafana release branch
Updates tekton pipelines

Phase 6: Postgres Exporter (Script 06)

Creates postgres_exporter release branch
Updates tekton pipelines

Total Output

After running all 6 scripts:

Pull Requests Created: 5 PRs

Main repo: Version bump PR
OpenShift CI: CI configuration PR
Bundle: Bundle update PR
Catalog: New release configuration PR
Catalog: Cleanup PR for old branch

Branches Created: 5 branches

multicluster-global-hub: release-2.17
operator-bundle: release-1.8
operator-catalog: release-1.8
glo-grafana: release-1.8
postgres_exporter: release-2.17

Error Handling

The orchestration script includes error handling:

Each script can fail independently
User is prompted to continue or abort after failures
Final summary shows completed vs failed repositories
Exit code indicates overall success/failure

Example Usage

Update all repositories (UPDATE mode - creates PRs):

RELEASE_BRANCH=release-2.17 ./.claude/skills/cut-release/scripts/cut-release.sh all

Create new release branches (CREATE_BRANCHES mode - pushes directly):

CREATE_BRANCHES=true RELEASE_BRANCH=release-2.18 ./.claude/skills/cut-release/scripts/cut-release.sh all

Interactive selection:

RELEASE_BRANCH=release-2.17 ./.claude/skills/cut-release/scripts/cut-release.sh
# Then select: 3,4 (to update only bundle and catalog)

Update specific repositories:

RELEASE_BRANCH=release-2.17 ./.claude/skills/cut-release/scripts/cut-release.sh 1,2,3

Standalone script execution:

RELEASE_BRANCH="release-2.17" GH_VERSION="v1.8.0" CREATE_BRANCHES=false ./scripts/04-catalog.sh

Output Format

The skill provides clear progress indicators:

🔍 Detecting latest release branch...
   Latest release: release-2.16
   Next release: release-2.17

📊 Version Information
================================================
   ACM Release:          release-2.17 (2.17)
   Global Hub Version:   v1.8.0
   Bundle Branch:        release-1.8
   Catalog Branch:       release-1.8
   Supported OCP:        4.17 - 4.21
================================================

Mode: Update all repositories

🚀 Starting Release Workflow
================================================

────────────────────────────────────────────────
📦 [1/6] multicluster-global-hub
────────────────────────────────────────────────
   Main repository with operator, manager, and agent

🚀 Multicluster Global Hub Release Branch Creation
...
✅ multicluster-global-hub completed successfully

────────────────────────────────────────────────
📦 [2/6] openshift/release
────────────────────────────────────────────────
   OpenShift CI configuration
...
✅ openshift/release completed successfully

... (continues for all 6 repositories)

================================================
📋 Release Workflow Summary
================================================

Version:
   ACM: 2.17
   Global Hub: v1.8.0

Results:
   Total: 6
   ✅ Completed: 6
   ❌ Failed: 0

================================================
🎉 All selected repositories updated successfully!

📝 Next Steps:
   1. Review and merge created PRs
   2. Verify all release branches
   3. Update konflux-release-data (manual)

Manual Steps Still Required

After running the automated scripts:

Merge all created PRs
- Review changes carefully
- Ensure CI passes
- Merge in appropriate order
Update konflux-release-data repository
- Add new release configuration
- (Not automated by this skill)
Verify release branches
- Check all branches were created correctly
- Verify version numbers match expectations

Automation Coverage

This skill automates the following from RELEASE_CHECKLIST.md:

✅ Create new release branches (all 6 repositories)
✅ Update pipelinesascode configurations (.tekton/)
✅ Update Containerfile.* versions
✅ Update openshift/release configurations
✅ Auto-generate CI job configurations
✅ Update bundle manifests and image references
✅ Manage catalog OCP version lifecycle
✅ Update catalog README and image mirror sets
✅ Update GitHub Actions workflows
✅ Create all necessary PRs
⚠️ Manual: Update konflux-release-data repository
⚠️ Manual: Merge PRs after review

Install Skill

SKILL.md

Global Hub New Release Workflow

Execution Instructions for Claude

When to Use This Skill

Important Requirements

Version Mapping (ACM to Global Hub)

Version Mapping Table

Repository Workflow

Repository 1: multicluster-global-hub (Script 01)

Repository 2: openshift/release (Script 02)

Repository 3: operator-bundle (Script 03)

Repository 4: operator-catalog (Script 04)

Repository 5: glo-grafana (Script 05)

Repository 6: postgres_exporter (Script 06)

Script Organization

Execution Modes

1. Interactive Mode (Default)

2. All Repositories Mode

3. Selective Mode

4. CREATE_BRANCHES Mode (Create New Branches)

5. UPDATE Mode (Default - Create PRs)

6. Standalone Script Execution

Environment Variables

Platform Compatibility

Prerequisites

Workflow Summary

Phase 1: Main Repository (Script 01)

Phase 2: OpenShift CI (Script 02)

Phase 3: Bundle (Script 03)

Phase 4: Catalog (Script 04)

Phase 5: Grafana (Script 05)

Phase 6: Postgres Exporter (Script 06)

Total Output

Error Handling

Example Usage

Update all repositories (UPDATE mode - creates PRs):

Create new release branches (CREATE_BRANCHES mode - pushes directly):

Interactive selection:

Update specific repositories:

Standalone script execution:

Output Format

Manual Steps Still Required

Related Documentation

Automation Coverage