Categories
DevOps

How to install GitLab runner on Raspberry Pi

Install GitLab runner on Raspberry Pi.

I will use previous LXD setup on Raspberry Pi 4 with DietPi operating system.

Get the registration token

Determine the registration token.

Create LXD instance

I am using Raspberry Pi 4 with DietPi operating system, aarch64 architecture.

$ uname -a
Linux DietPi 5.10.63-v8+ #1459 SMP PREEMPT Wed Oct 6 16:42:49 BST 2021 aarch64 GNU/Linux

Search for Ubuntu 20.04.3 LTS (Focal Fossa) image.

$ sudo -i lxc image list images: architecture=arm64 os=Ubuntu release=focal
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+
|            ALIAS            | FINGERPRINT  | PUBLIC |             DESCRIPTION             | ARCHITECTURE |      TYPE       |   SIZE   |          UPLOAD DATE          |
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+
| ubuntu/focal (7 more)       | 4d05260235b7 | yes    | Ubuntu focal arm64 (20211114_08:44) | aarch64      | CONTAINER       | 97.76MB  | Nov 14, 2021 at 12:00am (UTC) |
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+
| ubuntu/focal (7 more)       | 7664234ba371 | yes    | Ubuntu focal arm64 (20211114_08:44) | aarch64      | VIRTUAL-MACHINE | 239.38MB | Nov 14, 2021 at 12:00am (UTC) |
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+
| ubuntu/focal/cloud (3 more) | b34bd4e8a06c | yes    | Ubuntu focal arm64 (20211114_08:44) | aarch64      | VIRTUAL-MACHINE | 262.69MB | Nov 14, 2021 at 12:00am (UTC) |
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+
| ubuntu/focal/cloud (3 more) | fbea3bbeffa9 | yes    | Ubuntu focal arm64 (20211114_08:44) | aarch64      | CONTAINER       | 112.38MB | Nov 14, 2021 at 12:00am (UTC) |
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+
|                             | 0e6724185d46 | yes    | Ubuntu focal arm64 (20211113_07:42) | aarch64      | CONTAINER       | 101.32MB | Nov 13, 2021 at 12:00am (UTC) |
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+
|                             | 1ef2f2f42455 | yes    | Ubuntu focal arm64 (20211112_07:42) | aarch64      | VIRTUAL-MACHINE | 239.31MB | Nov 12, 2021 at 12:00am (UTC) |
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+
|                             | 01e2c1616e4a | yes    | Ubuntu focal arm64 (20211113_07:42) | aarch64      | VIRTUAL-MACHINE | 239.31MB | Nov 13, 2021 at 12:00am (UTC) |
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+
|                             | 4cc95e7aecd7 | yes    | Ubuntu focal arm64 (20211112_07:42) | aarch64      | CONTAINER       | 112.38MB | Nov 12, 2021 at 12:00am (UTC) |
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+
|                             | 8b17689d7ff1 | yes    | Ubuntu focal arm64 (20211112_07:42) | aarch64      | VIRTUAL-MACHINE | 262.38MB | Nov 12, 2021 at 12:00am (UTC) |
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+
|                             | 9bbf2a08a5fb | yes    | Ubuntu focal arm64 (20211113_07:42) | aarch64      | CONTAINER       | 97.76MB  | Nov 13, 2021 at 12:00am (UTC) |
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+
|                             | 44df16720440 | yes    | Ubuntu focal arm64 (20211112_07:42) | aarch64      | CONTAINER       | 88.65MB  | Nov 12, 2021 at 12:00am (UTC) |
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+
|                             | 47c2afda0b28 | yes    | Ubuntu focal arm64 (20211113_07:42) | aarch64      | CONTAINER       | 88.73MB  | Nov 13, 2021 at 12:00am (UTC) |
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+
|                             | 48ce6843b5c4 | yes    | Ubuntu focal arm64 (20211114_08:44) | aarch64      | CONTAINER       | 100.71MB | Nov 14, 2021 at 12:00am (UTC) |
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+
|                             | 04288b617a5b | yes    | Ubuntu focal arm64 (20211113_07:42) | aarch64      | VIRTUAL-MACHINE | 262.56MB | Nov 13, 2021 at 12:00am (UTC) |
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+
|                             | 7141a7f194ce | yes    | Ubuntu focal arm64 (20211112_07:42) | aarch64      | CONTAINER       | 101.64MB | Nov 12, 2021 at 12:00am (UTC) |
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+
|                             | 12151b6307fb | yes    | Ubuntu focal arm64 (20211113_07:42) | aarch64      | CONTAINER       | 112.37MB | Nov 13, 2021 at 12:00am (UTC) |
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+
|                             | c5a43ce69ea8 | yes    | Ubuntu focal arm64 (20211114_08:44) | aarch64      | CONTAINER       | 89.29MB  | Nov 14, 2021 at 12:00am (UTC) |
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+
|                             | d5473410cfe5 | yes    | Ubuntu focal arm64 (20211112_07:42) | aarch64      | CONTAINER       | 97.76MB  | Nov 12, 2021 at 12:00am (UTC) |
+-----------------------------+--------------+--------+-------------------------------------+--------------+-----------------+----------+-------------------------------+

Inspect image.

$ sudo -i lxc image info images:ubuntu/focal
Fingerprint: 4d05260235b770941e1b4eb59cf039810d3cd651a4425a5451cb5b45328bd2ae
Size: 97.76MB
Architecture: aarch64
Type: container
Public: yes
Timestamps:
    Created: 2021/11/14 00:00 UTC
    Uploaded: 2021/11/14 00:00 UTC
    Expires: never
    Last used: never
Properties:
    os: Ubuntu
    release: focal
    architecture: arm64
    description: Ubuntu focal arm64 (20211114_08:44)
    variant: default
    serial: 20211114_08:44
    type: squashfs
Aliases:
    - ubuntu/focal/default
    - ubuntu/focal/default/arm64
    - ubuntu/20.04/default
    - ubuntu/20.04/default/arm64
    - ubuntu/focal
    - ubuntu/focal/arm64
    - ubuntu/20.04
    - ubuntu/20.04/arm64
Cached: no
Auto update: disabled
Profiles: []

Copy this image.

$ sudo -i lxc image copy images:ubuntu/focal/arm64 local:
Image copied successfully!      

Create an alias.

$ sudo -i lxc image alias create local:ubuntu/focal 4d05260235b7

Display local images.

$ sudo -i lxc image list
+--------------+--------------+--------+--------------------------------------+--------------+-----------+---------+------------------------------+
|    ALIAS     | FINGERPRINT  | PUBLIC |             DESCRIPTION              | ARCHITECTURE |   TYPE    |  SIZE   |         UPLOAD DATE          |
+--------------+--------------+--------+--------------------------------------+--------------+-----------+---------+------------------------------+
| ubuntu/focal | 4d05260235b7 | no     | Ubuntu focal arm64 (20211114_08:44)  | aarch64      | CONTAINER | 97.76MB | Nov 14, 2021 at 4:26pm (UTC) |
+--------------+--------------+--------+--------------------------------------+--------------+-----------+---------+------------------------------+

Create gitlab-runner instance.

$ sudo -i lxc launch local:ubuntu/focal gitlab-runner
Creating gitlab-runner
Starting gitlab-runner

Define memory limit.

$ sudo -i lxc config set gitlab-runner-ssh limits.memory 1024MB

Set cpu limit.

$ sudo -i lxc config set gitlab-runner-ssh limits.cpu 1

Install GitLab runner application

Do not use official repository as it provides outdated GitLab runner.

Enter gitlab-runner instance.

$ sudo -i lxc exec gitlab-runner bash
root@gitlab-runner:~#

Install packages required to download an application.

root@gitlab-runner:~# apt install curl

Downlad an application.

root@gitlab-runner:~# curl -L --output /usr/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-arm64

Inspect downladed file.

root@gitlab-runner:~# ls -l /usr/bin/gitlab-runner
-rw-r--r-- 1 root root 53884871 Nov 21 22:36 /usr/bin/gitlab-runner

Ensure that executable bit is set.

root@gitlab-runner:~# chmod +x /usr/bin/gitlab-runner

Add gitlab-runner group.

root@gitlab-runner:~# groupadd --gid 2000 gitlab-runner

Add gitlab-runner user.

root@gitlab-runner:~# useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash --uid 2000 --gid 2000

Inspect created user.

root@gitlab-runner:~# id gitlab-runner
uid=2000(gitlab-runner) gid=2000(gitlab-runner) groups=2000(gitlab-runner)

Setup runner service.

root@gitlab-runner:~# gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner

Start service.

root@gitlab-runner:~# gitlab-runner start

I am using a self signed certificate, so create a dedicated directory to store it.

root@gitlab-runner:~# mkdir /etc/gitlab-runner/certificates

Store server certificate.

root@gitlab-runner:~# echo | openssl s_client -servername git.octocat.lab -connect git.octocat.lab:443 2>/dev/null | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' | tee /etc/gitlab-runner/certificates/git.octocat.lab.pem

Configure runner using shell provider

Register a GitLab runner.

root@gitlab-runner-ssh:~# gitlab-runner register --name "Local SSH runner" --tls-ca-file /etc/gitlab-runner/certificates/git.octocat.lab.pem --executor shell --shell bash --url https://git.octocat.lab/ --registration-token aSRFKnhdLhgARLjo1MAC --tag-list "ssh,local" --non-interactive

Configure runner using docker provider

Install Docker.

root@gitlab-runner-docker:~# apt-get install docker.io
Reading package lists... Done
Building dependency tree       
Reading state information... Done
The following additional packages will be installed:
  apparmor bridge-utils containerd dns-root-data dnsmasq-base git git-man iptables libcurl3-gnutls liberror-perl libgdbm-compat4 libgdbm6 libidn11 libip6tc2 libnetfilter-conntrack3 libnfnetlink0
  libnftnl11 libperl5.30 patch perl perl-modules-5.30 pigz runc ubuntu-fan
Suggested packages:
  apparmor-profiles-extra apparmor-utils ifupdown aufs-tools btrfs-progs cgroupfs-mount | cgroup-lite debootstrap docker-doc rinse zfs-fuse | zfsutils gettext-base git-daemon-run
  | git-daemon-sysvinit git-doc git-el git-email git-gui gitk gitweb git-cvs git-mediawiki git-svn firewalld nftables gdbm-l10n ed diffutils-doc perl-doc libterm-readline-gnu-perl
  | libterm-readline-perl-perl make libb-debug-perl liblocale-codes-perl
The following NEW packages will be installed:
  apparmor bridge-utils containerd dns-root-data dnsmasq-base docker.io git git-man iptables libcurl3-gnutls liberror-perl libgdbm-compat4 libgdbm6 libidn11 libip6tc2 libnetfilter-conntrack3
  libnfnetlink0 libnftnl11 libperl5.30 patch perl perl-modules-5.30 pigz runc ubuntu-fan
0 upgraded, 25 newly installed, 0 to remove and 10 not upgraded.
Need to get 69.5 MB of archives.
After this operation, 396 MB of additional disk space will be used.
[...]

Verify Docker installation.

root@gitlab-runner-docker:~# docker run hello-world
Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
93288797bd35: Pull complete 
Digest: sha256:cc15c5b292d8525effc0f89cb299f1804f3a725c8d05e158653a563f15e4f685
Status: Downloaded newer image for hello-world:latest

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
    (arm64v8)
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
 $ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker ID:
 https://hub.docker.com/

For more examples and ideas, visit:
 https://docs.docker.com/get-started/

Register a GitLab runner.

root@gitlab-runner-ssh:~# gitlab-runner register --name "Local Docker runner" --tls-ca-file /etc/gitlab-runner/certificates/git.octocat.lab.pem --executor docker --docker-image debian:bullseye --url https://git.octocat.lab/ --registration-token aSRFKnhdLhgARLjo1MAC --tag-list "docker,local" --run-untagged --non-interactive

Verify registered runners

Use GitLab admin area to verify configured runners.

That is all!