diff --git a/source/clear-linux/tutorials/kata_migration.rst b/source/clear-linux/tutorials/kata_migration.rst new file mode 100644 index 00000000..6d41252a --- /dev/null +++ b/source/clear-linux/tutorials/kata_migration.rst @@ -0,0 +1,100 @@ +.. _kata_migration: + +Migrate Clear Containers to Kata Containers\* +############################################# + +`Clear Containers`_ and `Kata Containers`_ can co-exist in the same system. +Both can be installed through the :file:`containers-virt bundle`. However, we +recommend that you migrate to Kata Containers because Clear Containers is no +longer maintained_ and will soon be deprecated on |CLOSIA|. + +This guide describes how to migrate to Kata Containers and assumes that: + +* Clear Containers is on a Docker\* system. +* Kata Containers is installed. See :ref:`kata`. + + +Stop Clear Containers instances +******************************* + +As an unprivileged user, stop all running instances of Clear Containers: + +.. code-block:: bash + + for container in $(sudo docker ps -q); do sudo docker stop $container; done + + +Manually migrate customized configuration files +*********************************************** + +If you have made changes to your `Clear Containers configuration`_, review +those changes and decide whether to manually apply those changes to your +`Kata Containers configuration`_. + +Make any required changes before continuing this process. + +.. note:: + + You do not need to manually remove any Clear Containers packages. + +Disable Clear Containers manager configuration +********************************************** + +Remove the Clear Containers configuration file: + +.. code-block:: bash + + sudo rm /etc/systemd/system/docker.service.d/clear-containers.conf + +Enable Kata Containers as default +********************************* + +#. Configure Docker to use the Kata Containers runtime by default. + + .. code-block:: bash + + sudo mkdir -p /etc/systemd/system/docker.service.d/ + cat <