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:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user