Release X.Y.0

[er-vin]

:memo: TO DO

:label: Tagging

• [ ] 🎯 Check the milestone for X.Y.0 to make sure every merged PR is included.
• [ ] Send a mail to marketing with a changelog generated using github_helper scripts, with previous feature release as origin point and finishing at latest commit in master branch and the expected release date no sooner than 7 days later
• [ ] :clock1: wait 7 days
• [ ] Bump VERSION.cmake to X.Y.0 and doc/conf.py (release to X.Y.0 and version to X.Y) in the stable branch
• [ ] Create tag from stable branch on the commit introducing the version bump

  $ git checkout stable-X.Y
  $ git pull
  $ git tag -s -m "Release X.Y.0" vX.Y.0
  $ git push origin vX.Y.0

  git remote add releases git@github.com:nextcloud-releases/desktop.git
  git fetch origin vX.Y.0
  git push releases vX.Y.0

  :factory: Building: trigger the builds on brander and wait for them to succeed

• [ ] Linux
• [ ] Mac OS
• [ ] Mac OS VFS (virtual file system/file provider)
• [ ] Windows MSI

:test_tube: Testing: execute the feature release test plan for each build

:penguin: Linux

• [ ] update from last release candidate (meaning that you have an existing account configured with the release candidate and upgrade the installation via installer)
• [ ] upload/download/check activity/check integration to file browser
• [ ] check cpu usage during sync
  • [ ] tray menu interaction
  • [ ] test Talk notifications (receive notification, reply to a message)
  • [ ] fresh installation
  • [ ] configure a new account
    • [ ] upload/download/check activity/check integration to file browser
    • [ ] check cpu usage during sync
    • [ ] tray menu interaction
    • [ ] test Talk notifications (receive notification, reply to a message)
    • [ ] check cpu usage during sync
  • [ ] configure a new account using selective sync
    • [ ] upload/download/check activity/check integration to file browser
    • [ ] check cpu usage during sync
    • [ ] tray menu interaction
    • [ ] test Talk notifications (receive notification, reply to a message)
    • [ ] check cpu usage during sync
• [ ] test important new feature from the release

:apple: Mac OS

• [ ] update from last release candidate (meaning that you have an existing account configured with the release candidate and upgrade the installation via installer)
• [ ] upload/download/check activity/check integration to file browser
• [ ] check cpu usage during sync
  • [ ] tray menu interaction
  • [ ] test Talk notifications (receive notification, reply to a message)
  • [ ] fresh installation
  • [ ] configure a new account
    • [ ] upload/download/check activity/check integration to file browser
    • [ ] check cpu usage during sync
    • [ ] tray menu interaction
    • [ ] test Talk notifications (receive notification, reply to a message)
    • [ ] check cpu usage during sync
  • [ ] configure a new account using selective sync
    • [ ] upload/download/check activity/check integration to file browser
    • [ ] check cpu usage during sync
    • [ ] tray menu interaction
    • [ ] test Talk notifications (receive notification, reply to a message)
    • [ ] check cpu usage during sync
• [ ] test important new feature from the release

:apple: Mac OS VFS

• [ ] update from last release candidate (meaning that you have an existing account configured with the release candidate and upgrade the installation via installer)
• [ ] upload/download/check activity/check integration to file browser
• [ ] check cpu usage during sync
  • [ ] tray menu interaction
  • [ ] test Talk notifications (receive notification, reply to a message)
  • [ ] fresh installation
  • [ ] configure a new account
    • [ ] upload/download/check activity/check integration to file browser
    • [ ] check cpu usage during sync
    • [ ] tray menu interaction
    • [ ] test Talk notifications (receive notification, reply to a message)
    • [ ] check cpu usage during sync
• [ ] test important new feature from the release

:door: Windows

• [ ] update from last release candidate (meaning that you have an existing account configured with the release candidate and upgrade the installation via installer)
• [ ] upload/download/check activity/check integration to file browser
• [ ] check cpu usage during sync
  • [ ] tray menu interaction
  • [ ] test Talk notifications (receive notification, reply to a message)
  • [ ] fresh installation
  • [ ] configure a new account with VFS
    • [ ] upload/download/check activity/check integration to file browser
    • [ ] check cpu usage during sync
    • [ ] tray menu interaction
    • [ ] test Talk notifications (receive notification, reply to a message)
    • [ ] check cpu usage during sync
  • [ ] configure a new account using selective sync
    • [ ] upload/download/check activity/check integration to file browser
    • [ ] check cpu usage during sync
    • [ ] tray menu interaction
    • [ ] test Talk notifications (receive notification, reply to a message)
    • [ ] check cpu usage during sync
• [ ] test important new feature from the release

:old_key: Signing

• [ ] Download the delta update file (.tbz) of the mac OS build.
• [ ] Download the delta update file (.tbz) of the mac OS VFS build.

  [!TIP] The .tbz file is required for automated upgrade. The link is located after the last mention of Sharing succeeded in the build logs. The file needs to be signed similarly to the .pkg file and uploaded everywhere.

• [ ] Sign binaries (ssh -P 2200 to signing VM, then, cat how-to-sign, then scp -P 2200 to download signatures)

🚀 Publishing

• [ ] Close the milestone for X.Y.0

:book: Changelog: create draft pre-release and release notes (click on Generate release notes) at:

• [ ] nextcloud/desktop/releases

  [!WARNING] Only add the release notes to nextcloud/desktop/releases. 🚨 For security reasons, the binaries are only uploaded to nextcloud-releases/desktop/releases.

• [ ] nextcloud-releases/desktop/releases (copy the changelog from nextcloud/desktop/releases)

⬆️ Upload binaries to:

• [ ] the draft pre-release at nextcloud-releases/desktop/releases
• [ ] download.nextcloud.com in the user home directory (so still private)

📧 Marketing:

• [ ] notify Marketing that the release is ready.

🔈 When marketing gives the go then publish the draft pre-releases created previously at:

• [ ] nextcloud/desktop/releases

  [!CAUTION] 🚨 No binaries in nextcloud/desktop/releases

• [ ] nextcloud-releases/desktop/releases
• [ ] Run the publish_desktop.sh script on download.nextcloud.com so that the binaries appear at download.nextcloud.com/desktop/releases
• [ ] Ask sysadmin to update the .htaccess such that latest alias point toward the new release (for example https://download.nextcloud.com/desktop/releases/Windows/latest)

:memo: Update the documentation:

• [ ] Add X.Y.0 to https://docs.nextcloud.com/ as the latest release.
• [ ] Make sure the link to the latest documentation (https://docs.nextcloud.com/desktop/latest/) is updated by sysadmin

🆕 Release via the updater server:

• In the updater server config change the following values to serve the release:
  • [ ] $stableReleaseDate
  • [ ] $fileProviderStableReleaseDate
  • [ ] $stableVersion
  • [ ] $fileProviderStableVersion

[!WARNING] The mac update service needs the signature and length values in order to work: the sparkle:edSignature and length values are printed right after the last mention of Sharing succeeded in the build log.

• 🍎 Under stable, update the following values for macos :
  • [ ] signature
  • [ ] length
  • [ ] fileProviderSignature
  • [ ] fileProviderLength

🌐 Update the website and users:

• [ ] Ping marketing (Peter specifically via e-mail or chat) to change the install-clients page to update the link to the latest release on Nextcloud website.
• [ ] E-mail the company internal mailing list about the new client: just a reminder for them to update to the latest client and to report any issues they might find.
• [ ] Ensure that desktop client links work on website and release packages are downloaded fine
• [ ] Also test links on portal and that release packages are downloaded fine

[tobiasKaminsky]

@mgallien @allexzander as discussed yesterday, please add those smoke tests to release overview (and probably add more test cases):

• have proper smoke testing for every release RC/Stable
• update
• fresh installation
• upload/download/check activity/check integration to file browser
• performance checks
• Windows/Mac: vfs and regular sync
• upgrade from 3.8.x to RC3
• fresh installation of RC3
• check integration to file browser
• check cpu usage during sync
• tray menu interaction

This needs to be tested on

• Linux
• Windows (old sync)
• Windows VFS
• Mac (old sync)
• Mac VFS

Please add them as checkboxes, so that we can track that every platform was tested.

[tobiasKaminsky]

• do not use https://github.com/nextcloud/desktop/releases
• use only https://github.com/nextcloud-releases/desktop/releases