@@ -123,10 +123,11 @@ For verification purposes you can check the list of ildap group members with a c
...
@@ -123,10 +123,11 @@ For verification purposes you can check the list of ildap group members with a c
## How to use the continuous integration (CI) service?
## How to use the continuous integration (CI) service?
Besides using Inria's Continuous Integration platform [ci.inria.fr](https://ci.inria.fr), you can use gitlab's integrated CI pipelines. This tool is more suited to the execution of simple and lightweight tasks, than for complex deployment pipelines.
Besides using Inria's Continuous Integration platform [ci.inria.fr](https://ci.inria.fr), you can use gitlab's integrated CI pipelines, see the [official documentation](https://docs.gitlab.com/ee/ci/) and the complete [gitlab-ci yaml reference](https://docs.gitlab.com/ee/ci/yaml/).
You will need to set up a CI runner (small tool in charge of running the CI
Concerning the machines setup to run the tests you can either use existing "shared runners" (to be used with docker images), see section _Use existing shared runners_ hereafter, or you will need to install [gitlab-runner](https://docs.gitlab.com/runner/install/) on your specific machine and then register the runner with your project, see section _Installing your own specific runners_.
tasks themselves) and then register the runner with your project.
In addition, if you look for "real life" gitlab-ci examples, please visit this dedicated group [gitlabci_gallery](https://gitlab.inria.fr/gitlabci_gallery). It contains several subgroups and git repositories showing some interesting key features of gitlab-ci and possible integrations with external tools/platforms (ci.inria.fr, terraform, github, a supercomputer, etc).
### Enabling CI on a gitlab project
### Enabling CI on a gitlab project
...
@@ -149,7 +150,7 @@ myjob:
...
@@ -149,7 +150,7 @@ myjob:
- whoami
- whoami
```
```
### Installing runners
### Installing your own specific runners
To perform the actual build, you need to install GitLab Runner. Runners can run anywhere : you can use a virtual machine on [ci.inria.fr](https://ci.inria.fr) to host your GitLab runner.
To perform the actual build, you need to install GitLab Runner. Runners can run anywhere : you can use a virtual machine on [ci.inria.fr](https://ci.inria.fr) to host your GitLab runner.
...
@@ -161,7 +162,7 @@ See :
...
@@ -161,7 +162,7 @@ See :
#### Installation example on a GNU/linux slave from ci.inria.fr ("ci" user account)
#### Installation example on a GNU/linux slave from ci.inria.fr ("ci" user account)
it is important to know that "gitlab-ci tags" are NOT git tags. The tags you enter here are useful to specify conditional execution in the configuration file .gitlab-ci.yml.
it is important to know that "gitlab-ci tags" are NOT git tags. The tags you enter here are useful to specify conditional execution in the configuration file .gitlab-ci.yml.
See :
See :
*<https://docs.gitlab.com/ce/ci/yaml/#tags>
*<https://docs.gitlab.com/ee/ci/yaml/#tags>
* and <https://docs.gitlab.com/ce/ci/yaml/#only-and-except>
* and <https://docs.gitlab.com/ee/ci/yaml/#only--except>