Platform Engineering 2026: Internal Developer Platform (IDP) Nedir? Backstage, Golden Path ve Kubernetes Rehberi

Platform Engineering vs DevOps: Temel Fark

• DevOps: Geliştirici kendi pipeline'ını, Kubernetes config'ini, monitoring kurulumunu kendisi yapıyor. "You build it, you run it" felsefesi.
• Platform Engineering: Merkezi platform ekibi bu araçları ve süreçleri hazır hale getirir. Geliştirici sadece ne istediğini belirtir — platform gerisi halleder.

IDP'nin Sunduğu Değer / Value Provided by IDP

• ✅ Altyapı karmaşıklığını gizler (hides infrastructure complexity)
• ✅ Güvenli "golden path"ler sunar (provides secure golden paths)
• ✅ Geliştirici deneyimini standartlaştırır (standardizes developer experience)
• ✅ Güvenlik politikalarını otomatik uygular (auto-enforces security policies)
• ✅ Yeni servis oluşturmayı dakikalara indirir (reduces new service creation to minutes)

IDP Temel Bileşenleri / IDP Core Building Blocks

1. Developer Portal (Geliştirici Portalı)
   Genellikle Backstage ile kurulur. Servis kataloğu (service catalog), dokümantasyon ve self-servis araçlar burada.
2. Service Catalog (Servis Kataloğu)
   Organizasyondaki tüm mikroservislerin, API'lerin ve altyapı bileşenlerinin merkezi listesi. Backstage'in en güçlü özelliği (Backstage's strongest feature).
3. Self-Service Workflows (Kendi Kendine Servis İş Akışları)
   Geliştiriciler yeni servis, veritabanı, CI/CD pipeline oluşturmak için ticket açmak zorunda kalmıyor — tek tıkla yapıyor (one-click provisioning).
4. Golden Paths (Altın Yollar)
   Organizasyonun onayladığı, güvenli ve standart geliştirme yolları. Kubernetes template'leri, CI/CD şablonları, güvenlik kuralları dahil.
5. Observability Stack (Gözlemlenebilirlik)
   Prometheus, Grafana, OpenTelemetry ile platform üzerindeki tüm servislerin izlenmesi. Monitoring dashboards önceden yapılandırılmış (pre-configured).

Backstage Kurulumu / Backstage Installation

# Node.js 20+ gerekli / Requires Node.js 20+
node --version

# npx ile Backstage projesi oluştur / Create Backstage project with npx
npx @backstage/create-app@latest

# Proje adı sor / Asks for project name:
# Enter the name of the app [required]: my-platform

# Kurulum tamamlanınca / After installation complete:
cd my-platform

# Geliştirme sunucusunu başlat / Start development server
yarn dev

# Tarayıcıda aç / Open in browser
# http://localhost:3000

Backstage Service Catalog Örneği / Service Catalog Example (catalog-info.yaml)

apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
  name: my-microservice
  description: Kullanıcı yönetim servisi / User management service
  tags:
    - nodejs
    - rest-api
  annotations:
    github.com/project-slug: my-org/my-microservice
    backstage.io/techdocs-ref: dir:.
spec:
  type: service
  lifecycle: production
  owner: team-backend
  system: user-platform

Örnek Golden Path: Yeni Mikroservis / Example Golden Path: New Microservice

• ✅ GitHub'da organizasyonun standart yapısıyla repo oluşturur (creates GitHub repo with org standard structure)
• ✅ CI/CD pipeline önceden yapılandırılmış gelir (pre-configured CI/CD pipeline)
• ✅ Kubernetes manifest dosyaları güvenlik politikalarıyla hazır (K8s manifests with security policies)
• ✅ Monitoring dashboard'ları otomatik bağlanır (monitoring dashboards auto-connected)
• ✅ Backstage kataloğuna otomatik eklenir (auto-added to Backstage catalog)
• ✅ Tüm bunlar 3 dakikadan kısa sürede (all in under 3 minutes)!

Minimal IDP Stack / Minimal IDP Technology Stack

# 1. Kubernetes cluster (minikube ile başlayabilirsiniz / start with minikube)
minikube start --cpus=4 --memory=8192

# 2. Backstage deployment
kubectl create namespace platform
kubectl apply -f backstage-deployment.yaml -n platform

# 3. ArgoCD ile GitOps (opsiyonel ama önerilen / optional but recommended)
kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

# 4. Prometheus + Grafana monitoring stack
helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm install monitoring prometheus-community/kube-prometheus-stack -n monitoring --create-namespace

# 5. Backstage'e Kubernetes entegrasyonu / Backstage Kubernetes integration
# backstage/app-config.yaml dosyasına ekle:
# kubernetes:
#   serviceLocatorMethod: {type: 'multiTenant'}
#   clusterLocatorMethods:
#     - type: 'config'
#       clusters:
#         - name: local
#           url: https://kubernetes.default.svc
#           authProvider: serviceAccount

DORA Metrikleri / DORA Metrics for Platform Engineering

• ? Deployment Frequency (Deployment Sıklığı): Günde kaç kez production'a deploy yapılıyor? Hedef: günde birden fazla (multiple times per day)
• ? Lead Time for Changes: Kod yazımından production'a kaç saat/gün? Hedef: <1 saat (less than 1 hour)
• ? Change Failure Rate: Deploymentların yüzde kaçı sorun çıkarıyor? Hedef: %5 altı (below 5%)
• ? Mean Time to Recovery (MTTR): Bir sorundan toparlanmak ne kadar sürüyor? Hedef: <1 saat