← Все статьи

Замена WordPress на статику без даунтайма: пусть побеждает старший маршрут

Маркетинговый сайт переехал с WordPress на статический экспорт. Правила конфликтов Gateway API позволили новому маршруту стоять рядом со старым без трафика, пока один коммит не отпустил хостнейм.

Маркетинговый сайт компании работал как WordPress в Kubernetes, за Gateway API и Argo CD. Замену разработчик прислал тарболом — статическим экспортом. «Просто поменять образ» звучало легко. Разведка показала три причины, почему нет.

  • «Статический» экспорт был не совсем статическим: формы заявок отправлялись в маленький PHP-скрипт, которому нужны были SMTP-учётные данные, а их на стороне разработки никто не знал.
  • Второй хостнейм, алиас, обслуживался тем же подом WordPress, и в экспорт его не включили.
  • Чарт WordPress выводил всё (пути в Vault, имя базы, имя приложения в Argo CD) из хостнейма. Смена хоста или образа у существующего приложения имела огромный blast radius.

Механизм: побеждает старший маршрут

В Gateway API, когда два HTTPRoute претендуют на один хостнейм и путь, побеждает более старый — по creationTimestamp. Значит, новый маршрут на тот же хост можно добавить безопасно: он принят и не получает трафика, пока старый не отпустит хост.

Это дало переключение в два коммита:

  1. Статическое приложение заявляет хостнейм. WordPress всё ещё побеждает по возрасту. Проверил по отпечатку: WordPress отдаёт x-powered-by и link: </wp-json/>, статика — нет.
  2. Элемент WordPress получает новое значение чарта serveHost: false: он перестаёт претендовать на основной хостнейм и оставляет себе только алиас. Хостнейм переходит к статическому маршруту.

Два коммита, а не один, чтобы Argo CD не применил их в неправильном порядке и не оставил дыру. Откат — git revert второго коммита: WordPress снова забирает хост на следующей синхронизации. Новое значение чарта по умолчанию true, и я доказал, что все остальные сайты рендерятся байт в байт так же.

До переключения: тёмный прогон

Статический образ — php:apache с вшитым экспортом, PHP запрещён везде, кроме обработчика форм. Отрендерил чарт с временным хостнеймом без DNS, применил вне Argo CD и проверил каждый путь через curl --resolve на адрес шлюза, на обоих листенерах. Внешний TLS-фронт ходит в шлюз по обычному HTTP, так что порт 80 — тоже реальный путь.

Алиас потерял стили

Сайт-алиас грузил CSS и один скрипт плагина с основного хостнейма, потому что siteurl в WordPress указывал туда. Перевод основного хоста на статику молча лишил алиас стилей. Фикс — узкий fallback со статического маршрута обратно в WordPress, причём регуляркой, а не префиксом:

^/wp-includes/(blocks|css)/[A-Za-z0-9/._-]+\.css$

Префиксный матч доходил до PHP в WordPress: /wp-includes/blocks/index.php отдавал 200.

Мелкие ловушки

  • Двойное экранирование. Регулярка, записанная в values.yaml как \\.css, после | quote остаётся буквальным обратным слэшем. Маршрут был Accepted и не матчил ничего. Читайте отрендеренный маршрут обратно из API.
  • Apache за TLS-фронтом строит Location: http://… для редиректов на слэш в конце каталога. Помогли DirectorySlash Off плюс rewrite на https://.
  • Приём конверта SMTP на Exchange ничего не доказывает. MAIL FROM и RCPT TO возвращают 250 для любого отправителя; Send-As проверяется только после DATA, по заголовку From. Оставил отправителя, с которым WordPress уже успешно работал.
  • Пароль SMTP взял из настроек плагина в живом WordPress: расшифровал внутри пода собственным кодом плагина и сразу отправил пайпом в vault kv put … password=-. В терминале он ни разу не появился. Экспорт назывался «до взлома», поэтому эти учётные данные считались скомпрометированными и были поставлены на ротацию.

Выводы

  • Правило Gateway API «побеждает старший маршрут» — бесплатный blue-green-переключатель: разверните новый маршрут рядом со старым, проверьте, потом отпустите старый.
  • Делите переключение на коммиты, каждое промежуточное состояние которых безопасно, особенно когда их применяет GitOps-контроллер.
  • «Статический» экспорт редко полностью статичен. Проверьте формы, алиасы и ассеты с других хостов до планирования.
  • Для fallback в PHP-приложение — регулярка, а не префикс, и проверка чтением отрендеренного объекта обратно.