README.md 1.12 KB
Newer Older
Devin OKelly's avatar
Devin OKelly committed
1
2
3
4
5
6
7
8
9
10
# Example GitLab CI pipeline

This project is meant to function as a short overview of the capabilities and structure of GitLab CI.

To use this repository:

1. Fork or clone the repository elsewhere - you will need to do everything in your own space. You will also want to run this somewhere where `gitlab-runner` is already available. On BioHPC computers you can use `module add gitlab-runner`.
2. Make sure that CI is enabled for your project - Settings > General > Visibility, project features, permissions > CI/CD on.
3. In your project, check Settings > CI/CD > Runners to get the runner registration token for your project.
4. Modify `set_up_runners.sh` to reflect the registration token for your project.
Devin OKelly's avatar
Devin OKelly committed
11
12
5. Run `bash ./set_up_runners.sh` in this folder to register a runner and start it on your shell.
6. If you want to let your runner keep going in the background, press `<ctrl> + Z` and enter `bg 1` while the runner is going.
13
7. Once a runner is registered, you can restart that same runner again with `gitlab-runner run`. You only need to register each runner once.
Devin OKelly's avatar
Devin OKelly committed
14
8. Explore and make changes to the repository and see what happens!