aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMichal Nasiadka <mnasiadka@gmail.com>2026-04-24 19:05:46 +0200
committerMichal Nasiadka <mnasiadka@gmail.com>2026-04-27 05:18:03 +0000
commit9f1256ba74f05ea815e97e5769f9942f80bc0261 (patch)
treee1f3ee18efef563a3dc6066144f7ca4583ac7e73 /doc
parent6c0e560ae6398a97df9242fe9e2836e3c2144a71 (diff)
downloadkolla-ansible-9f1256ba74f05ea815e97e5769f9942f80bc0261.tar.gz
kolla-ansible-9f1256ba74f05ea815e97e5769f9942f80bc0261.zip
Drop zun and kuryr
Zun is broken in 2026.1, it has been released broken and there are no reviews on the patch to fix it [1]. [1]: https://review.opendev.org/c/openstack/zun/+/982362 Depends-On: https://review.opendev.org/c/openstack/ansible-collection-kolla/+/986150 Change-Id: I8ced621754d03c44b7672dd94fc3d7d2173ac734 Signed-off-by: Michal Nasiadka <mnasiadka@gmail.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/source/contributor/ci-matrix.csv1
-rw-r--r--doc/source/reference/compute/index.rst1
-rw-r--r--doc/source/reference/compute/zun-guide.rst116
-rw-r--r--doc/source/reference/containers/index.rst4
-rw-r--r--doc/source/reference/containers/kuryr-guide.rst66
-rw-r--r--doc/source/reference/storage/external-ceph-guide.rst28
6 files changed, 1 insertions, 215 deletions
diff --git a/doc/source/contributor/ci-matrix.csv b/doc/source/contributor/ci-matrix.csv
index c49b72868..c9ba67f00 100644
--- a/doc/source/contributor/ci-matrix.csv
+++ b/doc/source/contributor/ci-matrix.csv
@@ -21,4 +21,3 @@ OVN;–;✅;✅;✅;✅;–;✅;✅;–;✅;–;–;Neutron ML2/OVN + OVN Octavi
Prometheus + OpenSearch;–;–;–;✅;–;✅;✅;–;–;–;–;–;Fluentd, OpenSearch, Grafana, Prometheus, RabbitMQ/DB core.
Skyline;❌;–;✅;–;–;✅;–;–;–;–;–;–;"Skyline dashboard; currently disabled (SSO issues)."
Telemetry;–;–;✅;–;–;✅;–;–;–;–;✅;✅;Aodh, Ceilometer, Gnocchi.
-Zun;–;✅;✅;–;✅;✅;✅;✅;–;–;–;–;"Zun + Kuryr + Cinder LVM; etcd; dashboard."
diff --git a/doc/source/reference/compute/index.rst b/doc/source/reference/compute/index.rst
index d155ffa69..b13bd2ec9 100644
--- a/doc/source/reference/compute/index.rst
+++ b/doc/source/reference/compute/index.rst
@@ -13,4 +13,3 @@ compute services.
nova-cells-guide
nova-fake-driver
nova-guide
- zun-guide
diff --git a/doc/source/reference/compute/zun-guide.rst b/doc/source/reference/compute/zun-guide.rst
deleted file mode 100644
index 8df209a73..000000000
--- a/doc/source/reference/compute/zun-guide.rst
+++ /dev/null
@@ -1,116 +0,0 @@
-=======================
-Zun - Container service
-=======================
-
-"Zun is an OpenStack Container service. It aims to provide an
-OpenStack API for provisioning and managing containerized
-workload on OpenStack."
-For more details about Zun, see `OpenStack Zun Documentation
-<https://docs.openstack.org/zun/latest/>`__.
-
-Preparation and Deployment
---------------------------
-
-By default Zun and its dependencies are disabled.
-In order to enable Zun, you need to edit globals.yml and set the
-following variables:
-
-.. code-block:: yaml
-
- enable_zun: true
- enable_kuryr: true
- enable_etcd: true
- docker_configure_for_zun: true
- containerd_configure_for_zun: true
-
-Docker reconfiguration requires rebootstrapping before deploy.
-Make sure you understand the consequences of restarting Docker.
-Please see :ref:`rebootstrapping` for details.
-If it's initial deploy, then there is nothing to worry about
-because it's initial bootstrapping as well and there are no
-running services to affect.
-
-.. code-block:: console
-
- $ kolla-ansible bootstrap-servers
-
-Finally deploy:
-
-.. code-block:: console
-
- $ kolla-ansible deploy
-
-Verification
-------------
-
-#. Generate the credentials file:
-
- .. code-block:: console
-
- $ kolla-ansible post-deploy
-
-#. Source credentials file:
-
- .. code-block:: console
-
- $ . /etc/kolla/admin-openrc.sh
-
-#. Download and create a glance container image:
-
- .. code-block:: console
-
- $ docker pull cirros
- $ docker save cirros | openstack image create cirros --public \
- --container-format docker --disk-format raw
-
-#. Create zun container:
-
- .. code-block:: console
-
- $ zun create --name test --net network=demo-net cirros ping -c4 8.8.8.8
-
- .. note::
-
- Kuryr does not support networks with DHCP enabled, disable DHCP in the
- subnet used for zun containers.
-
- .. code-block:: console
-
- $ openstack subnet set --no-dhcp <subnet>
-
-#. Verify container is created:
-
- .. code-block:: console
-
- $ zun list
-
- +--------------------------------------+------+---------------+---------+------------+------------+-------+
- | uuid | name | image | status | task_state | addresses | ports |
- +--------------------------------------+------+---------------+---------+------------+------------+-------+
- | 3719a73e-5f86-47e1-bc5f-f4074fc749f2 | test | cirros | Created | None | 172.17.0.3 | [] |
- +--------------------------------------+------+---------------+---------+------------+------------+-------+
-
-#. Start container:
-
- .. code-block:: console
-
- $ zun start test
- Request to start container test has been accepted.
-
-#. Verify container:
-
- .. code-block:: console
-
- $ zun logs test
- PING 8.8.8.8 (8.8.8.8): 56 data bytes
- 64 bytes from 8.8.8.8: seq=0 ttl=45 time=96.396 ms
- 64 bytes from 8.8.8.8: seq=1 ttl=45 time=96.504 ms
- 64 bytes from 8.8.8.8: seq=2 ttl=45 time=96.721 ms
- 64 bytes from 8.8.8.8: seq=3 ttl=45 time=95.884 ms
-
- --- 8.8.8.8 ping statistics ---
- 4 packets transmitted, 4 packets received, 0% packet loss
- round-trip min/avg/max = 95.884/96.376/96.721 ms
-
-For more information about how zun works, see
-`zun, OpenStack Container service <https://docs.openstack.org/zun/latest/>`__.
diff --git a/doc/source/reference/containers/index.rst b/doc/source/reference/containers/index.rst
index c1bcc84d4..76afa71f8 100644
--- a/doc/source/reference/containers/index.rst
+++ b/doc/source/reference/containers/index.rst
@@ -2,11 +2,9 @@
Containers
==========
-This section describes configuring and running container based services
-including kuryr.
+This section describes configuring and running container based services.
.. toctree::
:maxdepth: 1
- kuryr-guide
magnum-guide
diff --git a/doc/source/reference/containers/kuryr-guide.rst b/doc/source/reference/containers/kuryr-guide.rst
deleted file mode 100644
index f85451d57..000000000
--- a/doc/source/reference/containers/kuryr-guide.rst
+++ /dev/null
@@ -1,66 +0,0 @@
-============================
-Kuryr - Container networking
-============================
-
-"Kuryr is a Docker network plugin that uses Neutron to provide networking
-services to Docker containers. It provides containerized images for the common
-Neutron plugins. Kuryr requires at least Keystone and neutron. Kolla makes
-kuryr deployment faster and accessible.
-
-Requirements
-~~~~~~~~~~~~
-
-* A minimum of 3 hosts for a vanilla deploy
-
-Preparation and Deployment
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-To allow Docker daemon connect to the etcd, add the following in the
-``docker.service`` file.
-
-.. code-block:: ini
-
- ExecStart= -H tcp://172.16.1.13:2375 -H unix:///var/run/docker.sock --cluster-advertise=172.16.1.13:2375
-
-The IP address is host running the etcd service. ```2375``` is port that
-allows Docker daemon to be accessed remotely. ```2379``` is the etcd listening
-port.
-
-By default etcd and kuryr are disabled in the ``group_vars/all/etcd.yml`` and
-``group_vars/all/kuryr.yml`` files.
-In order to enable them, you need to edit the file globals.yml and set the
-following variables
-
-.. code-block:: yaml
-
- enable_etcd: true
- enable_kuryr: true
-
-Deploy the OpenStack cloud and kuryr network plugin
-
-.. code-block:: console
-
- kolla-ansible deploy
-
-Create a Virtual Network
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. code-block:: console
-
- docker network create -d kuryr --ipam-driver=kuryr --subnet=10.1.0.0/24 --gateway=10.1.0.1 docker-net1
-
-To list the created network:
-
-.. code-block:: console
-
- docker network ls
-
-The created network is also available from OpenStack CLI:
-
-.. code-block:: console
-
- openstack network list
-
-For more information about how kuryr works, see
-`kuryr (OpenStack Containers Networking)
-<https://docs.openstack.org/kuryr/latest/>`__.
diff --git a/doc/source/reference/storage/external-ceph-guide.rst b/doc/source/reference/storage/external-ceph-guide.rst
index 49e64d6c3..a831015ba 100644
--- a/doc/source/reference/storage/external-ceph-guide.rst
+++ b/doc/source/reference/storage/external-ceph-guide.rst
@@ -312,24 +312,6 @@ for use with availability zones:
* ``/etc/kolla/config/nova/<hostname2>/ceph2.conf``
* ``/etc/kolla/config/nova/<hostname2>/ceph2.client.cinder.keyring``
-If ``zun`` is enabled, and you wish to use cinder volumes with zun,
-it must also be configured to allow access to Cinder volumes:
-
-* Enable Cinder Ceph backend for Zun in ``globals.yml``:
-
- .. code-block:: yaml
-
- zun_configure_for_cinder_ceph: "yes"
-
-* Copy Ceph configuration file to:
-
- * ``/etc/kolla/config/zun/zun-compute/ceph.conf``
-
-* Copy Ceph keyring file(s) to:
-
- * ``/etc/kolla/config/zun/zun-compute/ceph.client.cinder.keyring``
-
-
Nova
----
@@ -583,13 +565,3 @@ HTTPS (443) port will be used. For example:
The HAProxy frontend port is defined via ``ceph_rgw_port``, and defaults to
6780.
-
-Cephadm and Ceph Client Version
-===============================
-When configuring Zun with Cinder volumes, kolla-ansible installs some
-Ceph client packages on zun-compute hosts. You can set the version
-of the Ceph packages installed by,
-
-* Configuring Ceph version details in ``/etc/kolla/globals.yml``:
-
- * ``ceph_version`` (default: ``pacific``)