2023-06-28 15:38:31 +03:00
|
|
|
# Releasing
|
|
|
|
|
|
|
|
## Release checklist
|
|
|
|
|
|
|
|
- [ ] check ghcup supports new GHC releases if any
|
|
|
|
- [ ] set the supported GHCs in workflow file `.github/workflows/release.yaml`
|
2023-08-12 13:40:41 +03:00
|
|
|
- There is currently a list of GHC versions for each major platform. Search for `ghc: [` to find all lists.
|
|
|
|
- Look for `TODO:` to find locations that require extra care for GHC versions.
|
2023-06-28 15:38:31 +03:00
|
|
|
- [ ] check all plugins still work if release includes code changes
|
|
|
|
- [ ] bump package versions in all `*.cabal` files (same version as hls)
|
2023-08-25 17:26:00 +03:00
|
|
|
- HLS uses lockstep versioning. The core packages and all plugins use the same version number, and only support exactly this version.
|
2023-08-12 13:40:41 +03:00
|
|
|
- Exceptions:
|
|
|
|
- `hie-compat` requires no automatic version bump.
|
|
|
|
- `shake-bench` is an internal testing tool, not exposed to the outside world. Thus, no version bump required for releases.
|
|
|
|
- For updating cabal files, the following script can be used:
|
|
|
|
- ```sh
|
2024-02-26 12:37:11 +03:00
|
|
|
./release/update_versions.sh <OLD_VERSION> <NEW_VERSION>
|
2023-08-12 13:40:41 +03:00
|
|
|
```
|
|
|
|
- It still requires manual verification and review
|
2023-06-28 15:38:31 +03:00
|
|
|
- [ ] generate and update changelog
|
2023-08-12 13:40:41 +03:00
|
|
|
- Generate a ChangeLog via `./GenChangelogs.hs <api-key> <tag>`
|
|
|
|
- `<tag>` is the git tag you want to generate the ChangeLog from.
|
|
|
|
- `<api-key>` is a github access key: https://github.com/settings/tokens
|
2024-06-19 11:35:14 +03:00
|
|
|
- [ ] update https://haskell-language-server.readthedocs.io/en/latest/support/ghc-version-support.html#current-ghc-version-support-status
|
2023-06-28 15:38:31 +03:00
|
|
|
- [ ] create release branch as `wip/<version>`
|
2023-08-12 13:40:41 +03:00
|
|
|
- `git switch -c wip/<version>`
|
2023-06-28 15:38:31 +03:00
|
|
|
- [ ] create release tag as `<version>`
|
2023-08-12 13:40:41 +03:00
|
|
|
- `git tag <version>`
|
2023-06-28 15:38:31 +03:00
|
|
|
- [ ] trigger release pipeline by pushing the tag
|
|
|
|
- this creates a draft release
|
2023-08-12 13:40:41 +03:00
|
|
|
- `git push <remote> <version>`
|
|
|
|
- [ ] run `sh scripts/release/download-gh-artifacts.sh <version> <your-gpg-email>`
|
2023-09-03 13:42:42 +03:00
|
|
|
- downloads artifacts to `gh-release-artifacts/haskell-language-server-<version>/`
|
2023-06-28 15:38:31 +03:00
|
|
|
- also downloads FreeBSD bindist from circle CI
|
|
|
|
- adds signatures
|
2023-09-03 13:42:42 +03:00
|
|
|
- [ ] upload artifacts to downloads.haskell.org from `gh-release-artifacts/haskell-language-server-<version>/`
|
2023-08-12 13:40:41 +03:00
|
|
|
- You require sftp access, contact wz1000, bgamari or chreekat
|
|
|
|
- `cd gh-release-artifacts/haskell-language-server-<version>`
|
|
|
|
- `SIGNING_KEY=... ../../release/upload.sh upload`
|
|
|
|
- Your SIGNING_KEY can be obtained with `gpg --list-secret-keys --keyid-format=long`
|
|
|
|
- Afterwards, the artifacts are available at: `https://downloads.haskell.org/~hls/haskell-language-server-<version>/`
|
|
|
|
- Run `SIGNING_KEY=... ../../release/upload.sh purge_all` to remove CDN caches
|
2023-06-28 15:38:31 +03:00
|
|
|
- [ ] create PR to [ghcup-metadata](https://github.com/haskell/ghcup-metadata)
|
2024-02-27 11:10:16 +03:00
|
|
|
- [ ] update `ghcup-vanilla-0.0.8.yaml` and `ghcup-vanilla-0.0.7.yaml`
|
2023-06-28 15:38:31 +03:00
|
|
|
- can use `sh scripts/release/create-yaml-snippet.sh <version>` to generate a snippet that can be manually inserted into the yaml files
|
2024-02-27 11:10:16 +03:00
|
|
|
- ~~update `hls-metadata-0.0.1.json`~~ Currently unnecessary, GHCup builds its own HLS binaries and updates that file.
|
2023-06-28 15:38:31 +03:00
|
|
|
- utilize `cabal run ghcup-gen -- generate-hls-ghcs -f ghcup-0.0.7.yaml --format json --stdout` in the root of ghcup-metadata repository
|
2023-08-12 13:40:41 +03:00
|
|
|
- Be sure to mark the correct latest version and add the 'recommended' tag to the latest release.
|
2023-06-28 15:38:31 +03:00
|
|
|
- [ ] get sign-off on release
|
|
|
|
- from wz1000, michealpj, maerwald and fendor
|
|
|
|
- [ ] publish release on github
|
|
|
|
- [ ] upload hackage packages
|
|
|
|
- requires credentials
|
2023-09-01 13:42:14 +03:00
|
|
|
- [ ] Supported tools table needs to be updated:
|
|
|
|
- https://www.haskell.org/ghcup/install/#supported-platforms
|
|
|
|
- https://github.com/haskell/ghcup-hs/blob/master/docs/install.md#supported-platforms
|
|
|
|
- https://github.com/haskell/ghcup-metadata/blob/44c6e2b5d0fcae15abeffff03e87544edf76dd7a/ghcup-gen/Main.hs#L67
|
2023-06-28 15:38:31 +03:00
|
|
|
- [ ] post release on discourse and reddit
|
|
|
|
- [ ] merge release PR to master or forward port relevant changes
|