For a first simple setup, we rely on an interactive gitlab runner setup. Issues related to service-based runners are described below.
The scripts are located in a new gitlab
folder.
You can skip tests by including the string [skip-tests]
in the commit message.
Documentation:
- Installation : https://docs.gitlab.com/runner/install/windows.html
- Runner commands : https://docs.gitlab.com/runner/commands/
Installation steps:
- Install a gitlab runner in a folder of your choice. For this tutorial we'll use
d:\gitlab_runner
. - Run a terminal as administrator, create folder
d:\gitlab_runner\working_dir
and place yourself into it in your terminal - Register a runner with
gitlab-runner-windows-amd64.exe register
. Usehttps://gitlab-ncsa.ubisoft.org/
as URL,3doSyUPxsy5hL-svi_Qu
as token,blender
as tags,shell
as executor. The token can be found in Settings -> CI/CD page of this repository. This step should create a fileconfig.toml
ind:\gitlab_runner\working_dir
. - Edit
d:\gitlab_runner\working_dir
and add an entrycache_dir = "D:/gitlab_runner/cache"
in the[[runners]]
section, after theshell
entry.
Then run an interactive : gitlab-runner-windows-amd64.exe run
. It must run as administrator because the TSCON
command requires administrator rights to disconnect a session from the remote desktop.
As the runner executes jobs, it will display the jobs status :
D:\gitlab_runner>gitlab-runner-windows-amd64.exe run
Runtime platform arch=amd64 os=windows pid=19628 revision=4c96e5ad version=12.9.0
Starting multi-runner from D:\gitlab_runner\config.toml... builds=0
Configuration loaded builds=0
listen_address not defined, metrics & debug endpoints disabled builds=0
[session_server].listen_address not defined, session endpoints disabled builds=0
Checking for jobs... received job=11132741 repo_url=https://gitlab-ncsa.ubisoft.org/animation-studio/blender/mixer.git runner=Q-sQ1rhN
Job succeeded duration=5m3.2796891s job=11132741 project=39094 runner=Q-sQ1rhN
Checking for jobs... received job=11132866 repo_url=https://gitlab-ncsa.ubisoft.org/animation-studio/blender/mixer.git runner=Q-sQ1rhN
WARNING: Job failed: exit status 1 duration=5m8.5314355s job=11132866 project=39094 runner=Q-sQ1rhN
WARNING: Failed to process runner builds=0 error=exit status 1 executor=shell runner=Q-sQ1rhN
The builds for the runner will be put in the current working directory d:\gitlab_runner\working_dir
where you started the runner.
Using a system service could be difficult because the user profile may not be easy to access and we also need the service to access to the desktop.
Using a service that logons with a user account requires a user account that can logon as a service as described in https://docs.gitlab.com/runner/faq/README.html#the-service-did-not-start-due-to-a-logon-failure-error-when-starting-service.