Skip to content

KUBERNETES.tr.md

Latest commit

 

History

History
136 lines (101 loc) · 5.15 KB

KUBERNETES.tr.md

File metadata and controls

136 lines (101 loc) · 5.15 KB
Raw

Kubernetes

Türkçe · English

Aynı ürün, aynı mantık. Docker'da "aktif et" bir container yaratmaktı; Kubernetes'te StatefulSet'i 0 replikadan 1'e ölçeklemek. Kapalı motorun pod'u hiç yoktur — sıfır bellek, sıfır CPU.

Manifestler üretilir, elle yazılmaz

catalog.json tek yetki kaynağıdır. Compose ve Kubernetes aynı kaynaktan türetilir ki zamanla ayrışmasınlar.

python3 scripts/gen-k8s.py --with-secrets
kubectl apply -k k8s/base

Üretilenler:

Dosya İçerik
namespace.yaml databases-stack isim alanı
engine-<motor>.yaml StatefulSet (replicas: 0) + Service + PVC şablonu
controller.yaml Kontrol servisi + ServiceAccount + Role + RoleBinding
catalog-configmap.yaml Motor kataloğu (kontrol servisi bunu okur)
secret.yaml Parolalar — k8s/secrets/ altında, .gitignore içinde

--with-secrets vermezseniz secret.example.yaml üretilir (yer tutucularla).

Kontrol servisinin yetkisi

rules:
- apiGroups: ["apps"]
  resources: ["statefulsets", "statefulsets/scale"]
  verbs: ["get", "list", "watch", "patch", "update"]
- apiGroups: [""]
  resources: ["pods", "services"]
  verbs: ["get", "list", "watch"]

Docker kurulumunda kontrol servisi docker.socka bağlıdır — bu host üzerinde root'a eşdeğerdir. Kubernetes'te yetki yalnızca StatefulSet ölçekleme ile sınırlıdır. Güvenlik açısından K8s yolu belirgin şekilde daha iyidir.

Boyutlandırma K8s'te nasıl çalışır?

Mantık aynıdır, iki fark vardır:

1. Kapasite ölçümü. Docker'da host'un /proc/meminfo'su okunur. Kubernetes'te en büyük node'un allocatable belleği esas alınır — cluster'ın toplamı değil. Sebep: bir StatefulSet pod'u tek bir node'a sığmak zorundadır. Toplam RAM'e göre hesaplamak, hiçbir node'a sığmayan bir limit üretip pod'u sonsuza dek Pending durumunda bırakırdı.

2. Uygulama. Docker'da hesaplanan değerler state/tuning.enve yazılıp compose'a verilir. K8s'te aynı değerler doğrudan kaynağa uygulanır:

kubectl set resources statefulset/postgresql --limits=memory=3276Mi --requests=memory=3276Mi
kubectl set env       statefulset/postgresql POSTGRES_SHARED_BUFFERS=819MB ...
kubectl scale         statefulset/postgresql --replicas=1

Depolama

volumeClaimTemplates varsayılan StorageClass'ı kullanır. Kendi sınıfınızı vermek için k8s/base/engine-<motor>.yaml içine ekleyin:

  volumeClaimTemplates:
  - metadata:
      name: data
    spec:
      storageClassName: fast-ssd      # ← buraya
      accessModes: ["ReadWriteOnce"]

Boyutlar scripts/gen-k8s.py içindeki STORAGE sözlüğündedir; değiştirip yeniden üretin.

Kapsam dışı olanlar

Üretilen manifestler veritabanlarını ve kontrol düzlemini kapsar. Şunlar Docker kurulumundadır ama K8s tarafına dahil edilmemiştir:

  • Web panelleri (phpMyAdmin, pgAdmin, Kibana…) — kendi Deployment'ları gerekir; K8s'te genelde Ingress arkasında ayrı yönetilir
  • Gateway/TLS — K8s'te bu iş Ingress Controller + cert-manager'ın işidir
  • Yedekleme cron'ları — CronJob olarak yazılmalıdır

Bunları eklemek isterseniz scripts/gen-k8s.py genişletilebilir; katalogda gereken bilgi (panel adı, port, servis) zaten mevcuttur.

Üretim için öneriler

  • Sırlar: secret.yamlı git'e koymayın. sealed-secrets, external-secrets ya da Vault kullanın.
  • Gerçek yüksek erişilebilirlik istiyorsanız operatörlere bakın: CloudNativePG (PostgreSQL), Strimzi (Kafka), ECK (Elasticsearch), Percona/MongoDB Operator. Bu ürünün StatefulSet'leri tek instance içindir.
  • Anti-affinity ve PodDisruptionBudget çok node'lu cluster'da eklenmelidir.

Aynı makinede hem Docker yığını hem k3s çalıştırmayın

Ürünü denemek için aynı sunucuya k3s kurmak cazip görünür, ama k3s yayınlanan 80 ve 443 portlarını Docker'dan kapar. Sebep, iptables nat/PREROUTING zincirinde KUBE-SERVICES ve CNI-HOSTPORT-DNAT kurallarının DOCKER zincirinden önce gelmesidir: paket gateway'e hiç ulaşmadan Traefik'e yönlenir.

Belirti kafa karıştırıcıdır — her şey sağlıklı görünür:

  • docker ps → gateway "Up (healthy)"
  • docker exec gateway nginx -t → geçerli
  • docker exec gateway curl http://127.0.0.1/ → 200
  • ama tarayıcıda düz metin 404 page not found (Traefik'in cevabı)

./stack.sh doctor bu durumu artık işlevsel olarak yakalar: container içinden ve dışarıdan gelen cevabı karşılaştırır.

Önemli: systemctl stop k3s bu sorunu ÇÖZMEZ. k3s durunca pod'ları containerd altında yaşamaya devam eder ve iptables kuralları yerinde kalır. Gerçekten temizlemek için:

sudo /usr/local/bin/k3s-killall.sh     # pod'ları öldürür, iptables kurallarını temizler
sudo systemctl disable --now k3s       # yeniden başlatmada geri gelmesin
docker restart gateway

k3s'i tamamen kaldırmak için sudo /usr/local/bin/k3s-uninstall.sh.

Doğru yaklaşım: Docker kurulumu ve Kubernetes kurulumu ayrı makinelerde olsun. İkisi aynı katalogdan beslenir, ama aynı host'un ağ yığınını paylaşamaz.