Skip to content

cli: Add tag-aware upgrade operations#2094

Open
gursewak1997 wants to merge 1 commit intobootc-dev:mainfrom
gursewak1997:add-tag-upgrade
Open

cli: Add tag-aware upgrade operations#2094
gursewak1997 wants to merge 1 commit intobootc-dev:mainfrom
gursewak1997:add-tag-upgrade

Conversation

@gursewak1997
Copy link
Contributor

Implement bootc upgrade --tag and --list-tags to simplify tag-based image version management for customers who version images using tags.

This adds:

  • bootc upgrade --tag : Upgrade to different tag of current image
  • bootc upgrade --list-tags: List available tags from registry
  • Automatic composition with --check for verification

The --tag option derives the target image by replacing the tag portion of the current booted image reference. Only works when booted from registry transport images.

Organizations version container images with tags (:latest, :dev, :test, :prod) and this allows them to upgrade between versions without retyping full registry paths or using switch (which is semantically about changing images, not versions).

Assisted-by: Claude Sonnet 4.5

@github-actions github-actions bot added the area/documentation Updates to the documentation label Mar 24, 2026
@bootc-bot bootc-bot bot requested a review from jmarrero March 24, 2026 22:57
Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces new bootc upgrade CLI options: --tag to specify a target image tag for an upgrade, and --list-tags to display available tags for the currently booted image's repository. It includes new helper functions derive_image_with_tag and list_tags_for_current_image to support this functionality, along with corresponding unit tests and documentation updates. A review comment suggests refactoring duplicated logic within the upgrade function for retrieving the current image and handling cases where it's not defined, as well as making error messages more specific.

Implement bootc upgrade --tag and --list-tags to simplify
tag-based image version management for customers who version
images using tags.

This adds:
- bootc upgrade --tag <tag>: Upgrade to different tag of current image
- bootc upgrade --list-tags: List available tags from registry
- Automatic composition with --check for verification

The --tag option derives the target image by replacing the tag
portion of the current booted image reference. Only works when
booted from registry transport images.

Organizations version container images with tags (:latest, :dev,
:test, :prod) and this allows them to upgrade between versions
without retyping full registry paths or using switch (which is
semantically about changing images, not versions).

Assisted-by: Claude Sonnet 4.5
Signed-off-by: gursewak1997 <gursmangat@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/documentation Updates to the documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant