Skip to content

Commit e9e8b61

Browse files
committed
Add container documentation
Signed-off-by: Sergiu Weisz <sergiu121@gmail.com>
1 parent d28b427 commit e9e8b61

File tree

1 file changed

+41
-0
lines changed

1 file changed

+41
-0
lines changed

Documentation/teaching/info/extra-vm.rst

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -123,3 +123,44 @@ or simply starting the virtual machine
123123
.. code-block:: shell
124124
125125
~/src/linux/tools/labs$ make boot
126+
127+
Using Docker containers
128+
-----------------------
129+
130+
If your setup doesn't allow the installation of the packages required for the
131+
laboratory setup, you can build and run a container that has all the setup
132+
already prepared for the virtual machine environment.
133+
134+
In order to run the containerized setup, you need to install the following
135+
packages:
136+
137+
* ``docker``
138+
* ``docker-compose``
139+
140+
In order to run the container infrastructure run the following command in the
141+
``tools/labs/`` directory:
142+
143+
.. code-block::
144+
145+
make docker-kernel
146+
...
147+
ubuntu@so2:~$
148+
149+
The first time you run the command above, it will take a long time, because you
150+
will have to build the container environment and install the required
151+
applications.
152+
153+
Every time you run the ``make docker-kernel`` command, another shell will
154+
connect to the container. This will allow you to work with multiple tabs.
155+
156+
All the commands that you would use in the regular environment can be used in
157+
the containerized environment.
158+
159+
The linux repository is mounted in the ``/linux`` directory. All changes
160+
you will make here will also be seen on your local instance.
161+
162+
In order to stop the container use the following command:
163+
164+
.. code-block::
165+
166+
make stop-docker-kernel

0 commit comments

Comments
 (0)