No Fuss Computing - Gitlab-CI

This repository is hosted on gitlab.com and has a read-only copy hosted on github.com.

links:

• Issues

• Merge Requests (Pull Requests)

Using this repository for your Gitlab CI/CD Jobs.

This repository has been designed as a central point for your repositories CI/CD jobs. By simply linking this repository to your repository and configuring, your CI/CD jobs will run as part of the build process, whilst keeping any CI/CD commits limited within your git history.

Each CI/CD job is contained within its own sub-folder. Each sub-folder has a readme specific to the job, which includes the details on how to implement, use etc.

CI Stages

The CI stages for these jobs are as follows, and in the order expected by the jobs:

• validation

  validation of files, commits, Merge Request titles, code quality, license checks.

• build

  build any binaries or files that would be used in the later stages .

• prepare

  any jobs that must run after build but before testing. for example a docker image build that includes artifacts from the build job

• test

  unit, functional, integration and any other tests.

• release

  git tagging and creating a gitlab release. Also includes adding build artifacts to gitlab registry.

• sync

  repository synchronization, i.e. push mirror to github.

• publish

  placement of build objects to external sources

Artifacts

Any artifacts by jobs will be created in folders named after the stage.

preference is placed on jobs to output JUnit.xml test reports. This is because they are visible in merge requests.

It is recommended that you set-up this repo as a git sub-module to your repo and that you configure it to a set commit/tag. This ensures that any change to gitlab-ci repo, does not effect your CI/CD jobs.

run the following commands:

git submodule add -b {ref} https://gitlab.com/nofusscomputing/projects/gitlab-ci.git gitlab-ci
git submodule update --remote

💡 Tip
NOTE: {ref} should be replaced with the branch name, master is the stable branch and recommended. by default the sub-module will be created in folder gitlab-ci, it is recommended that you don't change this folder name.

Contributing

All contributions for this project must conducted from Gitlab.

For further details on contributing please refer to the contribution guide.

Other

This repo is release under this license