Skip to content

Fix missing documentation for os_distro #1279

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mbuechse merged 1 commit into from
Sep 25, 2026
Merged

Fix missing documentation for os_distro #1279

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions Standards/scs-0102-v2-image-metadata.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -86,6 +86,7 @@ The following property is recommended:

The values for `architecture` and `os_distro` and `hypervisor_type` (the latter only if specified) values
must follow the [OpenStack specifications](https://docs.openstack.org/glance/2025.1/admin/useful-image-properties.html).
For exceptions, see the [implementation notes](https://docs.scs.community/standards/scs-0102-w1-image-metadata-implementation-testing).
The `os_version` string should be numeric if the distribution uses numbers, the pair `os_distro` `os_version` should
for example be `ubuntu` `24.04` for Ubuntu Noble Numbat 24.04[.x] LTS.

Expand Down
24 changes: 24 additions & 0 deletions Standards/scs-0102-w1-image-metadata-implementation-testing.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,30 @@ The [OpenStack Image Manager from OSISM](https://github.com/osism/openstack-imag
will create a set of images from a "spec file" provided by the user, which can also set the required properties
for these images.

Note that the [OpenStack docs on `os_distro`](https://docs.openstack.org/glance/2025.1/admin/useful-image-properties.html) are not exhaustive by far.
We allow additional values taken from [libosinfo-db](https://gitlab.com/libosinfo/osinfo-db),
however dropping any potential `linux` suffix, to be in line with present OpenStack conventions.
For instance, the following values could be of interest:

- `alma`
- `alpine`
- `arch`
- `centos`
- `debian`
- `fedora`
- `freebsd`
- `gentoo`
- `mandrake`
- `manjaro`
- `netbsd`
- `nixos`
- `openbsd`
- `opensuse`
- `rhel`
- `rocky`
- `ubuntu`
- `void`

## Automated tests

We [implemented](https://github.com/SovereignCloudStack/standards/blob/main/Tests/iaas/openstack_test.py)
Expand Down
Loading