openstack/zun
Code Issues Proposed changes

Fix the installation document about removal of --cluster-store

Browse Source 
Starting from stable/2024.1, we no longer need a cluster store
for docker. Therefore, we change the installation steps as follows:
* Remove the --cluster-store option from Docker
* Remove the etcd requirement (since we don't need to use it as cluster store).
* Switch capability_scope to "local" (the default) in kuryr-libnetwork.

Related-Bug: #2007142
Change-Id: I5cb0df5c0c65a4e54841ffb9e8450b21446a5fdd
This commit is contained in:
Hongbin Lu 2025-02-28 10:30:11 +00:00
parent 37ad1eb9d1
commit b480d7106e
1 changed files with 6 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
doc/source/install/compute-install.rst
View File

@ -15,13 +15,10 @@ Prerequisites
------------- -------------
Before you install and configure Zun, you must have Docker and Before you install and configure Zun, you must have Docker and
Kuryr-libnetwork installed properly in the compute node, and have Etcd Kuryr-libnetwork installed properly in the compute node. Refer `Get Docker
installed properly in the controller node. Refer `Get Docker
<https://docs.docker.com/engine/install#supported-platforms>`_ <https://docs.docker.com/engine/install#supported-platforms>`_
for Docker installation and `Kuryr libnetwork installation guide for Docker installation and `Kuryr libnetwork installation guide
<https://docs.openstack.org/kuryr-libnetwork/latest/install>`_, <https://docs.openstack.org/kuryr-libnetwork/latest/install>`_
`Etcd installation guide
<https://docs.openstack.org/install-guide/environment-etcd.html>`_
Install and configure components Install and configure components
-------------------------------- --------------------------------
@ -218,13 +215,13 @@ Install and configure components
* Create the file ``/etc/systemd/system/docker.service.d/docker.conf``. * Create the file ``/etc/systemd/system/docker.service.d/docker.conf``.
Configure docker to listen to port 2375 as well as the default Configure docker to listen to port 2375 as well as the default
unix socket. Also, configure docker to use etcd3 as storage backend: unix socket:
.. code-block:: ini .. code-block:: ini
[Service] [Service]
ExecStart= ExecStart=
ExecStart=/usr/bin/dockerd --group zun -H tcp://compute1:2375 -H unix:///var/run/docker.sock --cluster-store etcd://controller:2379 ExecStart=/usr/bin/dockerd --group zun -H tcp://compute1:2375 -H unix:///var/run/docker.sock
* Restart Docker: * Restart Docker:
@ -234,14 +231,12 @@ Install and configure components
# systemctl restart docker # systemctl restart docker
* Edit the Kuryr config file ``/etc/kuryr/kuryr.conf``. * Edit the Kuryr config file ``/etc/kuryr/kuryr.conf``.
Set ``capability_scope`` to ``global`` and Set ``process_external_connectivity`` to ``False``:
``process_external_connectivity`` to ``False``:
.. code-block:: ini .. code-block:: ini
[DEFAULT] [DEFAULT]
... ...
capability_scope = global
process_external_connectivity = False process_external_connectivity = False
* Restart Kuryr-libnetwork: * Restart Kuryr-libnetwork:
@ -427,7 +422,7 @@ additional configuration steps.
[Service] [Service]
ExecStart= ExecStart=
ExecStart=/usr/bin/dockerd --group zun -H tcp://compute1:2375 -H unix:///var/run/docker.sock --cluster-store etcd://controller:2379 --add-runtime kata=/usr/bin/kata-runtime ExecStart=/usr/bin/dockerd --group zun -H tcp://compute1:2375 -H unix:///var/run/docker.sock --add-runtime kata=/usr/bin/kata-runtime
* Restart Docker: * Restart Docker: