USAGE
=====

include:
  - project: EOLE/Infra/ci-tools
    ref: master
    file: /templates/Helm.yaml

stages:
  - lint

helm lint: {extends: '.helm:lint'}

REQUIREMENTS
============

- a `lint` stage must be present in your pipeline or it must be
  overriden by the extending job to feet your need.

- the `.not-on-stable` rules templates or it must be overriden by
  the extending job to feet your need

OPTIONAL VARIABLES
==================

- `CHART_DIR`: directory of the helm chart, default to `.`

- `HELM_IMAGE`: name of the `helm` docker image to use

- `HELM_ARGS`: optional arguments to pass to `helm lint` command,
  empty by default

We need the `helm` tool itself and the helm plugin
[`cm-push`](https://github.com/chartmuseum/helm-push) to upload to
harbor chartmuseum.

* Dockerfile.semantic-release-gitlab: add the forked
  [semantic-release-helm3](https://www.npmjs.com/package/semantic-release-helm3)
  plugin to support prerelease versions.

* .releaserc.js: add a commented configuration of the
  `semantic-release-helm3` plugin

Resolve "All semantic-release configuration should be in a single file"

Closes #13

See merge request !55

Rename the configuration file to hide it by default.

feat(semantic-release): comment merge requests and issues in release

Closes #11

See merge request !52

The last version add a release comment in merge requests and related
closed issues.

### [1.9.1](https://gitlab.mim-libre.fr/EOLE/infra/ci-tools/compare/release/1.9.0...release/1.9.1) (2022-03-22)

### Bug Fixes

* **python:** backquotes in shell strings try to execute commands ([e9cde637](e9cde637))

Resolve "Python: backquote in strings try to execute `sdist` command"

See merge request !51

* templates/Python.yaml: replace backquotes by single quotes

## [1.9.0](https://gitlab.mim-libre.fr/EOLE/infra/ci-tools/compare/release/1.8.0...release/1.9.0) (2022-03-21)

### Features

* **python:** use `build` module to support PEP517 package building ([a45db538](a45db538))

feat(python): use `build` module to support PEP517 package building

See merge request !50

feat(python): use `build` module to support PEP517 package building

See merge request !49

Resolve "Python: switch build process to the `build` PEP517 package builder"

Closes #9

See merge request !48

This permit to support either `pyproject.toml or `setup.py` based
projects.

The best way to build is to use `.python:build` which create the
`sdist` and build the `wheel` from it.

## [1.8.0](https://gitlab.mim-libre.fr/EOLE/infra/ci-tools/compare/release/1.7.0...release/1.8.0) (2022-03-18)

### Features

* **python:** build source distribution package ([1ee7498b](1ee7498b))
* **python:** build wheel package ([6b6a59f2](6b6a59f2))
* **python:** check code formatting using `black` ([4c9f0456](4c9f0456))
* **python:** upload python package files with `twine` ([8a1d9d4c](8a1d9d4c))

Publish new release

See merge request !47

Prepare new release

See merge request !46

feat(python): template jobs to build and upload source and wheel packages

Closes #8

See merge request !45

## [1.7.0](https://gitlab.mim-libre.fr/EOLE/infra/ci-tools/compare/release/1.6.0...release/1.7.0) (2022-03-15)

### Features

* **semantic-release:** switch to `conventionalcommits` changelog ([07950c4c](07950c4c))

Publish new release

See merge request !44

Prepare a new release

See merge request !43

feat(semantic-release): switch to `conventionalcommits` changelog

Closes #7

See merge request !42

The `conventional-changelog-conventionalcommits` permits to easily
configure which commit types are rendered or not in the changelog and
releases.

* Dockerfile.semantic-release-gitlab: the module must be installed.

* release.config.js: switch to `conventionalcommits` and configure the
  commit `types`.

# [1.6.0](https://gitlab.mim-libre.fr/EOLE/infra/ci-tools/compare/release/1.5.0...release/1.6.0) (2022-03-15)

### Features

* **git:** new `.git:merge-to` job template to merge a reference ([f8501fc7](EOLE/infra/ci-tools@f8501fc7))

Publish new release

See merge request EOLE/infra/ci-tools!41

Prepare new release

See merge request EOLE/infra/ci-tools!40

ci(release): generate releases using the new template job

See merge request EOLE/infra/ci-tools!38

And use the shorter `release.config.js` file with recent
`semantic-release` fixes.

feat(git): new `.git:merge-to` job template to merge a reference

Closes #6

See merge request EOLE/infra/ci-tools!37

By default, the source of the merge is `${CI_COMMIT_TAG}` and the
target must be defined by the `.gitlab-ci.yml` job using this
template.

* docs/GETTING-STARTED.md: new section to document `.git:merge-to`
  template job.

* templates/Git.yaml: new `.git:merge-to` template job to merge a
  reference into a target branch.

refactor(templates): we factorize the job templates per topic

Closes #4

See merge request EOLE/infra/ci-tools!36

Building a docker image is now done by `.docker:image:build` job
template.

Tagging a docker image is now done by `.docker:image:tag` job
template.

We keep the previous job templates for backward compatibility.

* templates/Docker.yaml: new `.docker:image:build` and
  `.docker:image:tag` job templates.

Using `semantic-release` require the users to include
`templates/Semantic-release.yaml` and `extends` the `.semantic-release:*`
job templates.

We keep `templates/Release/Semantic-release.yaml` for backward
compatibility.

* templates/Semantic-release.yaml: new `semantic-release` related job
  templates

* templates/Lint/Commitlint.yaml: define `semantic-release` with the
  `.semantic-release:stable` job template for backward compatibility.