# Deploy runners

This repo aims at helping registering and running gitlab-ci-runners. It will 
use current hostname and user as tag for the registred runner and only run it
on this machine.

# Fresh start

Before being run, runners has to be registered. This have to be done once. 
In order to do that, a registration token specific to the gitlab's
project. It can be found in the "Settings > CI/CD" section in the gitlab web
interface (**important note: you have to be Master or Owner of the project to
access this information**).

To do so use the "register" script. It takes the token as argument. As default
it tags the registred runner as the current hostname and machine and uses the 
gitlab url "dci-gitlab.cines.fr". Then use the "run" script to launch the runners by invoking the hangups immune **nohup** utility. It takes the project name as arguments.

Example:
```shell
#You will need a python, if not in PATH
module load cray-python
./register $token project-name-$runner_number # runner_number=1
nohup ./run project-name-$runner_number >& project-name-$runner_number.log &
```
**Reminder:** Do not forget to tag this new runner with the keyword that corresponds to the default tag of the project where you want to use this runner