Operasyon notları; sır/anahtar içermez. Artefakt:
ghcr.io/actos-dev/app:<tag> (imaj CI'da derlenir, GHCR'a itilir; sunucu yalnız çeker).
ssh -i ~/.ssh/florence_deploy_ed25519 root@37.140.242.25- Aynı sunucuda Actos projesi de çalışıyor (
actos_web3000,actos_api3100,actos_network). Dokunulmaz. - Florence:
florence_api(127.0.0.1:7055),florence_postgres(5433),florence_redis(5434),searxng(5435), ağ:florence_default. - Uygulama bu yüzden 127.0.0.1:3300'de yayınlanır (3000/3100 dolu).
- Nginx vhost'ları:
florencex.com.tr(web) veapi.florencex.com.tr(backend); TLS Certbot, gerçek IP içincloudflare-realip.conf.
main'e push →ci.yml(typecheck/lint/token/unit).- Sürüm
package.jsonversion'da; tag elle atılır:git tag vX.Y.Z && git push origin vX.Y.Z. deploy.ymltag'de:npm ci→npm run check→ imajı derler →ghcr.io/actos-dev/app:<tag>ve:latestolarak iter → SSH ile sunucudadocker pull+ container'ı yeniden başlatır →/api/health200 bekler → başarısızsa önceki imaja otomatik rollback.
NEXT_PUBLIC_* derleme anında gömülür; bu yüzden deploy workflow'daki
build-args tek kaynaktır (NEXT_PUBLIC_SITE_URL=https://florencex.com.tr,
NEXT_PUBLIC_PORTFOLIO_COMMISSION_RATE=0.001). Env dosyasında değiştirmek işe yaramaz.
| Sır | Zorunlu | Amaç |
|---|---|---|
DEPLOY_HOST |
evet | 37.140.242.25 |
DEPLOY_USER |
evet | root |
DEPLOY_SSH_KEY |
evet | deploy özel anahtarı |
DEPLOY_PORT |
hayır | varsayılan 22 |
| Değişken | Amaç |
|---|---|
API_BASE_URL |
BFF hedefi: http://florence_api:7055 |
NEXT_PUBLIC_SITE_URL |
canonical/sitemap (build-time; runtime'da zararsız) |
NEXT_PUBLIC_PORTFOLIO_COMMISSION_RATE |
komisyon oranı (backend ile aynı) |
SENTRY_DSN (ops.) |
hata raporlama |
Container --network florence_default --env-file /etc/florence/app.env -p 127.0.0.1:3300:3000.
/→http://127.0.0.1:3300(Next)./api/→http://127.0.0.1:3300(BFF). Backend'e doğrudan gönderilmez;refresh_tokençerezipath=/api/v1/autholduğu için BFF tarayıcının gördüğü origin'de olmalı./avatars/→http://127.0.0.1:7055(backend StaticFiles) — korunur.- XFF:
proxy_set_header X-Forwarded-For $remote_addr;(ezme). Aksi halde anonim IP rate limit'i sahte IP ile atlatılabilir. - Nginx CSP/güvenlik başlığı yazmaz; Next nonce'lu CSP ve diğer başlıkları kendisi gönderir.
/api/için eski nginxlimit_reqzone'ları kaldırılır (backend kendi limitlerini uygular).
api.florencex.com.tr vhost'u değişmez (7055'e proxy).
| İş | İçerik |
|---|---|
| B-02 | refresh_token çerezi path=/ |
| B-03 | JWT_SECRET paylaşımı (opsiyonel hızlandırma) |
| B-07 | hata detail'leri error_* |
| B-17 | anonim piyasa okuma + IP limiti |
Sıra: backend önce, sonra frontend cutover. B-07 kısa süre eski web'de ham kod gösterebilir; ikisi yakın zamanda yayınlanmalı.
- DB yedeği (zorunlu):
docker exec florence_postgres pg_dump -U postgres -d postgres --no-owner -Fc > /root/florence-db-<ts>.dump→pg_restore -l ... | grep -c "TABLE DATA"ile doğrula (beklenen 29). - Backend:
cd /opt/florence && git pull && docker compose build api admin && docker compose up -d --no-build api admin;curl 127.0.0.1:7055/api/v1/version. - App tag →
deploy.ymlimajı iter, container'ı başlatır, health bekler. - nginx vhost'unu 3300'e çevir;
nginx -t && systemctl reload nginx. - Smoke: anonim
//markets/symbol/THYAO200;/api/v1/companies/summaryanon 200; giriş→dashboard; favori; portföy/al-sat; rapor; digest;/manifest.webmanifest;/sw.js. - Rollback: nginx'i eski dist'e (
/var/www/florencex) geri çevir; app container'ıdocker run ... ghcr.io/actos-dev/app:<önceki-tag>ile geri al (workflowflorence-app:previoustutar).
- Bellek: sunucuda ~1 GB boş RAM; bu yüzden imaj yerelde/CI'da derlenir, sunucuda derlenmez.
NEXT_PUBLIC_SITE_URLyanlışsa SEO/canonical bozulur (build-arg)./downloads/manifest.jsonimaja gömülü gelmezse indirilenler boş görünür (masaüstü donduruldu).- Anonim rate limit (60/10 dk) NAT paylaşımlı ağlarda agresif olabilir.
- Sentry DSN yoksa hata raporlama yalnız telemetry olayı olarak kalır.
- Nonce CSP dinamik render gerektirir; sayfa statikleştirilirse script'ler engellenir.