OSISM release repository

Release notes published at https://osism.tech/docs/release-notes/

Overview

This repository is the central place for managing OSISM releases. It pins all component versions (container images, Ansible collections, Python packages, GitHub repositories) for each release and provides the tooling to create new releases, tag components, and generate changelogs.

Repository structure

.
├── latest/              # Current development versions (continuously updated)
│   ├── base.yml         # Core component versions
│   ├── ceph-*.yml       # Ceph-specific versions (quincy, reef, squid)
│   └── openstack-*.yml  # OpenStack-specific versions (2024.1, 2024.2, 2025.1, 2025.2)
├── <VERSION>/           # Pinned release versions (e.g. 10.0.0/, 9.5.0/)
│   └── base.yml         # Frozen component versions for this release
├── next/                # SBOMs and metadata for upcoming builds
├── archive/             # Historical versions
├── etc/                 # Reference metadata
│   ├── images.yml       # Docker image name → registry path mapping
│   ├── collections.yml  # Ansible Galaxy collections
│   └── roles.yml        # Ansible roles
├── scripts/             # Release automation scripts
│   ├── create-tags.sh
│   ├── generate-changelog-input.sh
│   └── generate-release-changelog.sh
└── src/                 # Python utilities
    ├── create-version.py
    ├── git-diff-log.py
    └── remove-images-from-quay.py

Version files

latest/base.yml

The central configuration file. It tracks versions for all components of the OSISM stack:

Section	Content
manager_version	OSISM manager version identifier
ansible_version	Ansible and ansible-core versions
*_version	GitHub tag references for defaults, generics, playbooks, etc.
osism_projects	Python packages (osism, ara, docker, k3s)
docker_images	50+ container image versions
ansible_roles	External Ansible roles with commit hashes or tags
ansible_collections	Ansible Galaxy collections with semantic versions

Each version entry has a Renovate annotation comment above it (e.g. # renovate: datasource=docker depName=registry.osism.tech/osism/osism-ansible) that enables automated dependency updates.

latest/ceph-*.yml

Ceph-specific versions per release stream (quincy, reef, squid). Contains the ceph_ansible_version (stable branch), ceph_version, and Ceph container image versions.

latest/openstack-*.yml

OpenStack-specific versions per release (2024.1, 2024.2, 2025.1, 2025.2). Contains openstack_version, infrastructure project definitions, and all OpenStack project branch references (e.g. stable-2025.1).

<VERSION>/base.yml

A frozen snapshot of latest/base.yml at the time of a release. Created by src/create-version.py. Does not contain Renovate annotations.

Version numbering

Component	Format	Examples
OSISM releases	Semantic versioning	9.5.0, 10.0.0, 10.0.0-rc.1
Component builds	Date-based	v0.20260322.0, 0.20260320.0
External deps	Upstream versioning	18.2.7 (Ceph), 2025.1 (OpenStack)

Release process

1. Continuous dependency updates

Renovate monitors all upstream projects and automatically creates PRs to update versions in the latest/ directory. It supports multiple datasources:

• Docker images (registry.osism.tech, Docker Hub)
• PyPI packages (ansible, osism)
• GitHub tags/releases (defaults, generics, playbooks, docker, k3s)
• Galaxy collections (osism.commons, community.docker, etc.)

Related updates are grouped (e.g. ansible + ansible-core, postgres + pgautoupgrade) to keep PRs manageable.

2. Tag creation

When component images are built and ready, create tags for the core projects:

./scripts/create-tags.sh v0.20260322.0

This creates and pushes tags in the format <project>-<version> for the five core container image projects:

• osism-ansible
• osism-kubernetes
• kolla-ansible
• ceph-ansible
• inventory-reconciler

The tags reference the current HEAD of this repository and serve as version anchors for the container image build pipelines. Existing tags can optionally be recreated.

3. Create a release version

To freeze the current latest/ state into a named release:

./src/create-version.py 10.0.0

This:

• Creates a new directory 10.0.0/
• Copies latest/base.yml (without Renovate comments)
• Queries git tags to resolve the latest versions of core container images (osism-ansible, osism-kubernetes, inventory-reconciler, kolla-ansible, ceph-ansible, kolla)
• Sets manager_version to the release name

4. Changelog generation (per-component)

Generate CHANGELOG entries from git commits using Claude:

# Auto-detect: process all tags not yet in CHANGELOG.md
./scripts/generate-changelog-input.sh --auto

# Specific tag
./scripts/generate-changelog-input.sh v0.20260322.0

# All tags from a given point onwards
./scripts/generate-changelog-input.sh --from v0.20260301.0

# Only generate input files, do not run Claude
./scripts/generate-changelog-input.sh --auto -n

The script:

1. Collects commits and diffs between consecutive tags
2. Batches them by diff size (default: 2000 lines per batch) to stay within prompt limits
3. Sends each batch to Claude for structured changelog generation
4. Merges batch results into a single entry following Keep a Changelog format
5. Auto-inserts the entry into CHANGELOG.md

CI

Gated by Zuul with the following checks on every PR and as periodic daily jobs:

• flake8
• yamllint
• python-black

PRs are merged via squash-merge.

Tracked projects

The 12 core projects whose versions are managed in this repository:

Project	Type	Repository
osism-ansible	Container image	osism/container-image-osism-ansible
kolla-ansible	Container image	osism/container-image-kolla-ansible
ceph-ansible	Container image	osism/container-image-ceph-ansible (?)
osism-kubernetes	Container image	osism/osism-kubernetes
inventory-reconciler	Container image	osism/container-image-inventory-reconciler
osism	Python package	osism/python-osism
osism.services	Ansible collection	osism/ansible-collection-services
osism.commons	Ansible collection	osism/ansible-collection-commons
osism.playbooks	Ansible playbooks	osism/ansible-playbooks
osism.validations	Ansible collection	osism/ansible-collection-validations
manager-playbooks	Ansible playbooks	osism/ansible-playbooks-manager
defaults	Configuration	osism/defaults
generics	Configuration	osism/generics