mirror of
https://github.com/clearlinux/clear-linux-documentation.git
synced 2026-06-29 17:26:01 +00:00
Kristal Dale
8de92f42d7
- Clean up white space - Replace CLOSIA substitutions with CL-ATTR - Replace in line Clear Linux text with CL sub - Update links to not include Clear Linux text in link text Signed-off-by: Kristal Dale <kristal.dale@intel.com>
92 lines
2.5 KiB
ReStructuredText
92 lines
2.5 KiB
ReStructuredText
.. _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 |CL-ATTR|.
|
|
|
|
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.
|
|
|
|
|
|
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 <<EOF | sudo tee /etc/systemd/system/docker.service.d/51-runtime.conf
|
|
[Service]
|
|
Environment="DOCKER_DEFAULT_RUNTIME=--default-runtime kata-runtime"
|
|
EOF
|
|
|
|
#. Restart the Docker systemd services.
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo systemctl daemon-reload
|
|
sudo systemctl restart docker
|
|
|
|
#. Verify Docker is using Kata Containers.
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo docker info | grep -i 'default runtime'
|
|
Default Runtime: kata-runtime
|
|
|
|
Run Kata Containers
|
|
*******************
|
|
|
|
Use the following command:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo docker run -ti busybox sh
|
|
|
|
**Congratulations!**
|
|
|
|
You've successfully migrated from Clear Containers to Kata Containers.
|
|
|
|
|
|
.. _Clear Containers: https://github.com/clearcontainers
|
|
|
|
.. _Kata Containers: https://github.com/kata-containers
|
|
|
|
.. _maintained: https://github.com/kata-containers/documentation/blob/master/Upgrading.md#maintenance-warning
|
|
|
|
.. _Clear Containers configuration: https://github.com/clearcontainers/runtime#configuration
|
|
|
|
.. _Kata Containers configuration: https://github.com/kata-containers/runtime#configuration
|
|
|