Skip to content

Commit

Permalink
chore(docs): Improve release process docs (#436)
Browse files Browse the repository at this point in the history
* chore(docs): Improve release process docs

* also mention help docs and release workflow
  • Loading branch information
pront authored Dec 11, 2024
1 parent 88a7014 commit 010f4ae
Showing 1 changed file with 31 additions and 19 deletions.
50 changes: 31 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,22 +21,34 @@ when the `develop` branch is merged into `master`.

To make releasing easier two scripts are utilized in the steps below.

1. `$ .github/release-vector-version.sh`
- This queries [vectordotdev/vector](https://github.com/vectordotdev/vector)
for the latest release and updates the `vector` chart's default image.
- This is convenient when updating the chart after a Vector release.

2. Commit the changes generated from step 1. This needs to be a
[conventional commit](https://www.conventionalcommits.org/).
- E.g. "feat(vector): Bump Vector to v0.29.0"

3. `$ .github/release-changelog.sh`
- This pulls the current `vector` chart version and uses `git-cliff` to update
the [CHANGELOG.md](CHANGELOG.md). Run this to generate the final commit merged into
`develop` before merging `develop` into `master`.
- This script requires [`yq`](https://github.com/mikefarah/yq) and
[`git-cliff`](https://github.com/orhun/git-cliff) to be installed.

4. Commit the changes generated from step 1. This needs to be a
[conventional commit](https://www.conventionalcommits.org/).
- E.g. "feat(vector): Regenerate CHANGELOG"
1. Run `$ .github/release-vector-version.sh`
- Update Helm docs by running `helm-docs`
- Commit the changes generated from step 1. This needs to be a
[conventional commit](https://www.conventionalcommits.org/).
- E.g. "feat(vector): Bump Vector to v0.29.0"
- Submit a PR with the changes.
- Notes:
- This queries [vectordotdev/vector](https://github.com/vectordotdev/vector)
for the latest release and updates the `vector` chart's default image.
- This is convenient when updating the chart after a Vector release.
- On macOS, install `gsed`

2. Run `$ .github/release-changelog.sh`
- Commit the changes generated from step 1. This needs to be a
[conventional commit](https://www.conventionalcommits.org/).
- E.g. "feat(vector): Regenerate CHANGELOG"
- Submit a PR with the changes.
- Notes:
- This pulls the current `vector` chart version and uses `git-cliff` to update
the [CHANGELOG.md](CHANGELOG.md). Run this to generate the final commit merged into
`develop` before merging `develop` into `master`.
- This script requires [`yq`](https://github.com/mikefarah/yq) and
[`git-cliff`](https://github.com/orhun/git-cliff) to be installed.

3. To kick off the [release workflow](https://github.com/vectordotdev/helm-charts/actions/workflows/release.yaml):
```
git switch master
git pull
git merge develop
git push
```

0 comments on commit 010f4ae

Please sign in to comment.