From b7a99447dfa9243c113273e8363cf588b4cb17f1 Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Mon, 16 Jul 2018 15:52:00 -0700 Subject: [PATCH] Corrects grammatical errors. Corrects Sphinx syntax for URLs. Signed-off-by: Michael Vincerra --- .../clear-linux/tutorials/docker/docker.rst | 54 +++++++++++-------- 1 file changed, 33 insertions(+), 21 deletions(-) diff --git a/source/clear-linux/tutorials/docker/docker.rst b/source/clear-linux/tutorials/docker/docker.rst index 60f6dc02..6c6cae2a 100644 --- a/source/clear-linux/tutorials/docker/docker.rst +++ b/source/clear-linux/tutorials/docker/docker.rst @@ -4,8 +4,8 @@ Run Docker\* on Clear Linux\* ############################# |CLOSIA| supports multiple containerization platforms, including a Docker\* -solution.|CL| has many `unique features`_ including a minimal default -installation which makes it compelling to use as a host for container +solution. |CL| has many `unique features`_ including a minimal default +installation, which makes it compelling to use as a host for container workloads, management, and orchestration. This tutorial covers: @@ -72,12 +72,12 @@ Integration with Kata Containers (optional) ******************************************** `Kata Containers`_, is an open source project aiming to increase security -of containers by using a hardware-backed virtual machine container runtime, -rather than software namespace containers which are provided by the standard +of containers by using a hardware-backed virtual machine container runtime +rather than software namespace containers that are provided by the standard Docker *runc* runtime. Clear Linux provides easy integration of the *kata-runtime* with Docker. -More information on installing and using the *kata-runtime* can be found at :ref:`kata` +More information on installing and using the *kata-runtime* may be found at :ref:`kata`. .. note:: @@ -137,7 +137,7 @@ an the official Docker image for nginx, an open source reverse proxy server. .. note:: - Below is an explaination of switches used in the command above. For + Below is an explanation of switches used in the command above. For detailed :command:`docker run` switches and syntax, refer to the `Docker Documentation`_ . @@ -166,12 +166,12 @@ an the official Docker image for nginx, an open source reverse proxy server. sudo docker rm test-nginx Congratulations! At this point, you have successfully pulled a nginx -container image from `Docker Hub`_ and ran an example container. +container image from `Docker Hub`_ and have run an example container. Creating a Docker swarm cluster ******************************* -Clusters of Docker hosts are referred to as swarms. +Clusters of Docker hosts are referred to as *swarms*. The process in this tutorial can be repeated to install Docker on multiple Clear Linux hosts with the intent to form a Docker swarm cluster. @@ -187,16 +187,28 @@ Also see: * `Docker Hub`_ * `Kata Containers`_ -.. _`unique features`: https://clearlinux.org/features -.. _`Clear Linux image on Docker Hub`: https://hub.docker.com/_/clearlinux/ -.. _`building a custom Clear Linux docker image`: https://clearlinux.org/documentation/clear-linux/guides/network/custom-clear-container -.. _`Docker proxy instructions`: https://docs.docker.com/config/daemon/systemd/#httphttps-proxy -.. _`bundles`: https://clearlinux.org/documentation/clear-linux/concepts/bundles-about#related-concepts -.. _`stateless system`: https://clearlinux.org/features/stateless -.. _`Docker documentation on daemon configuration`: https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file -.. _`Kata Containers`: https://katacontainers.io/ -.. _`Docker Home`: https://www.docker.com/ -.. _`Docker Documentation`: https://docs.docker.com/ -.. _`Docker Hub`: https://hub.docker.com/ -.. _`Docker documentation on swarm key concepts`: https://docs.docker.com/engine/swarm/key-concepts/ -.. _`Docker documentation on creating a swarm`: https://docs.docker.com/engine/swarm/swarm-tutorial/create-swarm/ +.. _unique features: https://clearlinux.org/features + +.. _Clear Linux image on Docker Hub: https://hub.docker.com/_/clearlinux/ + +.. _building a custom Clear Linux docker image: https://clearlinux.org/documentation/clear-linux/guides/network/custom-clear-container + +.. _Docker proxy instructions: https://docs.docker.com/config/daemon/systemd/#httphttps-proxy + +.. _bundles: https://clearlinux.org/documentation/clear-linux/concepts/bundles-about#related-concepts + +.. _stateless system: https://clearlinux.org/features/stateless + +.. _Docker documentation on daemon configuration: https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-configuration-file + +.. _Kata Containers: https://katacontainers.io/ + +.. _Docker Home: https://www.docker.com/ + +.. _Docker Documentation: https://docs.docker.com/ + +.. _Docker Hub: https://hub.docker.com/ + +.. _Docker documentation on swarm key concepts: https://docs.docker.com/engine/swarm/key-concepts/ + +.. _Docker documentation on creating a swarm: https://docs.docker.com/engine/swarm/swarm-tutorial/create-swarm/