Configuring ci-runners

Ci-runners such as Github, Gitlab and Bitbucket runners can be installed under the /ci-runners directory. Below you find the necessary steps in order to install a ci-runner. As example we will refer to a Github ci-runner for the account test.

Steps

1. Connect to the server using SSH

2. Go to the directory /ci-runners, this directory has the correct permissions to create a ci-runner.

   cd /ci-runners
   

3. Create a directory for your runner under /ci-runners and navigate into it. As naming convention we recommend using: <account>-<ci-runner>

   mkdir test-github-runner; cd test-github-runner
   

4. Install your desired ci-runner in this directory.

   Note

   The code below might mention an outdated version, be sure to check your github page to install the desired version.

   Check release notes.

   # Download the latest runner package
   curl -o actions-runner-linux-x64-2.322.0.tar.gz -L https://github.com/actions/runner/releases/download/v2.322.0/actions-runner-linux-x64-2.322.0.tar.gz
   
   # Optional: Validate the hash
   echo "b13b784808359f31bc79b08a191f5f83757852957dd8fe3dbfcc38202ccf5768  actions-runner-linux-x64-2.322.0.tar.gz" | shasum -a 256 -c
   
   # Extract the installer
   tar xzf ./actions-runner-linux-x64-2.322.0.tar.gz
   
   # Create the runner and start the configuration experience
   ./config.sh --url XXX --token XXX
   
   # Last step, run it!
   ./run.sh