mirror of
https://seed.radicle.dev/rad:z4V1sjrXqjvFdnCUbxPFqd5p4DtH5.git
synced 2026-11-20 22:00:43 +08:00
Improve release process docs
This commit is contained in:
+72
-19
@@ -12,18 +12,18 @@
|
||||
|
||||
```bash
|
||||
rad sync && git fetch
|
||||
git checkout -b release/v${VERSION} rad/main`
|
||||
git checkout -b release/v${VERSION}
|
||||
```
|
||||
|
||||
- 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
|
||||
- Commit the changes `git commit -a -m "Release v${VERSION}"`. This commit is the
|
||||
_Release Commit_.
|
||||
- In your working shell, set the release commit SHA
|
||||
|
||||
```bash
|
||||
RELEASE_SHA="$(git rev-parse HEAD)"
|
||||
SHORT_RELEASE_SHA="$(git rev-parse --short HEAD)"
|
||||
SHORT_RELEASE_SHA="$(git rev-parse --short=8 HEAD)"
|
||||
```
|
||||
|
||||
- Create a _Release Patch_ with `git push rad HEAD:refs/patches`
|
||||
@@ -33,7 +33,7 @@
|
||||
cargo clean
|
||||
rm -rf node_modules
|
||||
npm install
|
||||
npm exec -- tauri build --bundle dmg
|
||||
npm exec -- tauri build --bundles dmg
|
||||
```
|
||||
|
||||
This creates a file `target/release/bundle/dmg/Radicle_X.Y.Z_aarch64.dmg`.
|
||||
@@ -65,12 +65,36 @@
|
||||
|
||||
- Sign the Debian package
|
||||
|
||||
```bash
|
||||
curl -fLO \
|
||||
https://minio-api.radworks.garden/radworks-releases/radicle-desktop/pre-release/${VERSION}_${SHORT_RELEASE_SHA}/radicle_desktop_${VERSION}_amd64.deb
|
||||
```
|
||||
TODO: automate the signing process with a docker image so it can be done from
|
||||
the host machine.
|
||||
|
||||
TODO: complete this
|
||||
Currently this happens via an Ubuntu vm manually:
|
||||
|
||||
```bash
|
||||
# Set the VERSION and SHORT_RELEASE_SHA variables to the same values here
|
||||
# in the VM as on the host system.
|
||||
RELEASE_SHA=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
||||
SHORT_RELEASE_SHA=XXXXXXXX
|
||||
|
||||
cd radicle-apt-repo
|
||||
rad sync && git fetch
|
||||
|
||||
curl -fLO \
|
||||
"https://minio-api.radworks.garden/radworks-releases/radicle-desktop/pre-release/${VERSION}_${SHORT_RELEASE_SHA}/radicle-desktop_${VERSION}_amd64.deb"
|
||||
|
||||
RADICLE_APT_SIGNING_KEY=~/work/apt-signing/rudolfs ./import-deb ./radicle-desktop_${VERSION}_amd64.deb
|
||||
rm -rf ./radicle-desktop_0.7.1_amd64.deb
|
||||
|
||||
git checkout -b release-v${VERSION}
|
||||
git commit -a -m "Update radicle-desktop to ${VERSION}"
|
||||
|
||||
# Make sure ssh-agent is started and `rad auth` is working, then publish the patch.
|
||||
|
||||
git push rad HEAD:refs/patches
|
||||
|
||||
# The next step is to merge this patch into main, which effectively publishes
|
||||
# the Deb packages. Continue this in the publish section below.
|
||||
```
|
||||
|
||||
- Update Arch Linux package info
|
||||
- Update `pkgver` in `arch/radicle-desktop/PKGBUILD` to match the release version
|
||||
@@ -86,12 +110,15 @@
|
||||
`arch/radicle-desktop/.SRCINFO`:
|
||||
|
||||
```bash
|
||||
git add radicle-desktop/.SRCINFO
|
||||
git add radicle-desktop/PKGBUILD
|
||||
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`.
|
||||
- Wait for CI of the Release Patch to pass
|
||||
- Wait for approval of the Release Patch and merge it into `main`
|
||||
|
||||
- Publish release files
|
||||
|
||||
```bash
|
||||
@@ -99,17 +126,43 @@
|
||||
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][4]:
|
||||
- Publish the Debian package to the APT repository
|
||||
- Switch to the `radicle-apt-repo` repository
|
||||
```bash
|
||||
cd radicle-apt-repo
|
||||
```
|
||||
|
||||
- Merge the patch that was created on radicle-apt-repo in the VM into main from your host machine as a delegate
|
||||
```bash
|
||||
rad sync && git fetch
|
||||
rad patch checkout XXXXXXX
|
||||
git checkout main
|
||||
git merge --ff-only patch/XXXXXXX
|
||||
git push
|
||||
```
|
||||
|
||||
- Upload the signed deb packages to files.radicle.xyz
|
||||
```bash
|
||||
scp -r -i "$(rad path)/keys/radicle" \
|
||||
dists "release@files.radicle.xyz:/mnt/radicle/files/apt/"
|
||||
scp -r -i "$(rad path)/keys/radicle" \
|
||||
pool "release@files.radicle.xyz:/mnt/radicle/files/apt/"
|
||||
```
|
||||
|
||||
TODO: can we make scp skip the files that are already uploaded?
|
||||
|
||||
- Publish the Arch package by pushing changes to the [Arch User Repository][1]
|
||||
(You need to be a maintainer of the AUR package to push)
|
||||
|
||||
```bash
|
||||
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](https://aur.archlinux.org/packages/radicle-desktop).
|
||||
- Announce the release on Zulip, following the [previous announcement format][3].
|
||||
- Resolve the previous release topic on Zulip.
|
||||
- Verify the Arch package version on the [AUR](https://aur.archlinux.org/packages/radicle-desktop)
|
||||
- Resolve the previous release topic on Zulip
|
||||
- Announce the release on Zulip, following the [previous announcement format][2]
|
||||
|
||||
[3]: https://radicle.zulipchat.com/#narrow/channel/409174-announcements/topic/radicle-desktop.20v0.2E2.2E0.20.28early.20preview.29/with/514356912
|
||||
[4]: https://aur.archlinux.org/packages/radicle-desktop
|
||||
|
||||
|
||||
[1]: https://aur.archlinux.org/packages/radicle-desktop
|
||||
[2]: https://radicle.zulipchat.com/#narrow/channel/409174-announcements/topic/radicle-desktop.20v0.2E2.2E0.20.28early.20preview.29/with/514356912
|
||||
|
||||
Reference in New Issue
Block a user