diff options
-rw-r--r-- | doc/book-enea-nfv-access-guide-intel/doc/container_virtualization.xml | 29 |
1 files changed, 15 insertions, 14 deletions
diff --git a/doc/book-enea-nfv-access-guide-intel/doc/container_virtualization.xml b/doc/book-enea-nfv-access-guide-intel/doc/container_virtualization.xml index 2287146..06bfbb4 100644 --- a/doc/book-enea-nfv-access-guide-intel/doc/container_virtualization.xml +++ b/doc/book-enea-nfv-access-guide-intel/doc/container_virtualization.xml | |||
@@ -44,23 +44,24 @@ | |||
44 | </section> | 44 | </section> |
45 | 45 | ||
46 | <section id="run-enfv-guest-image"> | 46 | <section id="run-enfv-guest-image"> |
47 | <title>Run an Enea NFV Access guest image</title> | 47 | <title>Run a guest image inside Docker</title> |
48 | 48 | ||
49 | <para>Enea NFV Access guest images can run inside Docker as any other | 49 | <para>Guest images can be run inside Docker as in any other container. |
50 | container can. Before starting an Enea NFV Access guest image, a root | 50 | You can find an example below of how to configure and run a guest image. |
51 | filesystem has to be imported in Docker:</para> | 51 | Before starting a guest image, a root filesystem has to be imported in |
52 | Docker:</para> | ||
52 | 53 | ||
53 | <programlisting>docker import enea-nfv-access-guest-qemux86-64.tar.gz el7guest</programlisting> | 54 | <programlisting>docker import guest-qemux86-64.tar.gz guest</programlisting> |
54 | 55 | ||
55 | <para>To check that the Docker image has been imported successfully, | 56 | <para>To check that the Docker image has been imported successfully, |
56 | run:</para> | 57 | run:</para> |
57 | 58 | ||
58 | <programlisting>docker images</programlisting> | 59 | <programlisting>docker images</programlisting> |
59 | 60 | ||
60 | <para>Finally, start an Enea NFV Access container with | 61 | <para>Finally, start a container with <literal>bash</literal> running as |
61 | <literal>bash</literal> running as the shell, by running:</para> | 62 | the shell, by running:</para> |
62 | 63 | ||
63 | <programlisting>docker run -it el7guest /bin/bash</programlisting> | 64 | <programlisting>docker run -it guest /bin/bash</programlisting> |
64 | </section> | 65 | </section> |
65 | 66 | ||
66 | <section id="attach-ext-resources-docker-containers"> | 67 | <section id="attach-ext-resources-docker-containers"> |
@@ -75,7 +76,7 @@ | |||
75 | <literal>roots</literal> home folder to a container, the command line | 76 | <literal>roots</literal> home folder to a container, the command line |
76 | for Docker should have the following format:</para> | 77 | for Docker should have the following format:</para> |
77 | 78 | ||
78 | <programlisting>docker run -it -v /home/root:/home/host_root/ el7guest /bin/bash</programlisting> | 79 | <programlisting>docker run -it -v /home/root:/home/host_root/ guest /bin/bash</programlisting> |
79 | 80 | ||
80 | <para>To check that folders have been properly passed from the host to | 81 | <para>To check that folders have been properly passed from the host to |
81 | the container, create a file in the source folder on the host root | 82 | the container, create a file in the source folder on the host root |
@@ -94,14 +95,14 @@ | |||
94 | <listitem> | 95 | <listitem> |
95 | <para>Mapping the folder can be done as exemplified above:</para> | 96 | <para>Mapping the folder can be done as exemplified above:</para> |
96 | 97 | ||
97 | <programlisting>docker run -it --rm -v /var/run/openvswitch/:/var/run/openvswitch/ el7guest /bin/bash</programlisting> | 98 | <programlisting>docker run -it --rm -v /var/run/openvswitch/:/var/run/openvswitch/ guest /bin/bash</programlisting> |
98 | </listitem> | 99 | </listitem> |
99 | 100 | ||
100 | <listitem> | 101 | <listitem> |
101 | <para>Mapping a file descriptor is done in a similar way, but the | 102 | <para>Mapping a file descriptor is done in a similar way, but the |
102 | <literal>-v</literal> flag needs to point directly to it:</para> | 103 | <literal>-v</literal> flag needs to point directly to it:</para> |
103 | 104 | ||
104 | <programlisting>docker run -it --rm -v /var/run/openvswitch/vhost-user1 el7guest /bin/bash</programlisting> | 105 | <programlisting>docker run -it --rm -v /var/run/openvswitch/vhost-user1 guest /bin/bash</programlisting> |
105 | </listitem> | 106 | </listitem> |
106 | </itemizedlist> | 107 | </itemizedlist> |
107 | </section> | 108 | </section> |
@@ -116,7 +117,7 @@ | |||
116 | <literal>/mnt/huge</literal> location, a container can also access | 117 | <literal>/mnt/huge</literal> location, a container can also access |
117 | hugepages by being launched with:</para> | 118 | hugepages by being launched with:</para> |
118 | 119 | ||
119 | <programlisting>docker run -it -v /mnt/huge el7guest /bin/bash</programlisting> | 120 | <programlisting>docker run -it -v /mnt/huge guest /bin/bash</programlisting> |
120 | </section> | 121 | </section> |
121 | 122 | ||
122 | <section id="access-pci-bus"> | 123 | <section id="access-pci-bus"> |
@@ -129,8 +130,8 @@ | |||
129 | container if the <literal>--privileged</literal> flag is passed to the | 130 | container if the <literal>--privileged</literal> flag is passed to the |
130 | command line:</para> | 131 | command line:</para> |
131 | 132 | ||
132 | <programlisting>docker run --privileged -it el7guest /bin/bash</programlisting> | 133 | <programlisting>docker run --privileged -it guest /bin/bash</programlisting> |
133 | </section> | 134 | </section> |
134 | </section> | 135 | </section> |
135 | </section> | 136 | </section> |
136 | </chapter> \ No newline at end of file | 137 | </chapter> |