skills.rest
confighub
confighubOFFICIAL
Explore all skills by this author →
WebsiteGitHub

rollback-revision

Roll back a Unit's head to a prior revision using cub unit update --restore.

2|2|Updated Apr 15, 2026
Search Tags:#deployment#rollback#revision#unit#confighub#change-set#cub
One-click install
npx skills add https://github.com/confighub/confighub-skills --skill rollback-revision
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rollback-revision
Source: https://github.com/confighub/confighub-skills/tree/main/skills/rollback-revision
Command: npx skills add https://github.com/confighub/confighub-skills --skill rollback-revision

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Roll back a Unit's head to a prior revision to undo a bad change.

Core Features & Use Cases

  • Move a Unit head back to a saved revision using cub unit update --restore.
  • Apply the restored state by handing off to cub-apply, enabling a controlled rollback for single Units or Filter-scoped sets.
  • Use cases include post-promotion rollback, drift correction, and reverting a faulty ChangeSet.

Quick Start

Specify the target Unit (or a Filter-scoped set), choose a prior revision, and run cub unit update --space <space> --restore <target> to move the head and then proceed with cub unit diff and cub unit apply.

Frequently Asked Questions about rollback-revision

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I roll back a Unit head to a prior revision after a bad deployment?▼

To roll back a Unit head, run cub unit update --space <space> --restore <target> to move the head to a prior revision. You then proceed with cub unit diff and cub unit apply to complete the rollback process.

Can I revert a faulty ChangeSet for a Filter-scoped set within a Space?▼

Yes, you can revert a faulty ChangeSet for a Filter-scoped set within a Space. The rollback mechanism supports both single Units and Filter-scoped sets by creating a new head from the target revision before applying.

What permissions and environment do I need to restore a Unit revision?▼

Restoring a Unit revision requires a valid cub environment and appropriate permissions. You must also clearly specify the target revision and the Space before executing the cub unit update command.

How does the revision rollback process work when correcting configuration drift?▼

The revision rollback process works by creating a new head from a known target revision. This allows you to undo bad changes or correct configuration drift by restoring the Unit state before applying it.

What is the best way to undo a bad post-promotion deployment for a Unit?▼

The best way to undo a bad post-promotion deployment is using cub unit update --restore. Specify the target Unit and prior revision, then use cub unit diff and cub unit apply to execute the controlled rollback.

Related Skills

Explore More Software Engineering Skills→
confighubconfighub
2

cub-mutate

Mutate ConfigHub Units via function-based edits with preflight checks.

Official
Advanced
confighubconfighub
2

verify-apply

Classify post-apply outcomes by correlating unit status and runtime state across ConfigHub, controller, and cluster.

Official
Intermediate
confighubconfighub
2

config-as-data

Store Kubernetes configuration as literal YAML in ConfigHub units via cub mutations.

Official
Advanced
sgcarstrendssgcarstrends
21

deployment-rollback

Roll back failed deployments across environments using SST, AWS CLI, and Git.

Official
Advanced