formalize new versioning scheme and fix console nightlies

This commit formalizes the new version format of `$MAJOR.$MINOR-k8s$PATCH` for
releases v25.1 and forwards.

Changie has been configured to refer to versions in their semver format but
will replace them with their `-k8s` alternative in the CHANGELOG itself.

Version stamping has been moved to `./ci/script/version.sh` which provides a
variety of options.

```bash
./ci/scripts/version.sh charts/console -e  # v3.0-k8s0-beta.1-1-g760a015f
./ci/scripts/version.sh charts/console     # v3.0.0-beta.1-1-g760a015f
./ci/scripts/version.sh charts/redpanda    # v5.9.20-66-g92c19f4b
./ci/scripts/version.sh charts/redpanda -e # v5.9-k8s20-66-g92c19f4b
```

Author: chrisseto

.changie.yaml

@@ -3,7 +3,10 @@ unreleasedDir: unreleased
 headerPath: header.tpl.md
 changelogPath: CHANGELOG.md
 versionExt: md
-versionFormat: '## {{.Version}} - {{.Time.Format "2006-01-02"}}'
+# This nasty regex reformats "internal versions" to "external versions" the
+# same way that ./ci/scripts/version.sh does.
+# v$MAJOR.$MINOR.$PATCH-$PREREL+$METADATA -> v$MAJOR.$MINOR-k8s$PATCH-$PREREL+$METADATA
+versionFormat: '## {{regexReplaceAll "^(v\\d+\\.\\d+)\\.(\\d+.*)$" .Version "${1}-k8s${2}"}} - {{.Time.Format "2006-01-02"}}'
 kindFormat: '### {{.Kind}}'
 changeFormat: '* {{.Body}}'
 body:

CONTRIBUTING.md

@@ -78,12 +78,15 @@ applying the "no-changelog" label.
 
 To release any project in this repository:
 1. Mint the version and its CHANGELOG.md entry via `changie batch -j <project> <version>`
+    - If minting a pre-release, specify `-k` to keep the unreleased changes in place for the official release.
 2. Run `task test:unit` and `task lint`, they will report additional required actions, if any.
 4. Commit the resultant diff with the commit message `<project>: cut release <version>` and rebase it into master via a Pull Request.
 5. Tag the above commit with as `<project>/v<version>` with `git tag $(changie latest -j <project>) <commit-sha>`.
-    - If the operator is being released, also tag the same commit as `v<version>`.
-6. Push the tag(s).
-7. Create a Github [Release](https://github.com/redpanda-data/redpanda-operator/releases) on the redpanda-operator repo based on the entires in CHANGELOG.md associated with the Operator release tag. 
+6. Push the tags.
+7. Create a [Release on GitHub](https://github.com/redpanda-data/redpanda-operator/releases)
+    - Associate it with the tag pushed in the previous step.
+    - Paste the contents of `.changes/<project>/<version>.md`, excluding the header, into the release notes field.
+    - Use the header of `./changes/<project>/<version>.md` as the release name. e.g. `<project>: v42.8+k8s1`
 
 ## Nightly build
 

Taskfile.yml

@@ -37,13 +37,13 @@ vars:
   # `--always` is a fallback to print out the commit if no tag is found.
   # `sed` is used to trim off the qualifying parts of the tag so we just get the "version".
   OPERATOR_VERSION:
-    sh: git describe --dirty --tags --match 'v*' --match 'operator/v*' | sed 's#^operator/##'
+    sh: '{{.SRC_DIR}}/ci/scripts/version.sh operator'
   OPERATOR_CHART_VERSION:
     # NB: OPERATOR_CHART_VERSION is currently only used for the operator chart's nightly releases.
-    sh: git describe --dirty --tags --match 'charts/operator/v*' --always | sed 's#^charts/operator/##'
+    sh: '{{.SRC_DIR}}/ci/scripts/version.sh charts/operator'
   CONSOLE_CHART_VERSION:
     # NB: CONSOLE_CHART_VERSION is currently only used for the console chart's nightly releases.
-    sh: git describe --dirty --tags --match 'charts/console/v*' --always | sed 's#^charts/console/##'
+    sh: '{{.SRC_DIR}}/ci/scripts/version.sh charts/console -e'
 
 includes:
   build: taskfiles/build.yml

charts/console/Chart.yaml

@@ -30,7 +30,7 @@ type: application
 version: 0.7.31
 
 # The app version is the version of the Chart application
-appVersion: v3.0.0
+appVersion: v3.0.0-beta.1
 
 kubeVersion: ">= 1.25.0-0"
 

charts/console/README.md

@@ -3,7 +3,7 @@
 description: Find the default values and descriptions of settings in the Redpanda Console Helm chart.
 ---
 
-![Version: 0.7.31](https://img.shields.io/badge/Version-0.7.31-informational?style=flat-square) ![Type: application](https://img.shields.io/badge/Type-application-informational?style=flat-square) ![AppVersion: v3.0.0](https://img.shields.io/badge/AppVersion-v3.0.0-informational?style=flat-square)
+![Version: 0.7.31](https://img.shields.io/badge/Version-0.7.31-informational?style=flat-square) ![Type: application](https://img.shields.io/badge/Type-application-informational?style=flat-square) ![AppVersion: v3.0.0-beta.1](https://img.shields.io/badge/AppVersion-v3.0.0--beta.1-informational?style=flat-square)
 
 This page describes the official Redpanda Console Helm Chart. In particular, this page describes the contents of the chart’s [`values.yaml` file](https://github.com/redpanda-data/helm-charts/blob/main/charts/console/values.yaml).
 Each of the settings is listed and described on this page, along with any default values.