Asqatasun v4 - Release a stable version of Asqatasun
This is the documentation for releasing a new stable version for Asqatasun. As an end user, you won't need it, it is just for developers.
1) Prepare CHANGELOG.md:
- Add an entry for this release
- Cumulatively, add all the data from previous betas and RCs (reader should have all details between previous stable release and this one, without having to dig into the previous betas and RCs). For this:
- review closed issues
- review closed Pull Requests
- review last commits
2) Update all READMEs
- Adjust top-level README.md: copy/paste changelog in section "Content of this last version"
- copy top-level README to Docker dirs (TODO define which ones)
2b) Update Upgrade instructions
- Adjust upgrade documentation in
documentation/en/50_Administrator_doc/Upgrading/
3) Upgrade version strings in code with bump_asqatasun.sh
./engine/asqatasun-resources/src/main/resources/release/bump_asqatasun.sh \
--from-version X.Y.Z-SNAPSHOT \
--to-version X.Y.Z \
--branch MY-RELEASE-BRANCH \
--source-dir . \
--commit \
--tag
(We don't push yet, do the testing stuff before :) )
4) Build local Docker image with locally build Asqatasun
When --source
is specified, get into that source directory and:
./docker/build_and_run-with-docker.sh -l -s "${PWD}" -d docker/SNAPSHOT-local --skip-build-test
Else when using clone in /tmp:
cd /tmp/Asqatasun # Directory used to clone Github repos
./docker/build_and_run-with-docker.sh -l -s /tmp/Asqatasun -d docker/SNAPSHOT-local --skip-build-test
5) Push branch and new X.Y.Z
tag
git push origin MY-RELEASE-BRANCH
git push origin vX.Y.Z
6) Switch back release strings to "-SNAPSHOT"
From the top of Asqatasun source directory, do:
./engine/asqatasun-resources/src/main/resources/release/bump_asqatasun.sh \
--from-version X.Y.Z \
--to-version A.B.C-SNAPSHOT \
--branch MY-RELEASE-BRANCH \
--source-dir . \
--commit \
--push \
--back-to-snapshot
7) In Github:
- Copy/paste Changelog to Github Release comment field
- Upload the
.tar.gz
files /tmp/Asqatasun/web-app/asqatasun-web-app/target/asqatasun-X.Y.Z.i386.tar.gz
/tmp/Asqatasun/runner/asqatasun-runner/target/asqatasun-runner-X.Y.Z.i386.tar.gz
8) Update Download.asqatasun.org
...so that "latest" points to the last release.
9) In Github, define this tag as "Release"
(as this one is the actual Release and not a pre-release)
10) In Asqatasun Docker hub
- Add a dedicated build for the Github tag with the same tag as Docker tag (while waiting to have a working regexp :) ).
- Add another dedicated build for the Github tag with
latest
as Docker tag
11) Launch prepared announces:
- forum
- Tweet
- LinkedIn groups + LinkedIn profiles
- LinuxFR
- TooLinux
11) Update W3C ERT list
... on https://www.w3.org/WAI/ER/tools/index.html