mirror of
https://github.com/syncthing/syncthing.git
synced 2026-04-08 16:38:03 -04:00
58 lines
1.8 KiB
ReStructuredText
58 lines
1.8 KiB
ReStructuredText
Creating a Release
|
|
==================
|
|
|
|
Prerequisites
|
|
-------------
|
|
|
|
- Push access to the ``syncthing`` repo, for pushing a new tag.
|
|
|
|
- SSH account on build server, member of the ``jenkins`` group, for
|
|
accessing and signing the releases.
|
|
|
|
- The release signing key on your GPG keyring on your own computer (for
|
|
signing the tag) and your account on the build server (for signing
|
|
the release). In a pinch, having it just on the build server will do
|
|
since you can run git there to create, sign and push the tag.
|
|
|
|
- Your Github token in the ``GITHUB_TOKEN`` environment variable on the
|
|
build server, for uploading the release.
|
|
|
|
Process
|
|
-------
|
|
|
|
Make sure the build seems sane. I.e. the build is clean on the build
|
|
server, the integration tests pass without complaints.
|
|
|
|
Update the documentation and translations, and commit the result.
|
|
|
|
.. code-block:: bash
|
|
|
|
$ ./build.sh prerelease
|
|
$ git commit -m "Translation and docs update"
|
|
$ git push
|
|
|
|
Create a new, signed tag on master, with the version as comment, and
|
|
push it:
|
|
|
|
.. code-block:: bash
|
|
|
|
$ git tag -a -s -u release@syncthing.net -m v0.10.15 v0.10.15
|
|
$ git push --tags
|
|
|
|
Trigger the ``syncthing-release`` job for the newly created
|
|
tag and wait for it to complete successfully before moving on.
|
|
|
|
Run ``go run changelog.go`` (in the repo) to create the changelog comparison
|
|
from the previous release. Copy to clipboard.
|
|
|
|
On the Github releases page, select the newly pushed tag and hit "Edit
|
|
Tag". Set the "Release title" to the same version as the tag, paste in
|
|
the changelog from above, and publish the release.
|
|
|
|
On the build server, logged in via ssh, run
|
|
``/usr/local/bin/upload-release``. This will create the md5sum and
|
|
sha1sum files, sign them (gpg will prompt for key passphrase twice) and
|
|
upload the whole shebang to Github.
|
|
|
|
Verify it looks sane on the releases page.
|