GitLab: Runner (Windows)

Install GitLab-Runner on Windows as a Windows service

• Create a folder somewhere in your system, ex.: C:\GitLab-Runner.
• Download the binary and put it into the folder you created. Rename the binary to gitlab-runner.exe.
• Run an elevated command prompt.
• Install the Runner as a service and start it. You can either run the service using the Built-in System Account (recommended) or using a user account.
  • Run service using Built-in System Account:

.\gitlab-runner.exe install
.\gitlab-runner.exe start

• Run service using user account:

.\gitlab-runner.exe install --user <ENTER-YOUR-USERNAME> --password <ENTER-YOUR-PASSWORD>
.\gitlab-runner.exe start

• (Optional) Update Runners concurrent value in C:\GitLab-Runner\config.toml to allow multiple concurrent jobs as detailed in advanced configuration details. Additionally you can use the advanced configuration details to update your shell executor to use Bash or PowerShell rather than Batch.

Voila! Runner is installed, running, and will start again after each system reboot. Logs are stored in Windows Event Log More informations: https://docs.gitlab.com/runner/install/windows.html

GitLab Runner behind a proxy

• Add your proxy server in the GitLab Runner configuration "config.toml" (for example):

concurrent = 8
check_interval = 0
log_level = "warning"

[session_server]
	session_timeout = 1800

runners
	name = "<FQDN>"
	executor = "shell"
	shell = "powershell"
	environment = ["HTTP_PROXY=<your_Proxy_if_needed>","HTTPS_PROXY=<your_Proxy_if_needed>"]
	url = "https://<your_GitLab>/"
	token = "<your_token_from_registering_the_runner>"
	tls_verify = false

• Add the following Registry-Key to force the GitLab-Runner service to use the proxy:

New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Services\gitlab-runner\" -Name "Environment" -Value "HTTPS_PROXY=server-proxy.xaas.swissic.ch:8080" -PropertyType MultiString