@open-xchange/create-release

Open-Xchange Release Tool

This tool is based on release-it and auto-changelog.

Prerequisites

Required environment variable: Gitlab Personal Access Token

You will need a personal access token with api scope. Add this to your environment via your .zshrc, .profile or whatever you are using as GITLAB_TOKEN.

Or export the environment variable directly into your session.

export GITLAB_TOKEN=XXXXXXZZZZZZZZZZ

Required environment variable: EDITOR or VISUAL

In the interactive mode you will be asked to verify / edit your changelog. This opens your editor that is defined in VISUAL or EDITOR environment variables.

If you want to use Microsoft Visual Studio Code for this:

export VISUAL="code -w"

CHANGELOG.md File

To use this workflow you will need to add a keep-a-changelog style changelog to your project.

You can copy the template CHANGELOG-template.md to CHANGELOG.md.

Git Tags

For existing tags/releases you need to add a version section for each tag or release manually to your changelog, according to the keep-a-changelog specifications.

How to use

You need to have the latest stable node and yarn installed.

To execute in interactive mode:

yarn create -s @open-xchange/release

Thats all!

Notes

• Temporarily we are using a fork of autochange-log which is located here: https://github.com/open-xchange/auto-changelog

TODO

• Support for different git tag patterns
• Require clean working dir when releasing app without helm chart