Release process

Note: We release every second Thursday, before the end of the cycle.

In your working shell set the following variable
```
VERSION="X.Y.Z"
```

Create a new release branch

rad sync && git fetch
git checkout -b release/v${VERSION} rad/main`

Update the version in crates/radicle-tauri/tauri.conf.json.
Update CHANGELOG.md — only include changes relevant to users.
Commit the changes git commit -m "Release v${VERSION}". This commit is the Release Commit.

In your working shell, set the release commit SHA

RELEASE_SHA="$(git rev-parse HEAD)"
SHORT_RELEASE_SHA="$(git rev-parse --short HEAD)"

Create a Release Patch with git push rad HEAD:refs/patches
Build the macOS app locally
```
cargo clean
rm -rf node_modules
npm install
npm exec -- tauri build --bundle dmg
```
This creates a file target/release/bundle/dmg/Radicle_X.Y.Z_aarch64.dmg.
Install the build macOS DMG and start the app to verify that it works.
Wait for CI of the Release Commit in the Release Patch to pass

Collect release artifacts

rm -rf release-artifacts && mkdir release-artifacts
curl -fL \
  "https://minio-api.radworks.garden/radworks-releases/radicle-desktop/pre-release/${VERSION}_${SHORT_RELEASE_SHA}/radicle-desktop_${VERSION}_amd64.AppImage" \
  --output release-artifacts/radicle-desktop-amd64.AppImage
cp -a "target/release/bundle/dmg/Radicle_${VERSION}_aarch64.dmg" \
  release-artifacts/radicle-desktop-aarch64.dmg
echo -n "{\"sha\": \"${RELEASE_SHA}\", \"version\": \"${VERSION}\"}" \
  > release-artifacts/latest.json

The content of release-artifacts should look like this:

release-artifacts
  latest.json
  radicle-desktop-aarch64.dmg
  radicle-desktop-amd64.AppImage

Sign the Debian package

curl -fLO \
  https://minio-api.radworks.garden/radworks-releases/radicle-desktop/pre-release/${VERSION}_${SHORT_RELEASE_SHA}/radicle_desktop_${VERSION}_amd64.deb

TODO: complete this

Update Arch Linux package info
- Update pkgver in arch/radicle-desktop/PKGBUILD to match the release version
- Update _commit in arch/radicle-desktop/PKGBUILD to the release commit created above.
- Regenerate .SRCINFO with
```
cd arch && ./generate-srcinfo.sh
```
- Commit and push the changes to arch/radicle-desktop/PKGBUILD and arch/radicle-desktop/.SRCINFO:
```
git commit -m "Update arch package to v${VERSION}"
git push rad
```
Wait for CI of the Release Patch to pass.
Wait for approval of the Release Patch and merge it into main.

Publish release files

scp -i "$(rad path)/keys/radicle" \
  release-artifacts/* "release@files.radicle.xyz:/mnt/radicle/files/releases/radicle-desktop/latest/"

Publish the Debian package to the APT repository (TODO)
Publish the Arch package by pushing changes to the Arch User Repository:
```
cd arch && ./publish.sh "Release v${VERSION}"
```
You need to be a maintainer of the AUR package to push.
Verify the Arch package version on the AUR.
Announce the release on Zulip, following the previous announcement format.
Resolve the previous release topic on Zulip.

3.5 KiB Raw Blame History

Release process

3.5 KiB

Raw Blame History