Add comprehensive installation and operational documentation for Neta

- Introduced "Kurulum Modları" to explain full-stack and app-only installation options.
- Created detailed guides for "Full-Stack Kurulum", "Coolify Kurulumu", "Dokploy Kurulumu", and "App-Only Kurulum".
- Documented the process for creating the first admin account and the registration lock mechanism.
- Added operational guidelines covering health checks, backups, restores, and logging.
- Explained environment variables used in Neta installations and their significance.
- Provided troubleshooting tips for common issues encountered during setup and operation.
- Outlined security measures and limitations of the MVP self-host model.
This commit is contained in:
Poyraz Avsever
2026-06-14 11:12:52 +03:00
parent 32e00a163e
commit 03b03d253d
13 changed files with 1745 additions and 0 deletions
+153
View File
@@ -0,0 +1,153 @@
---
title: Operasyon
description: Sağlık kontrolü, yedekleme ve geri yükleme işlemleri.
order: 10
---
# Operasyon
Neta self-host kurulumunda operasyonel bakımın temel başlıkları sağlık kontrolü, yedekleme, geri yükleme, log takibi ve güncelleme öncesi hazırlıktır.
## Sağlık Kontrolü
Full-stack kurulumda servislerin doğru çalıştığını kontrol etmek için:
```bash
sh ./scripts/selfhost-doctor.sh
```
Bu script şunları doğrular:
- Docker daemon erişilebilir mi?
- Gerekli containerlar çalışıyor mu?
- `neta-migrations` başarıyla tamamlandı mı?
- `neta-db` healthy durumda mı?
- `neta-web` healthy durumda mı?
- `neta-supabase-proxy` healthy durumda mı?
- Web health endpointi cevap veriyor mu?
- Supabase proxy health endpointi cevap veriyor mu?
- Auth settings endpointi çalışıyor mu?
- Neta tabloları veritabanında var mı?
## Auth Smoke Test
Gerçek Auth akışını test etmek için:
```bash
NETA_DOCTOR_AUTH_SMOKE=1 sh ./scripts/selfhost-doctor.sh
```
Bu kontrol, temiz kurulumda signup ve password login akışını test eder.
Dikkat: Temiz kurulumda bu işlem test kullanıcısı oluşturabilir. İlk admin hesabını manuel oluşturmak istiyorsan bu opsiyonu kullanmadan önce planlı hareket et.
## Yedek Alma
Full-stack modda yedek almak için:
```bash
sh ./scripts/selfhost-backup.sh
```
Yedekler varsayılan olarak şu dizine yazılır:
```text
./backups/<timestamp>/
```
Yedek içeriği:
- `postgres.dump`
- `storage.tar.gz`
- `manifest.txt`
## Farklı Yedek Dizini Kullanma
```bash
NETA_BACKUP_DIR=/path/to/backups sh ./scripts/selfhost-backup.sh
```
Bu yöntem, yedekleri ayrı bir disk veya mount üzerine yazmak için kullanılabilir.
## Geri Yükleme
Bir yedeği geri yüklemek için:
```bash
sh ./scripts/selfhost-restore.sh ./backups/20260101T120000Z
```
Script geri yükleme öncesinde onay ister.
Otomatik veya non-interactive geri yükleme için:
```bash
NETA_RESTORE_FORCE=1 sh ./scripts/selfhost-restore.sh ./backups/20260101T120000Z
```
## Docker Volume Yapısı
Full-stack modda kalıcı veriler Docker volume içinde tutulur:
- `neta-db-data`: PostgreSQL verileri
- `neta-storage-data`: Storage dosyaları
Bu volume'lar silinirse veriler kaybolur.
Şu komut production ortamında dikkatli kullanılmalıdır:
```bash
docker compose -f docker-compose.full.yml down -v
```
Çünkü `-v` parametresi volume'ları siler.
## Log Takibi
Servis loglarını görmek için:
```bash
docker logs neta-web
docker logs neta-auth
docker logs neta-db
docker logs neta-migrations
docker logs neta-supabase-proxy
```
Kayıt, login veya migration sorunlarında özellikle şu loglar önemlidir:
- `neta-auth`
- `neta-migrations`
- `neta-web`
## Güncelleme Öncesi Kontrol Listesi
Yeni sürüme geçmeden önce:
1. Yedek al.
2. Yedek dosyalarının oluştuğunu kontrol et.
3. Mevcut `.env` dosyasını sakla.
4. Yeni sürüm notlarını oku.
5. Deploy sonrası `selfhost-doctor.sh` çalıştır.
Önerilen akış:
```bash
sh ./scripts/selfhost-backup.sh
git pull
docker compose -f docker-compose.full.yml up -d --build
sh ./scripts/selfhost-doctor.sh
```
## Production Notları
MVP full-stack kurulum tek sunucu kullanımına uygundur. Kritik production ortamlarında ek olarak şunlar önerilir:
- Düzenli harici yedek
- HTTPS
- Firewall
- Güçlü secret değerleri
- Sunucu disk izleme
- Log izleme
- Geri yükleme testleri