From 774d779f37703cd6a3d351f456d1021d8b8afe1c Mon Sep 17 00:00:00 2001
From: Samuel Gaist <samuel.gaist@idiap.ch>
Date: Wed, 17 Mar 2021 09:52:44 +0100
Subject: [PATCH] [doc][linux] Add missing informations
- gitlab-runner user setup to use Docker
- beat/beat.editor> missing dependencies
---
doc/linux.rst | 22 ++++++++++++++++++----
1 file changed, 18 insertions(+), 4 deletions(-)
diff --git a/doc/linux.rst b/doc/linux.rst
index 598100d0..645448fe 100644
--- a/doc/linux.rst
+++ b/doc/linux.rst
@@ -36,11 +36,11 @@ change ``/etc/default/grub`` to contain the line
``GRUB_CMDLINE_LINUX="cgroup_enable=memory swapaccount=1"``. Then, re-run
``update-grub`` after such change.
-To install docker at Idiap, you also need to follow the security guidelines
+To install docker at Idiap, you also need to follow the security guidelines.
-do not follow such guidelines, the machine will not be acessible from outside
-via the login gateway, as the default docker installation conflicts with
-Idiap's internal setup. You may also find other network connectivity issues.
+If you do not follow these guidelines, the machine will not be accessible from
+outside via the login gateway, as the default docker installation conflicts with
+Idiap's internal setup. You may also find other network connectivity issues.
Also, you want to place ``/var/lib/docker`` on a **fast** disk. Normally, we
have a scratch partition for this. Follow the instructions at
@@ -149,6 +149,15 @@ the values of ``<internal.ipv4.address>`` and ``<token>`` on the template below)
$ chown gitlab-runner:gitlab-runner /scratch/cache
+Once the configuration is done, add the gitlab-runner user to the docker group
+so it can do tasks related to Docker (images pulling, python client call,
+etc.)::
+
+.. code-block:: sh
+
+ $ usermod -a -G docker gitlab-runner
+
+
Access to Idiap's docker registry
=================================
@@ -236,6 +245,11 @@ Extra packages
List of extra packages to ensure are installed on the shell environment:
* rsync
+* libgl1
+
+libgl1 is required to run the beat/beat.editor> tests. While the offscreen
+plugin is used and therefor no X11 server is required, the libraries still needs
+the OpenGL symbols.
Locale
--
GitLab