diff options
| author | Konstantin Yarovoy <konstantin.yarovoy@tietoevry.com> | 2022-04-07 13:16:15 +0200 |
|---|---|---|
| committer | Roman Krcek <roman.krcek@tietoevry.com> | 2025-03-19 17:20:04 +0000 |
| commit | f726cfd9982bf6a5250859f3ecfcacf018159b99 (patch) | |
| tree | bd0a4c62f63935e18b96e4610f684f6deeed4caa /doc/source/admin | |
| parent | 12aa03929a30dc9d10b12a64551623d9fd998a2f (diff) | |
| download | kolla-ansible-f726cfd9982bf6a5250859f3ecfcacf018159b99.tar.gz kolla-ansible-f726cfd9982bf6a5250859f3ecfcacf018159b99.zip | |
Add container engine migration scenario
Add "migrate-container-engine" action to kolla-ansible which
changes the container engine on which the Openstack is deployed on.
For example Docker to Podman and vice versa.
Depends-on: https://review.opendev.org/c/openstack/ansible-collection-kolla/+/925083
Signed-off-by: Konstantin Yarovoy <konstantin.yarovoy@tietoevry.com>
Signed-off-by: Martin Hiner <m.hiner@partner.samsung.com>
Signed-off-by: Roman Krček <roman.krcek@tietoevry.com>
Change-Id: Icd709cb042d44e063c5da64ab0695b0b6ba6d48b
Diffstat (limited to 'doc/source/admin')
| -rw-r--r-- | doc/source/admin/advanced-configuration.rst | 38 |
1 files changed, 38 insertions, 0 deletions
diff --git a/doc/source/admin/advanced-configuration.rst b/doc/source/admin/advanced-configuration.rst index a803467dd..ad4e13c66 100644 --- a/doc/source/admin/advanced-configuration.rst +++ b/doc/source/admin/advanced-configuration.rst @@ -315,3 +315,41 @@ To specify additional volumes for a single container, set nova_libvirt_extra_volumes: - "/etc/foo:/etc/foo" + +Migrate container engine +~~~~~~~~~~~~~~~~~~~~~~~~ + +Kolla-Ansible supports two container engines - Docker and Podman. +It is possible to migrate deployed OpenStack between these two engines. +Migration is supported in both directions, meaning it is possible to +migrate from Docker to Podman as well as from Podman to Docker. + +Before starting the migration, you have to change the value of +``kolla_container_engine`` in your ``/etc/kolla/globals.yml`` file to the new +container engine: + +.. code-block:: yaml + + # previous value was docker + kolla_container_engine: podman + +Apart from this change, ``globals.yml`` should stay unchanged. +The same goes for any other config file, such as the inventory file. + +.. warning:: + + Currently, rolling migration is not supported. You have to stop + all virtual machines running in your OpenStack. Otherwise, + migration will become unstable and can fail. + +After editing ``globals.yml`` and stopping virtual machines +migration can be started with the following command: + +.. code-block:: console + + kolla-ansible migrate-container-engine + +.. warning:: + During the migration, all the container volumes will be migrated + under the new container engine. Old container engine system packages will be + removed from the system and all their resources and data will be deleted. |