Page MenuHomePhabricator
Create Task
Maniphest T392448

Upgrade to Gerrit 3.12
Open, Needs TriagePublic
Actions

Description

Bookworm → Java 21 → Gerrit 3.11 → Gerrit 3.12 → Gerrit 3.13

Gerrit 3.12 has been released May 19 2025 (Release plan). This task is to upgrade Gerrit to 3.12.

Executive summary
https://www.gerritcodereview.com/releases-readme.html#312

  • Dropped support for Java 17
  • Site-wide override of copy label conditions
  • Group deletion
  • H2 v2 backend
  • Performance improvements

Release Notes
https://www.gerritcodereview.com/3.12.html

Breaking changes

To be checked

Already identified breaking change:

  • Drop support for Java 17 (require Java 21)

Related Objects
Search...

StatusSubtypeAssignedTask
 ResolvedNoneT393239 ProbeDown
 OpenNoneT392448 Upgrade to Gerrit 3.12
 OpenNoneT379714 Upgrade to Gerrit 3.11
 OpenNoneT392465 Switch Gerrit from Java 17 to Java 21
 ResolvedABran-WMFT392464 Upgrade Gerrit hosts from Bullseye to Bookworm
 ResolvedABran-WMFT387833 Gerrit switchover process
 OpenNoneT388507 Investigate missing commit from old changes
 ResolvedABran-WMFT260666 Create a cookbook to automate gerrit's switchover
 ResolvedABran-WMFT393050 ProbeDown
 ResolvedMatthewVernonT392186 Grant Gerrit admin to arnaudb
 ResolvedLSobanskiT393034 Investigate out of date refs following gerrit switchover
 ResolvedABran-WMFT395440 Gerrit read-only plugin test
 ResolvedABran-WMFT406334 Gerrit switchover between secondary instances
 ResolvedLSobanskiT406482 SystemdUnitFailed (jenkins.service on contint1002)
 ResolvedhasharT406762 gerrit2003 is trying to backup incrementally 3.5 million files every hour, clogging backus and filling in available disk space
 ResolvedABran-WMFT411583 Gerrit backups are growing
 ResolvedhasharT406856 Reduce size of analytics/superset/deploy.git Gerrit repo
 ResolvedABran-WMFT407200 Gerrit is down
 ResolvedABran-WMFT412779 Gerrit failover process
 ResolvedABran-WMFT417246 Reimage gerrit1003
 ResolveddancyT417767 scap error on Gerrit first setup
 ResolvedABran-WMFT417777 SystemdUnitFailed - apache2.service on gerrit1003:9100
 DuplicateNoneT417968 ProbeDown
 DuplicateABran-WMFT417966 GerritHAProxyBackendUnavailable
 ResolvedABran-WMFT417247 Reimage gerrit2002
 ResolvedABran-WMFT418242 SystemdUnitFailed - rsync-lfs_replica_sync.service on gerrit2002:9100
 ResolvedABran-WMFT418264 Fix gerrit-restart cookbook
 ResolvedABran-WMFT418266 GerritHAProxyServiceUnavailable
 ResolvedABran-WMFT418240 GerritReplicationUnavailable
 ResolvedABran-WMFT417279 Harmonize DNS on all gerrit instances
 ResolvedABran-WMFT417565 GerritHAProxyBackendUnavailable
 ResolvedABran-WMFT417566 GerritHAProxyServiceUnavailable
 ResolvedDzahnT372804 setup gerrit2003 with gerrit service (gerrit on bookworm)
 ResolvedABran-WMFT338470 Rename gerrit2 unix user to gerrit and assign a fixed uid
 ResolvedDzahnT379213 PuppetFailure - gerrit2003
 OpenNoneT417642 Rename gerrit2 Gerrit user to gerrit in the administrator group
 ResolvedJeltoT333143 Move Gerrit data out of root partition
 OpenNoneT424172 gerrit: document replication re-runs to Github
 ResolvedJeltoT424924 GerritHAProxyBackendUnavailable
 ResolvedMarosteguiT388785 SSH on gerrit2003 is CRITICAL: CRITICAL
 ResolvedDzahnT374899 PuppetFailure - gerrit2003
 OpenNoneT257317 scap deploy --init on deployment server fails on first puppet run
Restricted Task
 ResolvedDzahnT402847 ProbeDown - gerrit1003
 ResolvedABran-WMFT403347 ProbeDown
 ResolvedABran-WMFT403963 ProbeDown - http_gerrit_tls_ip4 gerrit2003
 ResolvedABran-WMFT404070 ProbeDown - http_gerrit_tls_ip4 gerrit2003.
Restricted Task
Restricted Task

Event Timeline

hashar created this task.Apr 23 2025, 7:24 AM
Restricted Application added a subscriber: Aklapper. · View Herald TranscriptApr 23 2025, 7:24 AM
hashar added a comment.EditedApr 23 2025, 7:28 AM

Since:

  • Gerrit 3.12 drops support for Java 17 and requires Java 21
  • Debian Bookworm provides Java 17
  • Debian Trixie will provide Java 21

My guess is we will have to either:

  • reimage the Gerrit servers to Debian Trixie with a forward port of Java 17 then switch to java 21
  • Backport Java 21 to Bookworm and switch Java on the existing server (and reimage later).

Jenkins might drop support for Java 17 at some point at the end of 2025 (can be checked at https://www.jenkins.io/doc/book/platform-information/support-policy-java/ ).

we had an early backport done though:

In T367487#9897565, @MoritzMuehlenhoff wrote:

A preliminary backport of Java 21 is now available in component/jdk21, it can already be used to build CAS 7.0.
(It's preliminary package since I had to use a bootstrap package (Bookworm has Java 17, but Java 21 needs Java 20/21 to build, while Java 20 needs Java 19/20 to build etc. pp). Now that the bootstrap dep is imported to the component,I'll next rebuild openjdk-21 using this bootstrap package)

But I think it is fine to wait for Debian Trixie and an "official" backport.

hashar added a subscriber: MoritzMuehlenhoff.Apr 23 2025, 7:30 AM
MoritzMuehlenhoff added a comment.Apr 23 2025, 7:42 AM

We have a maintained Java 21 backport for Bookworm! It was needed for Apereo CAS which also requires Java 21 and can be found in component/jdk21

As such, I'd propose the following plan instead:

  • Reimage Gerrit servers to Bookworm (Gerrit already uses Java 17 and Bookworm provides it natively)
  • Switch to Java 21 with the move to Gerrit 3.12
  • And when you move to Trixie later, it'll only come with Java 21 anyway
hashar mentioned this in T392464: Upgrade Gerrit hosts from Bullseye to Bookworm.Apr 23 2025, 9:11 AM
hashar added a comment.Apr 23 2025, 9:14 AM

I have filed T392464: Upgrade Gerrit hosts from Bullseye to Bookworm to upgrade to Bookworm :-]

Before or after that we can upgrade to Gerrit 3.11 T379714. Once we have both 3.11 and Bookworm we can switch to Java 21 and after that upgrade to 3.12 (T392448)

hashar added a subtask: T392465: Switch Gerrit from Java 17 to Java 21.Apr 23 2025, 9:25 AM
hashar added a subtask: T379714: Upgrade to Gerrit 3.11.Apr 28 2025, 12:52 PM
ABran-WMF updated the task description. (Show Details)Jun 2 2025, 3:49 PM
hashar updated the task description. (Show Details)Aug 11 2025, 7:14 AM
hashar mentioned this in Gerrit (Gerrit 3.12).Feb 21 2026, 4:19 PM
hashar updated the task description. (Show Details)Feb 21 2026, 4:25 PM
hashar updated the task description. (Show Details)Feb 21 2026, 4:28 PM
hashar updated the task description. (Show Details)Feb 21 2026, 4:33 PM
hashar updated the task description. (Show Details)
hashar updated the task description. (Show Details)Feb 21 2026, 4:36 PM
hashar updated the task description. (Show Details)Feb 21 2026, 4:42 PM

The Checks API has no change (git diff -U0 origin/stable-{3.11,3.12} polygerrit-ui/app/api/checks.ts)

Paladox subscribed.Feb 21 2026, 4:54 PM
ABran-WMF added a subtask: Restricted Task.Mar 23 2026, 6:57 AM
ABran-WMF added a subtask: Restricted Task.Mar 23 2026, 1:24 PM
hashar removed subtasks: Restricted Task, Restricted Task.Mar 24 2026, 10:44 AM
hashar added a subscriber: ABran-WMF.Mar 24 2026, 10:50 AM

@ABran-WMF I have removed the subtasks since they are not blockers for the 3.12 upgrade.

T420822 will be resolved once we upgrade rather than blocking it, it is already marked with Gerrit (Gerrit 3.12) ;-)

Content licensed under Creative Commons Attribution-ShareAlike (CC BY-SA) 4.0 unless otherwise noted; code licensed under GNU General Public License (GPL) 2.0 or later and other open source licenses. By using this site, you agree to the Terms of Use, Privacy Policy, and Code of Conduct. · Wikimedia Foundation · Privacy Policy · Code of Conduct · Terms of Use · Disclaimer · CC-BY-SA · GPL · Credits