Oadp Rebase

OADP Rebase Plugin

The OADP Rebase plugin provides Claude Code commands for automating the OADP (OpenShift API for Data Protection) rebase process. It handles rebasing ~20 downstream OpenShift forks of the Velero backup/restore ecosystem to newer upstream versions.

Commands

Command	Description
/oadp-rebase:rebase	Run a full rebase for a single repo or entire wave
/oadp-rebase:verify-commits	Verify downstream carry commits are preserved
/oadp-rebase:update-config	Update config to target a new upstream version
/oadp-rebase:manual-rebase	Handle repos needing manual intervention
/oadp-rebase:status	Check rebase status across all repos
/oadp-rebase:update-dependency	Update go.mod replace directives manually

Skills

Skill	Description
rebase-workflow	Complete end-to-end rebase procedure
verify-commits	Detailed commit verification guide
manual-intervention	Manual fix procedures for common failures
hook-scripts	Reference for all post-rebase hook scripts

Key Concepts

Rebasebot

A tool that automates cherry-picking downstream commits onto new upstream bases. Available as a container image or CLI binary.

Wave Ordering

Repositories are organized into 5 waves based on dependency ordering. Always rebase Wave 1 before Wave 2, etc.

Commit Conventions

• UPSTREAM: <carry> - Downstream patches that MUST be preserved across every rebase
• UPSTREAM: <drop> - Auto-generated by hook scripts, regenerated each rebase (safe to lose)

Two Rebase Patterns

1. Full rebase (source != dest): Cherry-picks onto new upstream tag
2. Hooks-only (source == dest): Just runs hook scripts to update dependencies

Prerequisites

• rebasebot CLI or container image
• GitHub App private keys for oadp-rebasebot
• oadp-rebase repository with config files
• gh CLI, Go toolchain