| name | upgrade-infrahub |
| description | Upgrade the Infrahub platform version in this project. Handles downloading the new compose file, upgrading the SDK, updating version references across Dockerfile, docker-compose.override.yml, and .envrc, and rebuilding the Docker image. Use this skill whenever the user asks to upgrade, bump, or update the Infrahub version — even if they just say something like "bump infrahub to 1.9" or "upgrade to latest infrahub" or "update infrahub version".
|
Upgrade Infrahub
This skill upgrades the Infrahub platform version across the project. The version appears in several
files and needs to stay in sync — this skill handles all of them in the right order.
Step 1: Get the target version
If the user provided a version (e.g., "upgrade to 1.8.2"), use it. Otherwise, ask them which version
to upgrade to before proceeding.
The version should be a semver string like 1.8.2 — no v prefix.
Step 2: Download the new compose file
uv run invoke download-compose-file --override --version <VERSION>
This fetches the docker-compose.yml for the target Infrahub version from the Infrahub registry.
Community and Enterprise ship separate compose files. The task picks the one matching
INFRAHUB_EDITION (default community); add --edition=enterprise to fetch the Enterprise file
without exporting the variable. Verify the target version is published for the edition in use —
Enterprise releases do not always match the Community release list.
Step 3: Upgrade the SDK
uv lock --upgrade infrahub-sdk
Then sync all dependency groups:
uv sync --all-groups
These two commands ensure the infrahub-sdk package is updated to the latest compatible version and
all dependencies are installed.
Step 4: Update version references in project files
Three files contain the Infrahub version and need to be updated:
Dockerfile
In the root Dockerfile, update the INFRAHUB_BASE_VERSION build arg:
ARG INFRAHUB_BASE_VERSION=<VERSION>
Leave INFRAHUB_BASE_IMAGE and INFRAHUB_IMAGE_USER alone — they carry the edition, not the
version, and tasks.py supplies both.
docker-compose.override.yml
In docker-compose.override.yml, update every occurrence of the old version in the
INFRAHUB_BASE_VERSION default values. There are two places:
- The image tag:
image: opsmill/infrahub-solution-ai-dc:${INFRAHUB_BASE_VERSION:-<VERSION>}
- The build arg:
INFRAHUB_BASE_VERSION: "${INFRAHUB_BASE_VERSION:-<VERSION>}"
.envrc (conditional)
Only if .envrc exists in the project root and contains a VERSION= line, update it:
export VERSION="<VERSION>"
If .envrc doesn't exist or doesn't define VERSION, skip this file.
Step 5: Reload environment
direnv allow
This reloads the environment variables from .envrc so the new version takes effect in the shell.
Step 6: Rebuild the Docker image
uv run inv build
This rebuilds the Docker image with the new Infrahub base version. This step can take a while —
let the user know it's running.
The image name follows the edition: opsmill/infrahub-solution-ai-dc on Community,
opsmill/infrahub-enterprise-solution-ai-dc on Enterprise. Rebuild once per edition the user keeps
in play, since the old image stays behind at the previous version otherwise.
