Backstage — это open-source платформа от Spotify для создания внутреннего портала разработчика. Проще говоря, это единая точка входа, где команда видит сервисы, документацию, пайплайны, ownership, API и инфраструктурные сущности. Для компаний с десятками и сотнями микросервисов Backstage помогает навести порядок и сократить время на поиск информации 🚀
Что такое Backstage
- Software Catalog — каталог сервисов, библиотек, сайтов, API, ресурсов Kubernetes и других сущностей
- IDP (Internal Developer Platform) — основа внутренней платформы разработки
- TechDocs — документация рядом с кодом
- Scaffolder — генерация новых сервисов по шаблонам
- Plugins — интеграции с GitHub, GitLab, Jira, Jenkins, ArgoCD, Kubernetes и др.
Зачем нужен Backstage
- Убирает хаос в микросервисной архитектуре
- Показывает, кто владелец сервиса, где репозиторий и как он деплоится
- Упрощает онбординг новых разработчиков
- Стандартизирует создание сервисов
- Снижает зависимость от “знаний в головах” 🧠
Как работает каталог сервисов
В центре Backstage — файл catalog-info.yaml. В нём описывается сущность:
- Component — сервис или библиотека
- API — описание API
- Resource — база данных, очередь, кластер
- System — группа сервисов
- Domain — бизнес-домен
- User / Group — команды и сотрудники
Пример минимального описания сервиса:
apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
name: payment-service
description: Сервис оплаты
spec:
type: service
owner: team-payments
lifecycle: production
После регистрации сущности Backstage начинает связывать её с документацией, CI/CD, зависимостями и инфраструктурой.
Быстрый старт
- Установить Node.js LTS и Yarn
- Создать проект: npx @backstage/create-app@latest
- Запустить локально: yarn dev
- Добавить интеграции с GitHub/GitLab
- Описать сервисы через catalog-info.yaml
- Подключить TechDocs и Scaffolder 🔧
Чем Backstage полезен как IDP
Backstage — это не просто витрина сервисов. На его базе строят полноценную Internal Developer Platform:
- шаблоны новых проектов
- golden paths для команд
- self-service доступ к инфраструктуре
- стандарты безопасности и observability
- единый UX для разработки и эксплуатации
Когда стоит внедрять
Backstage особенно полезен, если:
- у вас много команд и репозиториев
- микросервисы быстро растут
- сложно понять ownership
- документация разбросана
- нужен self-service для разработчиков 📚
Ограничения
Важно понимать: Backstage не решает проблемы сам по себе. Если в компании нет процессов ownership, шаблонов и культуры документации, портал не станет “волшебной кнопкой”. Он хорошо работает там, где нужна единая платформа поверх зрелой инженерной практики.
Backstage сегодня — один из самых популярных подходов к построению Developer Portal и IDP в enterprise и продуктовых компаниях. Это хороший выбор для тех, кто хочет сделать разработку быстрее, прозрачнее и удобнее ✅
👀 Ниже стоит посмотреть подборку каналов про IT — там много полезного про платформенную инженерию, DevOps, архитектуру и developer experience.