Backstage

Backstage to framework do budowy wewnętrznych portali developerskich (IDP). Skupia w jednym miejscu katalog serwisów, dokumentację (TechDocs), szablony scaffoldingu i wtyczki do narzędzi. Kluczowe: encje opisujesz jako pliki catalog-info.yaml w repozytoriach, więc katalog organizacji jest „as-code” — wersjonowany i utrzymywany razem z kodem usług.

Kiedy używać

• Masz wiele serwisów/zespołów i chcesz jednego źródła wiedzy o nich.
• Standaryzujesz zakładanie nowych projektów (Software Templates).
• Chcesz, by katalog i dokumentacja żyły w repo, nie w wiki.

Przykład użycia

# catalog-info.yaml w repo usługi
apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
  name: eiac-web
  annotations:
    backstage.io/techdocs-ref: dir:.
spec:
  type: website
  lifecycle: production
  owner: team-platform

Backstage zaciąga ten plik i pokazuje usługę w katalogu wraz z dokumentacją.

Warto wiedzieć

• Wymaga utrzymania (to aplikacja, nie SaaS), ale daje pełną kontrolę.
• Bogaty ekosystem wtyczek; integruje CI/CD, chmurę i obserwowalność.