[Author Prev][Author Next][Thread Prev][Thread Next][Author Index][Thread Index]

[tor-commits] [tor-browser-build/master] Bug 40451: Create Release Prep issue template



commit 7b11d992fcdbc6179841bffdc86b90377060df2f
Author: Richard Pospesel <richard@xxxxxxxxxxxxxx>
Date:   Mon Mar 7 21:11:25 2022 +0000

    Bug 40451: Create Release Prep issue template
---
 .gitlab/issue_templates/Release Prep.md | 132 ++++++++++++++++++++++++++++++++
 1 file changed, 132 insertions(+)

diff --git a/.gitlab/issue_templates/Release Prep.md b/.gitlab/issue_templates/Release Prep.md
new file mode 100644
index 0000000..8a683ad
--- /dev/null
+++ b/.gitlab/issue_templates/Release Prep.md	
@@ -0,0 +1,132 @@
+<details>
+  <summary>Explanation of variables</summary>
+
+- `$(TOR_LAUNCHER_VERSION)` : version of `tor-launcher`, used in tags
+    - example : `0.2.33`
+- `$(ESR_VERSION)` : the Mozilla defined ESR version, used in various places for building tor-browser tags, labels, etc
+    - example : `91.6.0`
+- `$(ESR_TAG)` : the Mozilla defined hg (Mercurial) tag associated with `$(ESR_VERSION)`
+    - exmaple : `FIREFOX_91_7_0esr_BUILD2`
+- `$(TOR_BROWSER_MAJOR)` : the Tor Browser major version
+    - example : `11`
+- `$(TOR_BROWSER_MINOR)` : the Tor Browser minor version
+    - example : either `0` or `5`; Alpha's is always (Stable + 5) % 10
+- `$(FIREFOX_BUILD_N)` : the firefox build revision within a given `tor-browser` branch; this is separate from the `$(TOR_BROWSER_BUILD_N) ` value
+    - example : `build1`
+- `$(TOR_BROWSER_BUILD_N)` : the tor-browser build revision for a given Tor Browser release; used in tagging git commits
+    - example : `build2`
+    - *NOTE* : `$(FIREFOX_BUILD_N)` and `$(TOR_BROWSER_BUILD_N)` typically are the same, but it is possible for them to diverge. For example :
+        - if we have multiple Tor Browser releases on a given ESR branch the two will become out of sync as the `$(FIREFOX_BUILD_N)` value will increase, while the `$(TOR_BROWSER_BUILD_N)` value may stay at `build1` (but the `$(TOR_BROWSER_VERSION)` will increase)
+        - if we have build failures unrelated to `tor-browser`, the `$(TOR_BROWSER_BUILD_N)` value will increase while the `$(FIREFOX_BUILD_N)` will stay the same.
+- `$(TOR_BROWSER_VERSION)` : the published Tor Browser version
+    - example : `11.5a6`, `11.0.7`
+</details>
+
+### **torbutton** ***(Desktop Only, Optional)***
+- [ ] Update translations :
+  -  [ ] `./import-translations.sh`
+  -  [ ] Commit with message `Translation updates`
+  -  [ ] *(Optional)* Backport to maintenance branch if present
+- [ ] fixup! `tor-browser`'s `Bug 10760 : Integrate TorButton to TorBrowser core` issue to point to updated `torbutton` commit
+
+### **tor-launcher** ***(Desktop Only, Optional)***
+- [ ] Update `install.rdf` file with new version
+- [ ] Sign/Tag commit :
+    - Tag : `$(TOR_LAUNCHER_VERSION)`
+    - Message `Tagging $(TOR_LAUNCHER_VERSION)`
+- [ ] Push `master` and tag to origin
+
+### **geckoview** ***(Android Only)***
+_TODO_
+
+### tba-translation ***(Android Only, Optional)***
+_TODO_
+
+### tor-browser
+- [ ] ***(Optional)*** Rebase to `$(ESR_VERSION)`
+    - [ ] Find the Firefox hg tag here : https://hg.mozilla.org/releases/mozilla-esr91/tags
+        - [ ] `$(ESR_TAG)` : `INSERT_TAG_HERE`
+    - [ ] Identify the hg patch associated with above hg tag, and find the equivalent `gecko-dev` git commit (search by commit message)
+        - [ ] `gecko-dev` commit : `INSERT_COMMIT_HASH_HERE`
+    - [ ] Create new `tor-browser` branch with the discovered `gecko-dev` commit as `HEAD` named `tor-browser-$(ESR_VERSION)esr-$(TOR_BROWSER_MAJOR).$(TOR-BROWSER_MINOR)-1`
+    - [ ] Sign/Tag commit :
+        - Tag : `$(ESR_TAG)`
+        - Message : `Mercurial $(ESR_TAG) tag`
+    - [ ] Push new branch and tag to origin
+    - [ ] Rebase `tor-browser` patches
+    - [ ] Open MR for the rebase
+- [ ] ***(Optional)*** Backport any required patches
+- [ ] Sign/Tag commit :
+    - Tag : `tor-browser-$(ESR_VERSION)esr-$(TOR_BROWSER_MAJOR).$(TOR_BROWSER_MINOR)-1-$(FIREFOX_BUILD_N)`
+    - Message : `Tagging $(FIREFOX_BUILD_N) for $(ESR_VERSION)esr-based (alpha|stable)`
+- [ ] Push tag to origin
+
+### tor-browser-build
+Tor Browser Alpha (and Nightly) are on the `master` branch, while Stable lives in the various `$(TOR_BROWSER_MAJOR).$(TOR_BROWSER_MINOR)-maint` (and possibly more specific) branches
+
+- [ ] Update `rbm.conf`
+    - [ ] `var/torbrowser_version` : update to next version
+    - [ ] `var/torbrowser_build` : update to `$(TOR_BROWSER_BUILD_N)`
+    - [ ] `var/torbrowser_incremental_from` : update to previous version
+        - [ ] **IMPORTANT** Really actually make sure this is the previous Desktop/Android version or else the `make incrementals-*` step will fail
+- [ ] Update `projects/firefox/config`
+    - [ ] `git_hash` : update the $(FIREFOX_BUILD_N) section to match `tor-browser` tag
+    - [ ] ***(Optional)*** `var/firefox_platform_version` : update to latest $(ESR_VERSION) if rebased
+- [ ] Check for NoScript updates here : https://addons.mozilla.org/en-US/firefox/addon/noscript
+    - [ ] ***(Optional)*** If version available, update `noscript` section of `input_files` in `projects/tor-browser/config`
+        - [ ] `URL`
+        - [ ] `sha256sum`
+- [ ] Check for openssl updates here : https://github.com/openssl/openssl/tags
+    - [ ] ***(Optional)*** If new 1.X.Y series tag available, update `projects/openssl/config`
+        - [ ] `version` : update to next 1.X.Y release tag
+        - [ ] `input_files/URL` : update to next source tarball
+        - [ ] `input_files/sha256sum` : update to sha256 sum of source tarball
+- [ ] Check for tor updates here : https://gitlab.torproject.org/tpo/core/tor/-/tags ; Tor Browser Alpha uses `-alpha` tagged tor, while stable uses the stable series
+    - [ ] ***(Optional)*** If new tor version is available, update `projects/tor/config`
+        - [ ] `version` : update to next release tag
+- [ ] Check for go updates here : https://golang.org/dl (Tor Browser Alpha uses the latest Stable go version, while Tor Browser Stable uses the latest of the previous Stable major series version (eg: if Tor Browser Alpha is on the go1.17 series, Tor Browser Stable is on the go1.16 series)
+    - [ ] ***(Optional)*** If new go version is available, update `projects/go/config`
+        - [ ] `version` : update go version
+        - [ ] `input_files/sha256sum` for `go` : update sha256sum of archive (sha256 sums are displayed on the go download page)
+- [ ] ***(Android Only)*** Update allowed_addons.json by running (from `tor-browser-build` root)`./tools/fetch_allowed_addons.py > projects/tor-browser/allowed_addons.json
+- [ ] Update `ChangeLog.txt`
+- [ ] Open MR with above changes
+- [ ] Sign/Tag commit : `make signtag-(alpha|release)`
+- [ ] Push tag to origin
+
+### blog
+
+- [ ] Duplicate previous Stable or Alpha release blog post as appropriate to new directory under `content/blog/new-release-tor-browser-$(TOR_BROWSER_VERSION)` and update with info on release :
+    - [ ] Update Tor Browser version numbers
+    - [ ] Note any ESR rebase
+    - [ ] Link to any Firefox security updates
+    - [ ] Note any updates to :
+        - [ ] tor
+        - [ ] openssl
+        - [ ] go
+        - [ ] noscript
+    - [ ] Convert ChangeLog.txt to markdown format used here by : `tor-browser-build/tools/changelog-format-blog-post`
+- [ ] Push to origin as new branch, open 'Draft :' MR
+- [ ] Remove draft from MR once signed-packages are uploaded
+
+### website
+- [ ] `databags/versions.ini` : Update the downloads versions
+    - `torbrowser-stable/version` : sort of a catch-all for latest stable version
+    - `torbrowser-stable/win32` : tor version in the expert bundle
+    - `torbrowser-*-stable/version` : platform-specific stable versions
+    - `torbrowser-*-alpha/version` : platform-specific alpha versions
+    - `tor-stable`,`tor-alpha` : set by tor devs, do not touch
+- [ ] Push to origin as new branch, open 'Draft :' MR
+- [ ] Remove draft from MR once signed-packages are uploaded
+
+### unsigned build uploads
+- [ ] Upload unsigned builds to people.torproject.org
+- [ ] Email tor-qa@xxxxxxxxxxxxxxxxxxxx with links to unsigned builds
+
+### signing
+_TODO_
+
+### signed build uploads
+_TODO_
+
+/label ~"Release Prep"
_______________________________________________
tor-commits mailing list
tor-commits@xxxxxxxxxxxxxxxxxxxx
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-commits