С ростом числа сервисов появляется невидимая, но дорогая проблема: систему целиком не знает уже никто. Где документация по сервису? Кто его владелец? Как его развернуть локально? Какие у него зависимости? Ответы живут в головах, личных заметках и переписках в чатах — и испаряются, когда человек уходит в отпуск или из компании.
Backstage от Spotify решает это как единый портал разработчика — точка входа во всю инженерную реальность компании. В его основе несколько идей, и каждая закрывает свою боль.
Software Catalog — каталог всех сервисов, библиотек и пайплайнов с явными владельцами. Открыв сервис, сразу видишь команду-хозяина, ссылки, зависимости и состояние. Вопрос «чье это и к кому идти» перестает быть квестом.
TechDocs — документация как код: она лежит в репозитории рядом с сервисом, ревьюится вместе с ним и автоматически публикуется в портал. Так docs перестают устаревать в отдельной вики, о которой все забыли.
Software Templates (scaffolder) — шаблоны для создания новых компонентов. Новый сервис заводится в пару кликов уже с преднастроенными CI/CD, линтерами, структурой и документацией. Это то, что называют «золотой тропой» (golden path): правильный путь становится самым простым.
Сверху — плагины: мониторинг, CI/CD, облачные ресурсы, feature flags и все, что важно команде, собирается в одном интерфейсе вместо десятка вкладок. Портал расширяется под инфраструктуру конкретной компании.
Внедрив Backstage, мы централизовали документацию, каталог и инструменты — онбординг новых разработчиков заметно ускорился, а «племенное знание» превратилось в доступный и живой каталог. Если сформулировать одной фразой: портал разработчика — это про то, чтобы находить, а не спрашивать.