Commit 4f792967 authored by Florian Hindenlang's avatar Florian Hindenlang
Browse files

update readme [CI skip]

parent 4cf81a41
Pipeline #12066 skipped
......@@ -15,25 +15,27 @@ Important things:
- Installation of a local runner [found here](https://docs.gitlab.com/runner/install/) be sure to install the version <= 1.11.4
`sudo apt-get install gitlab-ci-multi-runner=1.11.4`
since the mpcdf gitlab version is 8.17
- After installation of the runner, execute **in your home directory**
gitlab-runner register
- After installation of the runner, execute **in your home directory**
`gitlab-runner register`
follow the steps with the url and token given on the `Settings->CI/CD pipeline` of your project on the gitlab page
- then start the runner
gitlab-runner run
- then start the runner
`gitlab-runner run`
You should see the runner on the gitlab page `Settings->CI/CD pipeline`
## Tags:
Tags only make sense if there are multiple runners.
They allow to choose on which runner the job will be executed.
A tag or a list of tags allows to choose on which runner the job will be executed.
If the runner can run untagged jobs, you would not need tags, but we recommend to use at least one tag for the job, corresponding to the tag(s) of the runner.
The use of tags is recommended, use at least one tag for the job, corresponding to the tag(s) of the runner.
The tags are used to select a specific runner. Note the following:
1. Each job is assigned to only **one** runner!
Note the following:
1. Each job is assigned to only **one** runner! If you want to execute the same job on another runner,
you have to copy the job and change the tag!
1. If job has no tag
- one runner must be configured to run untagged jobs
- one runner must be configured to run untagged jobs, else the job cannot be executed
1. Job has tags
- **all** tags of a job **must match** a subset of the tags of **one** runner
- **all** tags of a job **must match a subset** of the tags of **one** runner
**Careful**, different runners should not have the same tag!
Each job can have one or multiple tags, here an example:
```
......@@ -46,12 +48,11 @@ job_2:
tags:
- tag1_runnerB
job_3:
stage: build
stage: test
tags:
- tag1_runnerA
- tag2_runnerA
```
- runner A has the tags `tag1_runnerA` and `tag2_runnerA` ... and therefore runs `job_1` and `job_3`
- runner B has the tags `tag1_runnerB` and `tag2_runnerB` ... and therefore runs only `job_2`
- **Careful**, the tag list should contain only tags of **one** runner!
- **Careful**, different runners cannot have the same tag!
- **Careful**, the tag list of one job should contain only tags of **one ** runner!
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment