Deconflictor
Находит, где изменения разных команд помешают друг другу, ещё до начала работ.Catches cross-team change collisions before rollout.
▶ Посмотреть демо▶ Watch the demo Как это работает →How it works →
Кому и зачемWho it is for
Deconflictor нужен компаниям, где десятки сервисов, много команд и всё время что-то меняется: выходят релизы, переносят данные, идут техработы, запускают эксперименты.
Deconflictor is for companies with dozens of services, many teams and changes all the time: releases, data migrations, maintenance, experiments.
Каждая команда планирует свои работы сама. Свои сервисы она знает. А вот что её сервис через две зависимости завязан на чужой и что у соседей на тот же вечер назначены свои работы, она не видит. Такие столкновения обычно находятся, когда что-то уже сломалось.
Each team plans its own work and knows its own services. What it doesn't see is that one of them depends, two hops away, on another team's service, and that team has planned work for the same evening. Collisions like that are usually found when something has already broken.
- Читает заявкуКоманда пишет, что и когда собирается менять, своими словами, как написала бы коллеге. Перечислять сервисы не обязательно.Reads the requestA team writes what it is going to change and when, in its own words, as it would tell a colleague. Listing the services is optional.
- Сверяет с картой зависимостей и календарём работЗнает, какие сервисы от каких зависят и какие работы у кого назначены.Checks the dependency map and the change calendarIt knows which services depend on which, and what work is planned where.
- Находит, объясняет, советуетПоказывает, кто кому помешает и почему. Советует одобрить изменение или отклонить его, а если без человека не разобраться, так и говорит. Если изменение не проходит, предлагает окно, в которое оно пройдёт без помех.Finds, explains, advisesIt shows who will get in whose way and why. It recommends approving the change or rejecting it, and says so when a person has to decide. When a change does not pass, it proposes a window in which it would go through undisturbed.
Решают люди: по умолчанию сервис только советует.People decide: by default the service only advises.
Пример: интернет-магазинAn example: an online shop
В каталоге магазина у каждого сервиса записана команда, которая за него отвечает. Вот четыре команды, их сервисы и планы на пятницу:In the shop's catalog every service has an owning team. Here are four teams, their services and their plans for Friday:
Витрина (фронтенд)Storefront (frontend)
3 сервиса3 services
- frontend-proxyвход на сайтthe entry point
- frontendстраницы магазинаthe shop's pages
- image-providerкартинкиimages
План: A/B-тест главной страницы, пт 18:00–20:00Plan: an A/B test of the front page, Fri 18:00–20:00
Каталог и рекомендации (бэкенд)Catalog and recommendations (backend)
3 сервиса3 services
- product-catalogкаталог товаровthe product catalog
- recommendationрекомендацииrecommendations
- adрекламаads
Заказы и оплата (бэкенд)Orders and payment (backend)
4 сервиса4 services
- cartкорзинаthe cart
- checkoutоформление заказаplacing an order
- paymentоплатаpayment
- currencyкурсы валютexchange rates
План: релиз currency, пт 16:00–17:30Plan: a currency deploy, Fri 16:00–17:30
ПлатформаPlatform
данные и общие сервисыdata and shared services
Данные: база, очередь, кэшData: a database, a queue, a cache
- astronomy-dbбаза данныхthe database
- kafkaочередь сообщенийthe message queue
- valkey-cartкэш корзиныthe cart's cache
Общие сервисы: фичефлаги (переключатели функций), сбор телеметрииShared: feature flags, telemetry
- flagdфичефлагиfeature flags
- otel-collectorсбор телеметрииcollects telemetry
План: обновление базы, пт 17:00–21:00Plan: a database upgrade, Fri 17:00–21:00
Ещё две команды, доставка и финансы, и три служебных сервиса платформы здесь не показаны: всего 8 сервисов.Two more teams, delivery and finance, and three auxiliary platform services are not shown here: 8 services in all.
Витрина берёт товары из каталога, а каталог хранит их в базе. От витрины до базы два шага по зависимостям, и команда витрины о базе обычно не думает:The storefront takes its products from the catalog, and the catalog keeps them in the database. The database is two hops from the storefront, and the storefront team rarely thinks about it:
frontend→product-catalog→astronomy-db
В пятницу команда платформы обновляет базу с 17:00 до 21:00. Команда витрины об этом не знает и ставит A/B-тест на тот же вечер, с 18:00 до 20:00. Если всё пойдёт по плану, тест придётся на обновление базы: витрина может остаться без каталога, а результаты теста испортятся.On Friday the platform team upgrades the database from 17:00 to 21:00. The storefront team doesn't know and schedules its A/B test for the same evening, 18:00 to 20:00. If both go ahead as planned, the test runs during the upgrade: the storefront may lose its catalog, and the test's results are spoiled.
Deconflictor отметит тест как конфликт и покажет цепочку зависимостей. Релиз currency в тот же вечер с базой не связан, его Deconflictor пропустит.Deconflictor flags the test as a collision and shows the chain of dependencies. The currency deploy the same evening has nothing to do with the database, and Deconflictor lets it pass.
Узнали свою систему? Группы у вас будут свои: мобильное приложение, личный кабинет, платежи, склад. Карту зависимостей Deconflictor берёт из каталога сервисов (формат Backstage), а заявки команды пишут как обычно, словами.Recognize your own system? Your groups will be different: a mobile app, a customer account, payments, a warehouse. Deconflictor takes the dependency map from a service catalog (in Backstage format), and teams file their requests as they always do, in words.
Пример взят из открытого демо-магазина (OpenTelemetry Astronomy Shop), на нём же работает демо.The example is the open demo shop of OpenTelemetry (the Astronomy Shop); the demo runs on it too.
A/B-тест на морде в пятницу 18:00–20:00
A/B test on the storefront, Fri 18:00–20:00
«морда»“storefront”frontend
почему:frontend → product-catalog → astronomy-db, два шага, то же времяevidence:frontend → product-catalog → astronomy-db: 2 hops, same window
уведомить:автора заявкиnotify:the author
другое окно:сб 18:00–20:00another window:Sat 18:00–20:00
- Команда витрины пишет заявку своими словами, как написала бы коллеге. Список сервисов заполнять не нужно.The storefront team writes a request in its own words, as it would tell a colleague. There is no list of services to fill in.
- Разбор заявки (Intake), первая языковая модель совета, понимает, о каком сервисе речь: «мордой» на жаргоне называют главную страницу магазина, то есть frontend.Intake, the first language model of the council, works out which service the words mean: “storefront” → frontend.
- Код идёт по карте зависимостей: frontend зависит от product-catalog, тот берёт данные из базы astronomy-db. До базы два шага.Code walks the dependency map: frontend depends on product-catalog, and that on the astronomy-db database. Two hops.
- Код смотрит в календарь работ: у astronomy-db в пятницу с 17:00 до 21:00 техработы. Окна пересекаются.Code checks the change calendar: astronomy-db is in maintenance on Friday, 17:00 to 21:00. The windows overlap.
- Судья конфликтов (Conflict-judge) и оппонент (Challenger) взвешивают эту пару заявок, решение выносит код: отклонить, с доказательствами. Автор заявки получает уведомление, код находит окно, в которое тест пройдёт без помех, а председатель (Chair) его объясняет.Conflict-judge and Challenger weigh this pair of requests, and code decides: reject, with evidence. The author is notified, code finds a window in which the test would go through undisturbed, and the Chair explains it.
В разработке · код откроем позже под лицензией MIT · оценка качества идёт, цифр пока нетIn development · open source (MIT) later · evaluation in progress, no numbers yet