From 394a1a28ea2552fefedfc87ad46a19452bd05bea Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Matthias=20B=C3=BCchse?= Date: Thu, 17 Sep 2026 15:58:54 +0200 Subject: [PATCH] Fix missing documentation for os_distro MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Matthias Büchse --- Standards/scs-0102-v2-image-metadata.md | 1 + ...1-image-metadata-implementation-testing.md | 24 +++++++++++++++++++ 2 files changed, 25 insertions(+) diff --git a/Standards/scs-0102-v2-image-metadata.md b/Standards/scs-0102-v2-image-metadata.md index 998e34ac0..ab41ac63b 100644 --- a/Standards/scs-0102-v2-image-metadata.md +++ b/Standards/scs-0102-v2-image-metadata.md @@ -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. diff --git a/Standards/scs-0102-w1-image-metadata-implementation-testing.md b/Standards/scs-0102-w1-image-metadata-implementation-testing.md index e82e1b223..5305662a0 100644 --- a/Standards/scs-0102-w1-image-metadata-implementation-testing.md +++ b/Standards/scs-0102-w1-image-metadata-implementation-testing.md @@ -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)