summaryrefslogtreecommitdiffstats
path: root/doc/book-enea-nfv-access-platform-guide/doc/container_virtualization.xml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/book-enea-nfv-access-platform-guide/doc/container_virtualization.xml')
-rw-r--r--doc/book-enea-nfv-access-platform-guide/doc/container_virtualization.xml26
1 files changed, 12 insertions, 14 deletions
diff --git a/doc/book-enea-nfv-access-platform-guide/doc/container_virtualization.xml b/doc/book-enea-nfv-access-platform-guide/doc/container_virtualization.xml
index c6ce223..055de7c 100644
--- a/doc/book-enea-nfv-access-platform-guide/doc/container_virtualization.xml
+++ b/doc/book-enea-nfv-access-platform-guide/doc/container_virtualization.xml
@@ -15,7 +15,7 @@
15 <para>The software container mechanism uses resource isolation features 15 <para>The software container mechanism uses resource isolation features
16 inside the Linux kernel, such as cgroups and kernel namespaces to allow 16 inside the Linux kernel, such as cgroups and kernel namespaces to allow
17 multiple containers to run within a single Linux instance, avoiding the 17 multiple containers to run within a single Linux instance, avoiding the
18 overhead of starting and maintaining virtual machines. </para> 18 overhead of starting and maintaining virtual machines.</para>
19 19
20 <para>Containers are lightweight and include everything needed to run 20 <para>Containers are lightweight and include everything needed to run
21 themselves: code, runtime, system tools, system libraries and settings. 21 themselves: code, runtime, system tools, system libraries and settings.
@@ -23,7 +23,7 @@
23 software is isolated from its surroundings. For example, differences 23 software is isolated from its surroundings. For example, differences
24 between development and staging environments can be kept separate in order 24 between development and staging environments can be kept separate in order
25 to reduce conflicts between teams running different software on the same 25 to reduce conflicts between teams running different software on the same
26 infrastructure. </para> 26 infrastructure.</para>
27 27
28 <para>For a better understanding of what Docker is and how it works, the 28 <para>For a better understanding of what Docker is and how it works, the
29 official documentation provided on the Docker website should be consulted: 29 official documentation provided on the Docker website should be consulted:
@@ -37,12 +37,10 @@
37 system is running the daemon correctly. This container can be launched 37 system is running the daemon correctly. This container can be launched
38 by simply running:</para> 38 by simply running:</para>
39 39
40 <programlisting>&gt;docker run hello-world 40 <programlisting>docker run hello-world</programlisting>
41 41
42Hello from Docker!</programlisting> 42 <para>If your installation is working correctly, the following message
43 43 should be outputted:<programlisting>Hello from Docker!</programlisting></para>
44 <para>This message shows that your installation appears to be working
45 correctly.</para>
46 </section> 44 </section>
47 45
48 <section id="run-enfv-guest-image"> 46 <section id="run-enfv-guest-image">
@@ -52,17 +50,17 @@ Hello from Docker!</programlisting>
52 other container can. Before starting an Enea NFV Access Platform guest 50 other container can. Before starting an Enea NFV Access Platform guest
53 image, a root filesystem has to be imported in Docker:</para> 51 image, a root filesystem has to be imported in Docker:</para>
54 52
55 <programlisting>&gt;docker import enea-linux-virtualization-guest-x86-64.tar.gz el7guest</programlisting> 53 <programlisting>docker import enea-linux-virtualization-guest-qemux86-64.tar.gz el7guest</programlisting>
56 54
57 <para>To check that the Docker image has been imported successfully, 55 <para>To check that the Docker image has been imported successfully,
58 run:</para> 56 run:</para>
59 57
60 <programlisting>&gt;docker images</programlisting> 58 <programlisting>docker images</programlisting>
61 59
62 <para>Finally, start an Enea NFV Access Platform container with 60 <para>Finally, start an Enea NFV Access Platform container with
63 <literal>bash</literal> running as the shell, by running:</para> 61 <literal>bash</literal> running as the shell, by running:</para>
64 62
65 <programlisting>&gt;docker run -it el7guest /bin/bash</programlisting> 63 <programlisting>docker run -it el7guest /bin/bash</programlisting>
66 </section> 64 </section>
67 65
68 <section id="attach-ext-resources-docker-containers"> 66 <section id="attach-ext-resources-docker-containers">
@@ -77,7 +75,7 @@ Hello from Docker!</programlisting>
77 <literal>roots</literal> home folder to a container, the command line 75 <literal>roots</literal> home folder to a container, the command line
78 for Docker should have the following format:</para> 76 for Docker should have the following format:</para>
79 77
80 <programlisting>&gt;docker run -it -v /home/root:/home/host_root/ el7guest /bin/bash</programlisting> 78 <programlisting>docker run -it -v /home/root:/home/host_root/ el7guest /bin/bash</programlisting>
81 79
82 <para>To check that folders have been properly passed from the host to 80 <para>To check that folders have been properly passed from the host to
83 the container, create a file in the source folder on the host root 81 the container, create a file in the source folder on the host root
@@ -103,7 +101,7 @@ Hello from Docker!</programlisting>
103 <para>Mapping a file descriptor is done in a similar way, but the 101 <para>Mapping a file descriptor is done in a similar way, but the
104 <literal>-v</literal> flag needs to point directly to it:</para> 102 <literal>-v</literal> flag needs to point directly to it:</para>
105 103
106 <programlisting>&gt;docker run -it --rm -v /var/run/openvswitch/vhost-user1 el7guest /bin/bash</programlisting> 104 <programlisting>docker run -it --rm -v /var/run/openvswitch/vhost-user1 el7guest /bin/bash</programlisting>
107 </listitem> 105 </listitem>
108 </itemizedlist> 106 </itemizedlist>
109 </section> 107 </section>
@@ -118,7 +116,7 @@ Hello from Docker!</programlisting>
118 <literal>/mnt/huge</literal> location, a container can also access 116 <literal>/mnt/huge</literal> location, a container can also access
119 hugepages by being launched with:</para> 117 hugepages by being launched with:</para>
120 118
121 <programlisting>&gt;docker run -it -v /mnt/huge el7guest /bin/bash</programlisting> 119 <programlisting>docker run -it -v /mnt/huge el7guest /bin/bash</programlisting>
122 </section> 120 </section>
123 121
124 <section id="access-pci-bus"> 122 <section id="access-pci-bus">
@@ -131,7 +129,7 @@ Hello from Docker!</programlisting>
131 container if the <literal>--privileged</literal> flag is passed to the 129 container if the <literal>--privileged</literal> flag is passed to the
132 command line:</para> 130 command line:</para>
133 131
134 <programlisting>&gt;docker run --privileged -it el7guest /bin/bash</programlisting> 132 <programlisting>docker run --privileged -it el7guest /bin/bash</programlisting>
135 </section> 133 </section>
136 </section> 134 </section>
137 </section> 135 </section>