pin_upstream_images

Pin upstream multigres image tags to operator release SHAs in image_defaults.go.

270|28|Updated Sep 25, 2025
One-click install
npx skills add https://github.com/multigres/multigres-operator --skill pin-upstream-images
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pin_upstream_images
Source: https://github.com/multigres/multigres-operator/tree/main/tools/skills/pin_upstream_images
Command: npx skills add https://github.com/multigres/multigres-operator --skill pin-upstream-images

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Pin upstream multigres image tags in image_defaults.go for operator releases. Compares upstream multigres code changes between the current and new SHA, highlights breaking changes and new features, then updates the tags. Triggered by user requests like "prepare images for release", "pin image tags", "pin upstream images", or "upgrade multigres images".

Core Features & Use Cases

  • Pin upstream multigres image tags in image_defaults.go to align with the latest main SHA for all operator images (DefaultPostgresImage, DefaultMultiAdminImage, DefaultMultiAdminWebImage, DefaultMultiOrchImage, DefaultMultiPoolerImage, DefaultMultiGatewayImage).
  • Compare upstream changes between old and new SHAs and highlight breaking changes and new features to inform release decisions.
  • Update the corresponding image tag constants in api/v1alpha1/image_defaults.go to reflect pinned sha-* tags, ensuring consistent deployment behavior across releases.

Quick Start

Run fetch_latest_tags.py to identify the latest sha-* tags and update image_defaults.go accordingly.

Frequently Asked Questions about pin_upstream_images

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

FAQPage Schema
How do I pin upstream multigres image tags for an operator release?

To pin upstream multigres image tags, you run a script-driven digest lookup that maps main SHAs to sha-* tags and automatically updates image_defaults.go. This aligns DefaultPostgresImage, DefaultMultiAdminImage, and other operator images with the release SHA.

How does comparing upstream code changes help with pinning image tags?

Comparing upstream multigres changes between the current and new SHA highlights breaking changes and new features before pinning image tags. This informs release decisions and ensures the updated sha-* tags in image_defaults.go reflect stable, validated deployment behavior.

What is the best way to automate multigres image tag consistency across releases?

Automating multigres image tag consistency involves running fetch_latest_tags.py to identify the latest sha-* tags and update image_defaults.go. This script-driven approach maps operator release SHAs to the correct image tags for all default deployment images.

Which multigres image constants need updating when preparing a release?

Updating multigres image constants requires modifying DefaultPostgresImage, DefaultMultiAdminImage, DefaultMultiAdminWebImage, DefaultMultiOrchImage, DefaultMultiPoolerImage, and DefaultMultiGatewayImage in api/v1alpha1/image_defaults.go to reflect the pinned sha-* tags.

When do I need to pin multigres image tags to a specific SHA?

You need to pin multigres image tags to a specific SHA during release preparation workflows, cross-version upgrades, and validation of image tag consistency. This ensures deployment behavior remains stable and reproducible across different operator releases.

Does pinning upstream images require manual edits to image_defaults.go?

Pinning upstream images does not require manual edits because the process automates updates to api/v1alpha1/image_defaults.go. The script performs a digest lookup, maps main SHAs to sha-* tags, and applies the changes directly to the file.