/ ‘README.md’

/ ‘gitlab-runner_config_example/shell/etc/gitlab-runner/config.toml’

README.md

@@ -5,3 +5,4 @@
 - utilizing 'SparkleShare' for real-time sync.
 - CI powered by server-side gitlab-runner !
 - themes are ALL pre-download and located at specific location in the server: /home/admin/pelican-themes/
+- look inside 'gitlab-runner_config_example' for the server-side configuration tips.

gitlab-runner_config_example/docker/etc/gitlab-runner/config.toml

@@ -2,10 +2,13 @@
 # and THEN, add more options & modify options..
 # because the registration must be done explicitly from commnadline.. to get A_GENERATED_TOKEN.
 
+# https://docs.gitlab.com/runner/commands/README.html#gitlab-runner-register
+# https://docs.gitlab.com/runner/configuration/advanced-configuration.html
+
 # example setup running CI @ docker
 # with this, every commit will refresh whole python packages.. will take 1 min. ==> slow. but up to date all the time..
 
-concurrent = 2
+concurrent = 2 # this should be > 0
 check_interval = 0
 
 [session_server]
@@ -25,8 +28,9 @@ check_interval = 0
     oom_kill_disable = false
     disable_cache = false
     volumes = ["/home/admin/pelican-themes/:/themes", "/var/www/webapp_doohoyi/nosignal.hopto.org_site/ci:/site-public:rw"]
+    # above is important, --> https://stackoverflow.com/a/38099850
     shm_size = 0
-    network_mode = "host"
+    network_mode = "host" # check your network name with 'docker network ls' --> https://stackoverflow.com/a/50461875
   [runners.cache]
     [runners.cache.s3]
     [runners.cache.gcs]

gitlab-runner_config_example/shell/.gitlab-ci.yml

@@ -0,0 +1,10 @@
+build:
+  script:
+    - pip install -r requirements.txt
+    - PATH=$PATH:~/.local/bin
+    - make publish
+    - rm -rf /var/www/webapp_doohoyi/nosignal.hopto.org_site/ci/pelican
+    - cp -r public /var/www/webapp_doohoyi/nosignal.hopto.org_site/ci/pelican
+  artifacts:
+    paths:
+    - public

gitlab-runner_config_example/shell/etc/gitlab-runner/config.toml

@@ -1,8 +1,15 @@
+# FIRST, generate a [[runners]] block using command 'sudo gitlab-runner register'
+# and THEN, add more options & modify options..
+# because the registration must be done explicitly from commnadline.. to get A_GENERATED_TOKEN.
+
+# https://docs.gitlab.com/runner/commands/README.html#gitlab-runner-register
+# https://docs.gitlab.com/runner/configuration/advanced-configuration.html
+
 # simple setup running CI @ localhost
 # this means you need to manage python3 repos @ localhost by yourself!
 # but this builds really fast, because no image fetch/ no update packages, just make !
 
-concurrent = 2
+concurrent = 2 # this should be > 0
 check_interval = 0
 
 [session_server]