mirror of
https://github.com/rclone/rclone
synced 2024-11-15 14:57:03 +01:00
156 lines
4.8 KiB
Markdown
156 lines
4.8 KiB
Markdown
# Release
|
|
|
|
This file describes how to make the various kinds of releases
|
|
|
|
## Extra required software for making a release
|
|
|
|
* [gh the github cli](https://github.com/cli/cli) for uploading packages
|
|
* pandoc for making the html and man pages
|
|
|
|
## Making a release
|
|
|
|
* git checkout master # see below for stable branch
|
|
* git pull # IMPORTANT
|
|
* git status - make sure everything is checked in
|
|
* Check GitHub actions build for master is Green
|
|
* make test # see integration test server or run locally
|
|
* make tag
|
|
* edit docs/content/changelog.md # make sure to remove duplicate logs from point releases
|
|
* make tidy
|
|
* make doc
|
|
* git status - to check for new man pages - git add them
|
|
* git commit -a -v -m "Version v1.XX.0"
|
|
* make retag
|
|
* git push origin # without --follow-tags so it doesn't push the tag if it fails
|
|
* git push --follow-tags origin
|
|
* # Wait for the GitHub builds to complete then...
|
|
* make fetch_binaries
|
|
* make tarball
|
|
* make vendorball
|
|
* make sign_upload
|
|
* make check_sign
|
|
* make upload
|
|
* make upload_website
|
|
* make upload_github
|
|
* make startdev # make startstable for stable branch
|
|
* # announce with forum post, twitter post, patreon post
|
|
|
|
## Update dependencies
|
|
|
|
Early in the next release cycle update the dependencies
|
|
|
|
* Review any pinned packages in go.mod and remove if possible
|
|
* make updatedirect
|
|
* make GOTAGS=cmount
|
|
* make compiletest
|
|
* git commit -a -v
|
|
* make update
|
|
* make GOTAGS=cmount
|
|
* make compiletest
|
|
* roll back any updates which didn't compile
|
|
* git commit -a -v --amend
|
|
* **NB** watch out for this changing the default go version in `go.mod`
|
|
|
|
Note that `make update` updates all direct and indirect dependencies
|
|
and there can occasionally be forwards compatibility problems with
|
|
doing that so it may be necessary to roll back dependencies to the
|
|
version specified by `make updatedirect` in order to get rclone to
|
|
build.
|
|
|
|
## Tidy beta
|
|
|
|
At some point after the release run
|
|
|
|
bin/tidy-beta v1.55
|
|
|
|
where the version number is that of a couple ago to remove old beta binaries.
|
|
|
|
## Making a point release
|
|
|
|
If rclone needs a point release due to some horrendous bug:
|
|
|
|
Set vars
|
|
|
|
* BASE_TAG=v1.XX # e.g. v1.52
|
|
* NEW_TAG=${BASE_TAG}.Y # e.g. v1.52.1
|
|
* echo $BASE_TAG $NEW_TAG # v1.52 v1.52.1
|
|
|
|
First make the release branch. If this is a second point release then
|
|
this will be done already.
|
|
|
|
* git co -b ${BASE_TAG}-stable ${BASE_TAG}.0
|
|
* make startstable
|
|
|
|
Now
|
|
|
|
* git co ${BASE_TAG}-stable
|
|
* git cherry-pick any fixes
|
|
* Do the steps as above
|
|
* make startstable
|
|
* git co master
|
|
* `#` cherry pick the changes to the changelog - check the diff to make sure it is correct
|
|
* git checkout ${BASE_TAG}-stable docs/content/changelog.md
|
|
* git commit -a -v -m "Changelog updates from Version ${NEW_TAG}"
|
|
* git push
|
|
|
|
## Sponsor logos
|
|
|
|
If updating the website note that the sponsor logos have been moved out of the main repository.
|
|
|
|
You will need to checkout `/docs/static/img/logos` from https://github.com/rclone/third-party-logos
|
|
which is a private repo containing artwork from sponsors.
|
|
|
|
## Update the website between releases
|
|
|
|
Create an update website branch based off the last release
|
|
|
|
git co -b update-website
|
|
|
|
If the branch already exists, double check there are no commits that need saving.
|
|
|
|
Now reset the branch to the last release
|
|
|
|
git reset --hard v1.64.0
|
|
|
|
Create the changes, check them in, test with `make serve` then
|
|
|
|
make upload_test_website
|
|
|
|
Check out https://test.rclone.org and when happy
|
|
|
|
make upload_website
|
|
|
|
Cherry pick any changes back to master and the stable branch if it is active.
|
|
|
|
## Making a manual build of docker
|
|
|
|
The rclone docker image should autobuild on via GitHub actions. If it doesn't
|
|
or needs to be updated then rebuild like this.
|
|
|
|
See: https://github.com/ilteoood/docker_buildx/issues/19
|
|
See: https://github.com/ilteoood/docker_buildx/blob/master/scripts/install_buildx.sh
|
|
|
|
```
|
|
git co v1.54.1
|
|
docker pull golang
|
|
export DOCKER_CLI_EXPERIMENTAL=enabled
|
|
docker buildx create --name actions_builder --use
|
|
docker run --rm --privileged docker/binfmt:820fdd95a9972a5308930a2bdfb8573dd4447ad3
|
|
docker run --rm --privileged multiarch/qemu-user-static --reset -p yes
|
|
SUPPORTED_PLATFORMS=$(docker buildx inspect --bootstrap | grep 'Platforms:*.*' | cut -d : -f2,3)
|
|
echo "Supported platforms: $SUPPORTED_PLATFORMS"
|
|
docker buildx build --platform linux/amd64,linux/386,linux/arm64,linux/arm/v7 -t rclone/rclone:1.54.1 -t rclone/rclone:1.54 -t rclone/rclone:1 -t rclone/rclone:latest --push .
|
|
docker buildx stop actions_builder
|
|
```
|
|
|
|
### Old build for linux/amd64 only
|
|
|
|
```
|
|
docker pull golang
|
|
docker build --rm --ulimit memlock=67108864 -t rclone/rclone:1.52.0 -t rclone/rclone:1.52 -t rclone/rclone:1 -t rclone/rclone:latest .
|
|
docker push rclone/rclone:1.52.0
|
|
docker push rclone/rclone:1.52
|
|
docker push rclone/rclone:1
|
|
docker push rclone/rclone:latest
|
|
```
|