New Release

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:

1. 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.

2. 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

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):

1. Update main branch: Creates new .tekton/ configuration files for new version (e.g., globalhub-1-8) with target_branch="main", updates Containerfile.* version labels
2. Create release branch: Creates ACM release branch (e.g., release-2.17) from updated main
3. Create PR to main: Creates PR to upstream main with new release configurations
4. 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:

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

1. Git configured with your GitHub credentials
2. GitHub CLI (gh) authenticated with your account
3. Fork of https://github.com/openshift/release (for script 02)
4. Container engine (Docker or Podman) running (for script 02's make update)
5. 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

1. Main repo: Version bump PR
2. OpenShift CI: CI configuration PR
3. Bundle: Bundle update PR
4. Catalog: New release configuration PR
5. Catalog: Cleanup PR for old branch

Branches Created: 5 branches

1. multicluster-global-hub: release-2.17
2. operator-bundle: release-1.8
3. operator-catalog: release-1.8
4. glo-grafana: release-1.8
5. 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:

1. Merge all created PRs

   • Review changes carefully
   • Ensure CI passes
   • Merge in appropriate order

2. Update konflux-release-data repository

   • Add new release configuration
   • (Not automated by this skill)

3. Verify release branches

   • Check all branches were created correctly
   • Verify version numbers match expectations

Related Documentation

• README.md - Complete user documentation with examples
• RELEASE_CHECKLIST.md - Original manual checklist

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