Skip to content

Setup repo ready for use

Migrate CI folder contents to this repo.

The intent of this repo is that it will be all of the CI jobs for projects.

Folder structure

All a CI Job per sub folder from the root of the repo.

{Job name}
    python-module (directory)
    scripts (directory)
    README.md
    CHANGELOG.md
    .gitlab-ci.yml
    

workflow / CI usage

  1. (Destination repo) create sub-folder called CI.
  2. (Destination repo) Run git clone {this repo} . from the CI folder. Can be a clone or sub module.
  3. (Destination repo) in the main .gitlab-ci.yaml include this repos job .gitlab-ci.yml

Changelog per folder

Command to output all commits on a path is git log --follow -- CI and can be formated as follows:

  • git log --pretty="format:%H - %s " --follow -- CI outputs {commit_hash} - {commit subject}

links

Tasks

  • set-up this repo open-source and sync with github project NoFussComputing/gitlab-ci

  • create a template job folder or document how to setup a job.

  • if child-repo setup CI as git-submodule can there be fail-over if host fails? If so document.

Feature To Do

  • ensure linting is done on the yaml files

    • is there a gitlab-ci linter?
  • linting Python files

  • do shell files need linting?

  • changelog per ci job folder commits per path could be used to format log, with dates and save as changelog.

  • merge request template

  • issue template

Edited by Jon
To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information