Замена WordPress на статику без даунтайма: пусть побеждает старший маршрут
Маркетинговый сайт переехал с WordPress на статический экспорт. Правила конфликтов Gateway API позволили новому маршруту стоять рядом со старым без трафика, пока один коммит не отпустил хостнейм.
Маркетинговый сайт компании работал как WordPress в Kubernetes, за Gateway API и Argo CD. Замену разработчик прислал тарболом — статическим экспортом. «Просто поменять образ» звучало легко. Разведка показала три причины, почему нет.
- «Статический» экспорт был не совсем статическим: формы заявок отправлялись в маленький PHP-скрипт, которому нужны были SMTP-учётные данные, а их на стороне разработки никто не знал.
- Второй хостнейм, алиас, обслуживался тем же подом WordPress, и в экспорт его не включили.
- Чарт WordPress выводил всё (пути в Vault, имя базы, имя приложения в Argo CD) из хостнейма. Смена хоста или образа у существующего приложения имела огромный blast radius.
Механизм: побеждает старший маршрут
В Gateway API, когда два HTTPRoute претендуют на один хостнейм и путь, побеждает более старый — по creationTimestamp. Значит, новый маршрут на тот же хост можно добавить безопасно: он принят и не получает трафика, пока старый не отпустит хост.
Это дало переключение в два коммита:
- Статическое приложение заявляет хостнейм. WordPress всё ещё побеждает по возрасту. Проверил по отпечатку: WordPress отдаёт
x-powered-byиlink: </wp-json/>, статика — нет. - Элемент 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-приложение — регулярка, а не префикс, и проверка чтением отрендеренного объекта обратно.