aboutsummaryrefslogtreecommitdiff
path: root/doc/source/support_matrix.rst
blob: bec1aa0bd1491dbfa699062ba82e547a1b2a17ef (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
.. _support_matrix:

===========================
Kolla Images Support Matrix
===========================

This page describes the supported base container image distributions and
versions, and the Kolla images supported on each of those.

.. _support-matrix-base-images:

Supported base images
=====================

The following base container images are supported:

================== =============================== ================
Distribution       Default base                    Default base tag
================== =============================== ================
Centos             quay.io/centos/centos           stream10
Debian Trixie      debian                          trixie
Rocky Linux        quay.io/rockylinux/rockylinux   10
Ubuntu Noble       ubuntu                          24.04
================== =============================== ================

The remainder of this document outlines which images are supported on which of
these distribution.

Ceph versions in Kolla images
=============================

.. csv-table:: Ceph versions
   :header-rows: 2
   :stub-columns: 1
   :file: ./ceph_versions.csv

Open vSwitch versions in Kolla images
=====================================

.. csv-table:: Open vSwitch versions
   :header-rows: 2
   :stub-columns: 1
   :file: ./openvswitch_versions.csv

OVN versions in Kolla images
============================

.. csv-table:: OVN versions
   :header-rows: 2
   :stub-columns: 1
   :file: ./ovn_versions.csv

Support clause definitions
==========================

T - Tested
----------

Coverage:

* CI in ``kolla-ansible`` is testing that images are functional
* kolla core team is maintaining versions

U - Untested
------------

Coverage:

* CI in ``kolla-ansible`` is *NOT* testing that images are functional
* Many untested services are working fine, but the kolla core team cannot
  guarantee that they are all functional

N - Not Available/Unknown
-------------------------

Not available *(e.g. not buildable)*.
Please see :ref:`unbuildable-images-list`

Deprecations
============

None

x86_64 images
=============

.. csv-table:: x86_64 images
   :header-rows: 1
   :stub-columns: 1
   :widths: auto
   :file: ./matrix_x86.csv

aarch64 images
==============

.. csv-table:: aarch64 images
   :header-rows: 1
   :stub-columns: 1
   :widths: auto
   :file: ./matrix_aarch64.csv

.. _unbuildable-images-list:

Currently unbuildable images
============================

For a list of currently unbuildable images please look into
``kolla/image/unbuildable.py`` file - ``UNBUILDABLE_IMAGES`` dictionary.

SPICE limitations
=================

The new OpenStack Compute console type ``spice-direct`` requires that
SPICE support be compiled into the qemu running the instance. Sadly,
Red Hat chose to remove SPICE support from qemu in RHEL9, and Rocky
Linux has followed along. You therefore _must_ run the Debian or Ubuntu
container images if you wish to use the ``spice-direct`` console type.