diff --git a/doc/src/nextlevel-ci/next-level-ci.rst b/doc/src/nextlevel-ci/next-level-ci.rst index bd58700..6975fc7 100644 --- a/doc/src/nextlevel-ci/next-level-ci.rst +++ b/doc/src/nextlevel-ci/next-level-ci.rst @@ -511,6 +511,62 @@ much the already heavily loaded HAC CI team. So the further documentation is done in :ref:`nwlCiCd` +GitLab CI/CD - Keep in mind +########################### +The documentation to install a GitLab CI Running is located in the +`know-how documentation `_ + +As a short summary see the instructions below (more details on +`GitLab `_): + +1. Make sure you have installed the docker engine on your build server: + + .. code-block:: bash + + # setup the repo: + server:~$ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg + + # select the stable repo: + server:~$ echo \ + "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian \ + $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null + + # install the engine: + server:~$ sudo apt update + server:~$ sudo apt install docker-ce docker-ce-cli containerd.io + +2. Install the runner on the build server: + + .. code-block:: bash + + # setup the repo: + server:~$ curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" | sudo bash + + # install the runner package: + server:~$ sudo apt-get install gitlab-runner + +3. Get the registration token from the GitLab CI/CD Settings page: + + * Go to `Settings >> CI/CD`, expand runners and **read the token** + +4. Register now the runner by replacing TOKEN with the read token of the previous step: + + .. code-block:: bash + + # Register the runner on the server: + sudo gitlab-runner register \ + -non-interactive \ + --registration-token TOKEN \ + --url https://gitlab.netmodule.intranet/ \ + --tls-ca-file /etc/ssl/certs/NetModule_AG_Root_CA.crt \ + --description "OEM-Linux1" \ + --executor "docker" \ + --docker-image docker:20 + +5. Launch your pipeline of a project + + + Sandbox Section ;-D ################### some links: