Dağıtım

Bu rehber, Observer’ı ekibinizin kullanabileceği bir sunucuya kurma sürecinde size yol gösterir. Derin teknik bilgiye ihtiyacınız yok — bir sunucuya SSH ile bağlanıp birkaç komut çalıştırabiliyorsanız, bunu yapabilirsiniz.

Docker (önerilen)#

Bu en basit yoldur. Observer, web arayüzü zaten dahil edilmiş tek bir Docker imajı olarak sunulur — ön yüz tarafında kurulacak veya yapılandırılacak ekstra bir şey yoktur.

Gerekenler#

• Docker ve Docker Compose kurulu bir sunucu
• Sunucunuza yönlendirilmiş bir alan adı (HTTPS için)

Adım 1: İmzalama anahtarlarını oluşturun#

Observer, giriş token’larını imzalamak için RSA anahtarları kullanır. Bunları oluşturmak için sunucunuzda şu komutları çalıştırın:

mkdir -p keys
openssl genrsa -out keys/jwt_rsa 4096
openssl rsa -in keys/jwt_rsa -pubout -out keys/jwt_rsa.pub

Bu anahtarları güvende tutun. Kaybederseniz, herkesin yeniden giriş yapması gerekir.

Adım 2: Ortamınızı yapılandırın#

Örnek ortam dosyasını kopyalayın ve kurulumunuza göre düzenleyin:

cp .env.example .env

En önemli değişkenler:

Tam liste için Ortam Değişkenleri sayfasına bakın.

Adım 3: Observer’ı başlatın#

docker compose up -d

Bu, PostgreSQL, Redis ve Observer’ı başlatır. Veritabanı şeması ilk başlatmada otomatik olarak oluşturulur — manuel migration adımı gerekmez.

Adım 4: Çalıştığını doğrulayın#

curl http://localhost:9000/health

Şunu görmelisiniz:

{ "status": "healthy", "timestamp": "..." }

Bunu görüyorsanız, Observer hazırdır. Web arayüzüne erişmek için alan adınızı tarayıcıda açın.

Docker olmadan (VPS / bare metal)#

Observer’ı doğrudan çalıştırmayı tercih ederseniz, binary’yi derleyin:

CGO_ENABLED=0 go build -tags production -ldflags="-s -w" -o observer ./cmd/observer

-tags production bayrağı, web arayüzünü binary’ye gömer. Her yere kopyalayabileceğiniz tek bir dosya elde edersiniz.

Çalıştırın:

./observer serve --host 0.0.0.0

PostgreSQL ve Redis’in ayrıca çalışıyor olması gerekir. DATABASE_DSN ve REDIS_URL değişkenlerini onlara yönlendirin.

HTTPS kurulumu#

Observer’ı her zaman HTTPS’yi yöneten bir reverse proxy arkasında çalıştırmalısınız. Bu, giriş kimlik bilgilerinin ve kişisel verilerin aktarım sırasında şifrelenmesini sağlar.

Caddy en kolay seçenektir — sertifikaları otomatik olarak yönetir:

observer.yourorg.org {
    reverse_proxy localhost:9000
}

Nginx veya başka bir proxy kullanıyorsanız, şunları ayarladığınızdan emin olun:

• Ortamınızda COOKIE_SECURE=true
• CORS_ORIGINS değerini gerçek alan adınıza ayarlayın (ör. https://observer.yourorg.org)