upgrade-infrahub

Upgrades the Infrahub platform version across compose files, SDK, Dockerfile, and Docker images.

9|2|Updated Aug 27, 2025
One-click install
npx skills add https://github.com/opsmill/infrahub-solution-ai-dc --skill upgrade-infrahub-opsmill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: upgrade-infrahub
Source: https://github.com/opsmill/infrahub-solution-ai-dc/tree/main/.agents/skills/upgrade-infrahub
Command: npx skills add https://github.com/opsmill/infrahub-solution-ai-dc --skill upgrade-infrahub-opsmill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Upgrading Infrahub requires changing the version in several files (Dockerfile, docker-compose.override.yml, .envrc) plus downloading the matching compose file, upgrading the SDK, and rebuilding the Docker image. Doing this manually is error-prone and easy to leave files out of sync. ## Core Features & Use Cases - Compose file download: Fetches the docker-compose.yml for the target Infrahub version via uv run invoke download-compose-file, with Community and Enterprise edition support. - SDK upgrade: Runs uv lock --upgrade infrahub-sdk and uv sync --all-groups to update the infrahub-sdk package and all dependency groups. - Version reference updates: Updates INFRAHUB_BASE_VERSION in the Dockerfile, both occurrences in docker-compose.override.yml, and conditionally the VERSION line in .envrc. - Environment reload and rebuild: Runs direnv allow and rebuilds the Docker image with uv run inv build for the edition in use. - Use Case: A user says "bump infrahub to 1.9" and the skill performs the full ordered upgrade sequence, keeping every version reference in sync. ## Quick Start Upgrade this project to Infrahub version 1.8.2 and rebuild the Docker image.

Frequently Asked Questions about upgrade-infrahub

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

FAQPage Schema
How do I upgrade the Infrahub version in my project?▼

Provide a target semver version like 1.8.2, then the skill downloads the matching compose file, upgrades infrahub-sdk with uv, updates INFRAHUB_BASE_VERSION in the Dockerfile and docker-compose.override.yml, reloads direnv, and rebuilds the Docker image.

How do I upgrade infrahub-sdk with uv?▼

Run `uv lock --upgrade infrahub-sdk` followed by `uv sync --all-groups`. The first command updates the locked SDK version to the latest compatible release, and the second installs all dependency groups.

Does the Infrahub upgrade support Enterprise edition?▼

Yes. The compose download task selects the file matching INFRAHUB_EDITION, defaulting to community, and accepts `--edition=enterprise`. Verify the target version is published for Enterprise, since its releases do not always match Community.

Which files contain the Infrahub version that need updating?▼

Three files: the Dockerfile ARG INFRAHUB_BASE_VERSION, two INFRAHUB_BASE_VERSION defaults in docker-compose.override.yml, and optionally the VERSION line in .envrc if that file exists and defines it.

Why is my old Infrahub image still present after upgrading?▼

The old image remains because rebuilding only creates the new versioned image; the previous one is not removed. Rebuild once per edition you use, since Community and Enterprise produce different image names.