GitLab FI
GitLab Continuous Integration
GitLab Continuous Integration (CI) is used to automate some repository development tasks, most commonly for automated unit testing. For use with GitLab CI can be
configure your own physical or virtual machine (see
Stratus.FI virtualization ). In addition, a faculty machine can also be used
gitlab-ci.fi.muni.cz
.
Summary
Fakultní
gitlab-ci.fi
used official
GitLab Runner with container insulation on duty
Docker . After starting a new task (e.g.
git push
GitLab Runner asks Docker to create a new container from the image that is declared in the repository in the file
.gitlab-ci.yml
. The repository is cloned into the container and the tasks described in the file are started. When finished, the container is dropped and the result is returned to GitLab, which displays it in the
CI / CD section.
Configuring the Project for
gitlab-ci.fi.muni.cz
Read first
introductory information for using GitLab CI / CD . Next you will need
documentation
.gitlab-ci.yml
.
The docker is configured not to automatically install all required images, but to use only those locally available. This avoids over-installation of different versions of images that quickly fill up the disk capacity of the machine.
For a list of the images available for the GitLab CI faculty, see application of the Faculty Administration .
The image used is declared in
.gitlab-ci.yml
configuration as the key value
image
. The format is either
REPOSITORY:TAG
or
REPOSITORY
(the default tag is then used
latest
). If no image is specified, it is used
alpine:latest
.
image: maven:latest
If possible, use images with a mark
latest
or at least the most general version (e.g.
3-jdk-8
place
3.5.0-jdk-8
). In the case of image updates, older versions will be deleted if there is no free space on the disk.
The machine accepts tasks from repositories that have their own CI set
gitlab-ci.fi
tasks only from those projects that are marked with a mark
shared-fi
, which can be set as follows:
- in Settings → General → Permissions, enable Pipelines if it is not already enabled
- in settings
.gitlab-ci.yml
add a tagshared-fi
to each goal, eg:build: tags: - shared-fi
In the faculty GitLab FI you can look into the project
unix/ci-examples
, where you will find CI configuration examples for simple projects.
Installing additional images
Ask to install additional images or versions at
unixkxly_5F-H@fijIBCkjicr.municH1eZN460.cz
, specifying what the image will be used for.
If you want to install your own or customized image, please also include the application
Dockerfile
and all the necessary files to build the image. Administrators build and install the image into Docker.