Page MenuHomePhabricator

Upgrade to Zuul 14.x
Closed, ResolvedPublic

Description

The newest version of Zuul is now 14.x. We should upgrade. The most notable change is the introduction of zuul-launcher which replaces nodepool.

  • Build new images via https://gitlab.wikimedia.org/repos/releng/zuul/zuul
  • Bump Zuul service image refs in puppet
  • Define zuul.conf connection for WMCS k8s (using existing nodepool kube config as reference)
  • Add provider configuration to integration/config (using existing nodepool.yaml as reference)
  • Deploy new zuul-launcher via Puppet
  • Ensure zuul-nodepool absent
  • Remove zuul-nodepool from Puppet

Related Objects

StatusSubtypeAssignedTask
ResolvedDzahn
Resolveddduvall

Event Timeline

dduvall changed the task status from Open to In Progress.Apr 29 2026, 5:18 PM
dduvall triaged this task as Medium priority.

Oh, nodepool is already deprecated before we get to use it? :p Ok!

Let me make some changes to take care of:

Ensure zuul-nodepool absent
Remove zuul-nodepool from Puppet

Change #1279461 had a related patch set uploaded (by Dzahn; author: Dzahn):

[operations/puppet@production] zuul: remove zuul-nodepool config, user, stop service

https://gerrit.wikimedia.org/r/1279461

Change #1279470 had a related patch set uploaded (by Dzahn; author: Dzahn):

[operations/puppet@production] zuul: create profile for new zuul-builder replacing nodepool

https://gerrit.wikimedia.org/r/1279470

Change #1279500 had a related patch set uploaded (by Dduvall; author: Dduvall):

[operations/puppet@production] zuul: Upgrade to Zuul 14.2.0

https://gerrit.wikimedia.org/r/1279500

Should I just remove nodepool any time or should it wait?

Change #1279500 merged by Dzahn:

[operations/puppet@production] zuul: Upgrade to Zuul 14.2.0

https://gerrit.wikimedia.org/r/1279500

restarted zuul-executor on zuul1002 after deploying version upgrade change:

Apr 30 15:09:19 zuul1002 docker[1886062]: 5e0b457beafe: Verifying Checksum
...
Apr 30 15:09:20 zuul1002 docker[1886062]: bc0c9b6444f9: Verifying Checksum
Apr 30 15:09:20 zuul1002 docker[1886062]: bc0c9b6444f9: Download complete
Apr 30 15:09:21 zuul1002 docker[1886062]: acf4d8e1c14d: Pull complete
Apr 30 15:09:21 zuul1002 docker[1886062]: 68a4a6c14700: Pull complete
...
Apr 30 15:10:33 zuul1002 docker[1886062]: Status: Downloaded newer image for docker-registry.wikimedia.org/repos/releng/zuul/zuul/zuul-executor@sha256:850a8d82ed9d0e20c43836b47d119281b8d>
[zuul1002:~] $ sudo docker ps
CONTAINER ID   IMAGE                                                                         COMMAND                  CREATED          STATUS          PORTS     NAMES
0c7a2e98b70d   docker-registry.wikimedia.org/repos/releng/zuul/zuul/zuul-executor:14.2.0-1   "/usr/bin/dumb-init …"   30 seconds ago   Up 26 seconds             zuul-executor

same for zuul-web and zuul-scheduler on zuul1001. restarted. pulled new images. docker ps showing new version:

[zuul1001:~] $ sudo docker ps
CONTAINER ID   IMAGE                                                                                 COMMAND                  CREATED         STATUS         PORTS                                       NAMES
dcaaf98c2ac5   docker-registry.wikimedia.org/repos/releng/zuul/zuul/zuul-scheduler:14.2.0-1          "/usr/bin/dumb-init …"   9 seconds ago   Up 8 seconds                                               zuul-scheduler
d257668fcf8d   docker-registry.wikimedia.org/repos/releng/zuul/zuul/zuul-web:14.2.0-1                "/usr/bin/dumb-init …"   9 seconds ago   Up 8 seconds   0.0.0.0:9000->9000/tcp, :::9000->9000/tcp   zuul-web

Mentioned in SAL (#wikimedia-releng) [2026-04-30T15:19:10Z] <mutante> upgrading zuul to 14.2.0-1 on "new zuul" machines (T424879)

Change #1279461 merged by Dzahn:

[operations/puppet@production] zuul: remove zuul-nodepool config, user, stop service

https://gerrit.wikimedia.org/r/1279461

zuul-nodepool has been removed from zuul::main machines. (config, systemd unit, docker container not running, etc)

Change #1280729 had a related patch set uploaded (by Dzahn; author: Dzahn):

[labs/private@master] zuul: rename nodepool::user_token to launcher::user_token

https://gerrit.wikimedia.org/r/1280729

Change #1280729 merged by Dzahn:

[labs/private@master] zuul: rename nodepool::user_token to launcher::user_token

https://gerrit.wikimedia.org/r/1280729

Change #1279470 merged by Dzahn:

[operations/puppet@production] zuul: create profile for new zuul-launcher replacing nodepool

https://gerrit.wikimedia.org/r/1279470

Change #1280815 had a related patch set uploaded (by Dzahn; author: Dzahn):

[operations/puppet@production] zuul: remove nodepool profile from zuul::main role

https://gerrit.wikimedia.org/r/1280815

Change #1280815 merged by Dzahn:

[operations/puppet@production] zuul: remove nodepool profile from zuul::main role

https://gerrit.wikimedia.org/r/1280815

Change #1280820 had a related patch set uploaded (by Dzahn; author: Dzahn):

[operations/puppet@production] zuul: add placeholder template for launcher config

https://gerrit.wikimedia.org/r/1280820

Change #1280820 merged by Dzahn:

[operations/puppet@production] zuul: add placeholder template for launcher config

https://gerrit.wikimedia.org/r/1280820

Change #1280829 had a related patch set uploaded (by Dzahn; author: Dzahn):

[operations/puppet@production] zuul: rename zuul-nodepool systemd template to zuul-launcher, adjust it

https://gerrit.wikimedia.org/r/1280829

Change #1280829 merged by Dzahn:

[operations/puppet@production] zuul: rename zuul-nodepool systemd template to zuul-launcher, adjust it

https://gerrit.wikimedia.org/r/1280829

Change #1280832 had a related patch set uploaded (by Dzahn; author: Dzahn):

[operations/puppet@production] zuul: remove nodepool-related code

https://gerrit.wikimedia.org/r/1280832

Change #1280832 merged by Dzahn:

[operations/puppet@production] zuul: remove nodepool-related code

https://gerrit.wikimedia.org/r/1280832

Change #1280840 had a related patch set uploaded (by Dzahn; author: Dzahn):

[operations/puppet@production] zuul: update zuul-launcher version to 14.2.0-1

https://gerrit.wikimedia.org/r/1280840

Change #1280840 merged by Dzahn:

[operations/puppet@production] zuul: update zuul-launcher version to 14.2.0-1

https://gerrit.wikimedia.org/r/1280840

Change #1281536 had a related patch set uploaded (by Dduvall; author: Dduvall):

[operations/puppet@production] zuul: Mount /etc/zuul and /etc/zuul-launcher for zuul-launcher

https://gerrit.wikimedia.org/r/1281536

Change #1281536 merged by Dzahn:

[operations/puppet@production] zuul: Mount /etc/zuul and /etc/zuul-launcher for zuul-launcher

https://gerrit.wikimedia.org/r/1281536

Change #1281595 had a related patch set uploaded (by Dzahn; author: Dzahn):

[operations/puppet@production] zuul: add launcher_connection Hiera key to executor role

https://gerrit.wikimedia.org/r/1281595

Change #1281595 merged by Dzahn:

[operations/puppet@production] zuul: add launcher_connection Hiera key to executor role

https://gerrit.wikimedia.org/r/1281595

Change #1283098 had a related patch set uploaded (by Dduvall; author: Dduvall):

[integration/config@master] zuul: Define a WMCS/untrusted section and provider

https://gerrit.wikimedia.org/r/1283098

Change #1283098 merged by jenkins-bot:

[integration/config@master] zuul: Define a WMCS/untrusted section and provider

https://gerrit.wikimedia.org/r/1283098

dduvall updated the task description. (Show Details)

Change #1306122 had a related patch set uploaded (by Hashar; author: Hashar):

[operations/puppet@production] zuul: disable nodepool fallback

https://gerrit.wikimedia.org/r/1306122

Change #1306122 merged by Dzahn:

[operations/puppet@production] zuul: disable nodepool fallback

https://gerrit.wikimedia.org/r/1306122