Патерн Strangler Fig

Міграємо моноліт поступово через фасад і нові компоненти, визначаючи умови безпечного або недоцільного застосування.

Ідея патерну

Strangler Fig — це патерн поступової заміни моноліту, за якого нова система поетапно перехоплює функціональність старої.

Назва походить від рослини-душителя: вона обвиває дерево, поступово займає його простір, а з часом старе дерево можна видалити. У програмній системі роль такого «обвиття» виконує фасад або маршрутизатор перед монолітом.

Замість схеми:

text

Клієнт → Новий застосунок

на початку з’являється:

text

javascript

const http = require("node:http");

const PORT = 3000;
const LEGACY_URL = "http://localhost:4000";
const CATALOG_URL = "http://localhost:4001";

function isCatalogRequest(request) {
  return request.method === "GET" &&
    request.url.startsWith("/api/products");
}

async function proxy(request, response, targetBaseUrl) {
  const targetUrl = new URL(request.url, targetBaseUrl);

  const headers = new Headers(request.headers);
  headers.set("x-forwarded-by", "strangler-facade");

  try {
    const upstreamResponse = await fetch(targetUrl, {
      method: request.method,
      headers,
      redirect: "manual"
    });

    response.writeHead(
      upstreamResponse.status,
      Object.fromEntries(upstreamResponse.headers)
    );

    const body = Buffer.from(await upstreamResponse.arrayBuffer());
    response.end(body);
  } catch (error) {
    console.error("Помилка проксіювання:", error.message);

    response.writeHead(502, {
      "content-type": "application/json; charset=utf-8"
    });

    response.end(JSON.stringify({
      error: "upstream_unavailable"
    }));
  }
}

const server = http.createServer(async (request, response) => {
  if (isCatalogRequest(request)) {
    // Новий компонент поступово приймає функціональність каталогу.
    await proxy(request, response, CATALOG_URL);
    return;
  }

  // Уся ще не мігрована функціональність залишається в моноліті.
  await proxy(request, response, LEGACY_URL);
});

server.listen(PORT, () => {
  console.log(`Фасад запущено на http://localhost:${PORT}`);
});

javascript

function shouldUseNewCatalog(request) {
  const rolloutPercentage = 10;
  const clientId = request.headers["x-client-id"] || "anonymous";

  // Стабільний розподіл утримує одного клієнта на одному маршруті.
  let hash = 0;

  for (const character of clientId) {
    hash = (hash * 31 + character.charCodeAt(0)) % 100;
  }

  return hash < rolloutPercentage;
}

Патерн Strangler Fig

Ідея патерну

Основна структура міграції

Вибір функціональної області

Фасад і маршрутизація

Мінімальний фасад на Node.js

Поступове ввімкнення

Сумісність контрактів

Робота з даними

Спільна база

Окрема база

Читання зі старої системи

Безпечний fallback

Перевірка результатів

План відкату

Коли патерн доречний

Коли патерн недоцільний

Типові помилки

Перенесення коду без визначення межі

Фасад із бізнес-логікою

Одночасне перенесення всіх функцій

Відсутність спостережуваності

Небезпечний fallback для записів

Залишення старого коду назавжди

Практичні критерії готовності

Підсумок