Radish alpha
r
radicle-desktop
rad:z4D5UCArafTzTQpDZNQRuqswh3ury
Radicle desktop app
Radicle
Git
Commits › c9a3cf7
Improve release process docs
Rūdolfs Ošiņš committed 9 months ago
commit c9a3cf7ce18bd69b7090d2b6ec27d358991e7a97
parent ce35d49
2 files changed +70 -17
modified RELEASE.md
@@ -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
+ 
  TODO: automate the signing process with a docker image so it can be done from
+ 
  the host machine.
+
+ 
  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
- 
  ```
+ 
    "https://minio-api.radworks.garden/radworks-releases/radicle-desktop/pre-release/${VERSION}_${SHORT_RELEASE_SHA}/radicle-desktop_${VERSION}_amd64.deb"
- 
  TODO: complete this
+ 
  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
deleted build/.gitkeep