Page MenuHomePhabricator

Configure mw-next-routing for the PHP 8.3 migration
Closed, ResolvedPublic

Description

In advance of the PHP 8.3 migration, we'll need to ensure that the presence of the PHP_ENGINE=8.3 Cookie value (to be set by the WikimediaEvents extension), results in requests being routed to the -next releases of mw-web and mw-api-ext.

Following the changes in T391421, the steps are slightly different than when we first introduced -next routing for the 8.1 migration (T377042):

  • Ensure mw-next-routing is wired into profile::trafficserver::backend as a trafficserver::lua_script resource. -- https://gerrit.wikimedia.org/r/1184914
  • Ensure mw-next-routing.lua is wired into the appropriate position (immediately after multi-dc.lua) in the plugin chains for the profile::trafficserver::backend::mapping_rules entries targeting mw-web and mw-api-ext. -- https://gerrit.wikimedia.org/r/1184915
  • Ensure mw-next-routing.lua.conf targets "PHP_ENGINE=8.3" via cookie_pattern -- This was done as part of the restructuring in https://gerrit.wikimedia.org/r/1154901.

Once all of these steps are complete, we're ready to enable external traffic routing to -next. This will involve setting enabled = true and load_fraction = 1.0 in mw-next-routing.lua.conf. Doing so should wait until shortly before we begin the external traffic ramp.

Event Timeline

Scott_French renamed this task from Configure mw-next-routing for PHP 8.3 to Configure mw-next-routing for the PHP 8.3 migration.Sep 3 2025, 6:53 PM
Scott_French updated the task description. (Show Details)

Change #1184914 had a related patch set uploaded (by Scott French; author: Scott French):

[operations/puppet@production] P:trafficserver::backend: add mw-next-routing

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

Change #1184915 had a related patch set uploaded (by Scott French; author: Scott French):

[operations/puppet@production] hieradata: add mw-next-routing to ATS tslua plugin chains

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

Scott_French changed the task status from Open to In Progress.Sep 4 2025, 7:25 PM
Scott_French triaged this task as Medium priority.
Scott_French updated the task description. (Show Details)

Change #1186520 had a related patch set uploaded (by Scott French; author: Scott French):

[operations/puppet@production] trafficserver: relax service lookup in mw-next-routing

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

Change #1186520 merged by Scott French:

[operations/puppet@production] trafficserver: relax service lookup in mw-next-routing

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

Change #1184914 merged by Scott French:

[operations/puppet@production] P:trafficserver::backend: add mw-next-routing

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

Mentioned in SAL (#wikimedia-operations) [2025-09-11T14:37:05Z] <swfrench-wmf> disabled puppet on A:cp - T403655

Change #1184915 merged by Scott French:

[operations/puppet@production] hieradata: add mw-next-routing to ATS tslua plugin chains

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

Mentioned in SAL (#wikimedia-operations) [2025-09-11T14:51:36Z] <swfrench-wmf> incrementally running puppet agent on A:cp - T403655

Since no further work is tracked here, I am going to resolve this. The remaining changes to mw-next-routing.lua.conf in the task description will happen during the final preparation for the production traffic migration - i.e., after -next releases are scaled up for the initial ramp and before the first bump to the cookie-enrollment sampling rate.