GitLab Runner offline nach Upgrade auf GitLab 17.5 ($HOME is not defined)

Sofern Ihre GitLab Runner nach dem Upgrade auf GitLab 17.5 (CE oder EE) als offline gekennzeichnet werden, ist eine Anpassung der Umgebungskonfiguration des GitLab-Services erforderlich, da die Umgebungsvariable $HOME nicht gefunden werden kann. Das Problem entsteht, da in dem von GitLab bereitgestellten Systemd Service eine nicht existierende Umgebungskonfigurationsdatei konfiguriert wird.

Auszug aus dem GitLab Systemd Service:

# [...]

Restart=always
RestartSec=120

EnvironmentFile=-/etc/sysconfig/gitlab-runner

# [...]

Fehlermeldung

journalctl -f -u gitlab-runner.service

gitlab-runner[1191]: FATAL: failed to get user home dir: $HOME is not defined
ystemd[1]: gitlab-runner.service: Main process exited, code=exited, status=1/FAILURE

Problembehebung

Sofern der Fehler bei Ihnen auftritt, ist folgende Anpassung auf dem GitLab-Runner via Shell erforderlich:

# Create sysconfig directory (if not exists)
mkdir -p /etc/sysconfig

# Define $HOME variable for gitlab-runner service
echo "HOME=/home/gitlab-runner" >> /etc/sysconfig/gitlab-runner

# Restart GitLab Runner Service
systemctl restart gitlab-runner

# Verify GitLab Runner Service Status
systemctl status gitlab-runner

Alternativ können Sie alle Befehle gleichzeitig ausführen:

mkdir -p /etc/sysconfig && \
echo "HOME=/home/gitlab-runner" >> /etc/sysconfig/gitlab-runner && \ 
systemctl restart gitlab-runner && \
systemctl status gitlab-runner

Der GitLab-Service wird anschließend wieder als active (running) gekennzeichnet:

Sollten Sie trotz Anpassung weiterhin Schwierigkeiten mit Ihrem GitLab-Runner haben, wenden Sie sich direkt an unseren Support, damit wir Sie schnellstmöglich bei der Problembehebung unterstützen können.

Quellen

Interesse an einem Managed GitLab-Hosting?

Migrieren Sie Ihre Self-Managed GitLab-Instanz mit unserem kostenlosen Umzugsservice zu unseren Managed GitLab-Server Lösungen. 14-Tage kostenlose Testversion verfügbar.