mirror of
https://github.com/junegunn/fzf.git
synced 2026-07-19 06:40:10 +08:00
Junegunn Choi
3953d1c649
- `prerelease`: version-consistency grep across CHANGELOG, install, install.ps1, and both man pages (extracted from `release` target) - `tag`: depends on `prerelease`; signs and pushes the version tag - RELEASE.md: replace manual tag/push steps with `make tag`
55 lines
1.7 KiB
Markdown
55 lines
1.7 KiB
Markdown
Release process
|
|
===============
|
|
|
|
Building, signing, notarizing, and publishing is handled by
|
|
[`.github/workflows/release.yml`](.github/workflows/release.yml),
|
|
triggered by a tag push.
|
|
|
|
## Steps
|
|
|
|
1. Update version in the following files and commit on `master`:
|
|
- `CHANGELOG.md`
|
|
- `main.go`
|
|
- `install`
|
|
- `install.ps1`
|
|
- `man/man1/fzf.1`
|
|
- `man/man1/fzf-tmux.1`
|
|
|
|
2. Verify file consistency, sign the tag, and push the tag.
|
|
|
|
```sh
|
|
make tag VERSION=0.73.0
|
|
```
|
|
|
|
`make tag` runs `prerelease` first (checks that the version
|
|
appears in CHANGELOG.md, both man pages, install, and install.ps1)
|
|
and only signs + pushes the tag if the checks pass.
|
|
|
|
Only the tag is pushed; `master` on origin still points to the
|
|
old version, so `/master/install` keeps resolving against existing
|
|
binaries during the publish window.
|
|
|
|
3. The workflow fires on the tag push and pauses on the `release`
|
|
environment gate. Approve it in the Actions tab to release.
|
|
|
|
4. After the GitHub release is published, fast-forward `master`:
|
|
|
|
```sh
|
|
git push origin master
|
|
```
|
|
|
|
## Testing the workflow
|
|
|
|
To exercise the workflow without firing a real release:
|
|
|
|
1. Actions tab -> **Release** -> **Run workflow**.
|
|
2. Pick a branch and enter the version currently on that branch
|
|
(the version-consistency check requires the input to match the
|
|
files in the checked-out tree).
|
|
3. Approve the `release` environment gate when prompted.
|
|
4. Goreleaser runs with `--snapshot --skip=publish`. Signing and
|
|
notarization run; only the GitHub release upload is skipped.
|
|
|
|
Use this to validate the workflow YAML, version-extraction logic,
|
|
the macOS runner setup, and the signing/notarization credentials.
|