RECURA | Программирование & IT

🌐

Nginx может маршрутизировать запросы по нескольким признакам одновременно

👁

map обычно используют для простого выбора значения по заголовку или URI. Но его можно связать с несколькими переменными и получить условную маршрутизацию без десятков location и if.

📝 Разделяем трафик по версии API

Например, часть клиентов ещё работает с /api/v1, а новые запросы должны уходить на отдельный upstream. Nginx выбирает upstream ещё до отправки запроса приложению. При этом само приложение не содержит логики переключения версий.

map $uri $api_backend {
    default     backend_v2;
    ~^/api/v1/  backend_v1;
    ~^/api/v2/  backend_v2;
}

upstream backend_v1 {
    server 10.0.1.10:8080;
}

upstream backend_v2 {
    server 10.0.1.11:8080;
}

server {
    location /api/ {
        proxy_pass http://$api_backend;
    }
}

📝 Добавляем заголовок клиента

Тот же механизм можно использовать для постепенного перевода отдельных клиентов на новую реализацию. Теперь X-Client-Version: beta отправляет API на новую версию, а остальные клиенты продолжают работать со старой.

map "$http_x_client_version:$uri" $backend {
    default                  backend_v1;
    ~^beta:/api/             backend_v2;
    ~^internal:/api/         backend_v2;
}

server {
    location /api/ {
        proxy_pass http://$backend;
    }
}

📝 Делаем управляемое переключение без изменения приложения

Особенно полезно вынести признак переключения в отдельную переменную. Тогда можно менять маршрут конфигурацией Nginx, не добавляя условную логику в код приложения.

map $http_x_canary $backend {
    default backend_main;
    "1"     backend_canary;
}

upstream backend_main {
    server 10.0.1.10:8080;
}

upstream backend_canary {
    server 10.0.1.20:8080;
}

server {
    location / {
        proxy_set_header X-Backend $backend;
        proxy_pass http://$backend;
    }
}

❗️ Так map превращается в небольшой слой маршрутизации: версии API, канареечные релизы, внутренние клиенты и миграции можно переключать на уровне Nginx, не распространяя эту логику по приложениям.

tags: #nginx #devops #разработка

🧭 @recura_tech 🌐 VK 🌐 MAX

Please open Telegram to view this post