Структура технической статьи для Хабра

Вердикт по теме

Тема тянет, но не в текущей формулировке. «Как мы перешли на новую очередь сообщений» — это ещё не статья, таких на Хабре десятки. Статьёй это становится за счёт вашей детали: миграция шла под нагрузкой, без окна простоя, и вы дважды откатывались. Вот это и есть материал — не переход, а два отката и то, что вы из них поняли.

Жанр

Постмортем с элементами сравнения. Не туториал: инструкция по настройке устареет через полгода и никому не нужна. Ценность — в решениях и их последствиях, а такое живёт дольше.

Два варианта захода

Вариант 1 (от цифры). «Мы дважды откатывали миграцию очереди на проде и в сумме потеряли одиннадцать часов. Оба раза — из-за вещи, которой нет в официальном руководстве по миграции. Рассказываю, что это было.» Работает, потому что сразу обещает конкретное знание и признаёт провал — на Хабре это читают.

Вариант 2 (от заблуждения). «Документация обещает миграцию без простоя. Формально она не врёт — но только если у вас нет отложенных сообщений старше суток. У нас их было четыреста тысяч.» Работает, потому что задевает тех, у кого такая же ситуация, а они об этом ещё не знают.

Структура

1. Контекст: что было до (2–3 абзаца)

Нагрузка, объём, требования по надёжности. Артефакт: схема старой архитектуры и таблица с цифрами — сообщений в секунду, средний и пиковый объём, требуемая задержка. Без цифр читатель не поймёт, применим ли ваш опыт к нему.

2. Почему решили переезжать (1–2 абзаца)

Короткий раздел, но обязательный: без него в комментариях первым же вопросом будет «а зачем вообще». Артефакт: не нужен.

3. План миграции, каким он был на бумаге (2 абзаца)

Здесь важно изложить план добросовестно, а не как заведомую глупость. Читатель должен согласиться, что план выглядел разумно, — иначе вся дальнейшая история про откаты превращается в «сами виноваты». Артефакт: диаграмма этапов.

4. Первый откат (3–4 абзаца) — ядро статьи

Что пошло не так, как заметили, сколько времени ушло на диагностику, как откатывались. Артефакт: график метрик в момент инцидента и фрагмент лога. Это самый ценный раздел, не экономьте на нём.

5. Второй откат и настоящая причина (3 абзаца)

Здесь раскрывается то, что вы обещали в заходе. Артефакт: код или конфиг, где пряталась проблема, до и после.

6. Как в итоге переехали (2 абзаца)

Артефакт: финальная схема и те же метрики, что в разделе 1, — чтобы сравнение было прямым.

7. Что бы сделали иначе (1–2 абзаца)

Без морализаторства и без списка «выводов» из пяти банальностей. Два-три конкретных пункта.

Что нужно добрать от вас

• Точные версии брокера — до и после. Без них половина читателей не поймёт, актуальна ли проблема.
• Цифры нагрузки: сообщений в секунду в среднем и в пике, размер сообщения.
• Сколько именно длился каждый откат и что в это время видели пользователи.
• Скриншот или экспорт графика метрик в момент первого инцидента.
• Фрагмент конфигурации, в которой была причина, — обезличенный.

Чего ждать в комментариях

• «Почему не рассмотрели альтернативу X?» — закройте заранее, одним абзацем в разделе 2. Это спросят обязательно.
• «У вас нагрузка маленькая, у нас такое не сработает.» — обезоруживается честными цифрами в разделе 1 и явной оговоркой о границах применимости.
• «Это же написано в документации.» — если про отложенные сообщения там действительно нет ни слова, дайте прямую ссылку на раздел и покажите, чего в нём нет.

Заголовки

• «Два отката миграции очереди: чего нет в руководстве по переезду»
• «Миграция без простоя, которая дважды закончилась простоем»
• «Четыреста тысяч отложенных сообщений против плана миграции»