Kurulum

• Docker olan bir makine. Docker Compose gerekmiyor; isterseniz kullanabilirsiniz (aşağıda).
• openssl — ya da 32 bayt rastgele üretebilen başka bir araç.
• Docker Hub erişimi — nairotech/yeke imajı herkese açık ve multi-arch (amd64 + arm64).

Ayrı bir web container'ı ve önünde bir reverse proxy artık yok. Arayüz, API ve agent tüneli aynı süreçten, aynı porttan geliyor — kurulacak tek şey bu imaj.

docker run -d --name yeke --restart unless-stopped -p 8080:8080 \
  -v yeke-data:/var/lib/yeke \
  -e YEKE_SNAPSHOT_KEY="$(openssl rand -hex 32)" \
  nairotech/yeke:0.7.3

Sürüm etiketini sabitleyin, latest yazmayın: core'un sürümü, cluster'ınıza kurulacak agent imajının etiketini de belirliyor. Etiket kayarsa agent protokol uyuşmazlığına düşer. Yayındaki etiketler Docker Hub'da.

Açılmasını bekleyin

/healthz kimlik istemez, veritabanına dokunmaz; hazır olmanın en ucuz ölçütü odur. Birkaç saniye sürer:

until curl -sf http://localhost:8080/healthz; do sleep 1; done

Bu komut {"status":"ok"} basıp çıkar. Container'ın kendi healthcheck'i yok, yani docker ps hiçbir zaman (healthy) yazmaz — beklenen davranış budur, kurulum hatası değil.

İlk yöneticiyi oluşturun

İlk açılışta hiç kullanıcı yoktur; core bir kurulum token'ı üretip log'a basar:

docker logs yeke 2>&1 | grep -A1 SETUP

http://localhost:8080/ adresini açın, token'ı yapıştırın, kullanıcı adı ve parola girin. Token 60 dakika geçerlidir ve bir kez kullanılır; süresi dolarsa docker restart yeke yenisini üretir.

docker inspect -f '{{range .Config.Env}}{{println .}}{{end}}' yeke | grep YEKE_SNAPSHOT_KEY

Önce anahtarı bir kez üretip dosyaya yazın:

install -d -m 700 /etc/yeke
[ -f /etc/yeke/snapshot.key ] || openssl rand -hex 32 > /etc/yeke/snapshot.key
chmod 600 /etc/yeke/snapshot.key

docker run -d --name yeke --restart unless-stopped \
  -p 8080:8080 \
  -v yeke-data:/var/lib/yeke \
  -v /etc/yeke/lisans.txt:/etc/yeke/lisans.txt:ro \
  -e YEKE_SNAPSHOT_KEY="$(cat /etc/yeke/snapshot.key)" \
  -e YEKE_PUBLIC_URL="https://yeke.ornek.com" \
  -e YEKE_ALLOWED_ORIGINS="https://yeke.ornek.com" \
  -e YEKE_LICENSE_PATH="/etc/yeke/lisans.txt" \
  nairotech/yeke:0.7.3

Son üç satır opsiyonel. Lisansınız yoksa ya da arayüzden yüklemek istiyorsanız YEKE_LICENSE_PATH satırını ve onun bağlama satırını birlikte silin. Yalnız birini silmek sessiz bir karışıklık üretiyor: olmayan bir dosyayı bağlamaya çalışan Docker o yola boş bir dizin yaratır, core dizini okuyamayıp lisansı reddeder ve Community'de çalışmaya devam eder — kurulum ayakta görünür, ama gerçek lisans dosyanızı sonradan o yola kopyalamak istediğinizde karşınıza çıkar.

Tabloda olmayan bir YEKE_* değişkeni tanımlamanız gerekmiyor. Üçü — YEKE_ALLOW_HEADER_IDENTITY, YEKE_DEV_USER, YEKE_DEV_GROUPS — kaldırıldı ve tanımlıysa core hiç açılmaz: kimlik doğrulamasının var oluş sebebi tam olarak bu üçünün kapatılmasıydı, sessizce yok saymak "hâlâ eskisi gibi çalışıyor" sanmanıza yol açardı.

• Bir cluster bağlayın — agent modu ya da doğrudan kubeconfig.
• Yetkiyi ayarlayın — kim hangi Kubernetes kimliğiyle yazacak.

docker inspect -f '{{range .Config.Env}}{{println .}}{{end}}' yeke | grep YEKE_SNAPSHOT_KEY
docker pull nairotech/yeke:<yeni-sürüm>
docker rm -f yeke
# ardından aynı run komutu: yeni etiket, AYNI anahtar

• Her güncelleme bir kesintidir. Veritabanı tek yazıcılı SQLite: eski core kapanmadan yenisi açılamaz. Üretimde ölçülen pencere ~60 saniye. Arayüzde tek satır metin değiştiren bir sürüm bile bu kesintiye tabidir — arayüz core'un imajının içinde.
• Göçler açılışta koşar ve core log'una schema vN satırını basar; güncellemenin başarısını tahminle değil oradan doğrulayın.
• Yedek — yeke-data volume'ü ile /etc/yeke dizini. İkisi birlikte kurulumun tamamıdır; anahtarsız bir veri yedeği işe yaramaz.

Docker Compose

Depoyu klonlamanız gerekmiyor — dosyanın tamamı bu:

services:
  core:
    image: nairotech/yeke:0.7.3
    ports:
      - "8080:8080"
    environment:
      YEKE_SNAPSHOT_KEY: ${YEKE_SNAPSHOT_KEY:?anahtar zorunlu}
      YEKE_PUBLIC_URL: ${YEKE_PUBLIC_URL:-}
    volumes:
      - core-data:/var/lib/yeke
    healthcheck:
      test: ["CMD", "node", "-e", "fetch('http://127.0.0.1:8080/healthz').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"]
      interval: 10s
      timeout: 3s
      retries: 5
      start_period: 10s
    restart: unless-stopped

volumes:
  core-data:

Anahtarı yanındaki .env dosyasına yazın ve docker compose up -d deyin. Bu yolda docker ps (healthy) gösterir — healthcheck imajın değil bu dosyanın parçası.

Kubernetes

Core'u bir cluster'ın içinde koşturmak destekleniyor ve manifest seti hazır: namespace, ReadWriteOnce PVC, tek Deployment (strategy: Recreate), Service ve standart Ingress. Anahtar manifestin içinde değildir, Secret'ı elle oluşturursunuz. Set kısa ama kuruma göre uyarlanması gereken alanlar taşıyor (host adı, StorageClass, Ingress sınıfı); isteyin, gönderelim.

Yönetilecek cluster'ın içine kurmak zorunda değilsiniz ve genelde istemezsiniz: YEKE'nin yönettiği cluster çöktüğünde onu düzeltecek arayüzün ayakta olması gerekir.