mirror of https://github.com/taylanbakircioglu/haproxy-openmanager.git synced 2026-09-12 05:48:58 +00:00

Files

T

taylanbakircioglu b5505b4c9d docs: update README structure and add ACME screenshots

Made-with: Cursor

2026-04-04 17:40:17 +03:00

5.5 KiB

Raw Permalink Blame History

Configuration Guide - HAProxy OpenManager

📋 Yapılandırma Dosyaları

Dosya Yapısı

haproxy-openmanager/
├── .env.template           # ✅ Template (GIT'e commit edilir)
├── .env                    # ❌ Gerçek config (GIT'e commit EDİLMEZ)
├── .gitignore              # .env dosyalarını korur
└── CONFIG.md               # Bu dosya

🎯 Quick Start

1. Template'den Config Oluşturma

# Template'i kopyala
cp .env.template .env

# Gerçek değerleri düzenle
nano .env

2. Örnek Yapılandırmalar

Development (Local)

# .env dosyası
PUBLIC_URL=http://localhost:8000
MANAGEMENT_BASE_URL=http://localhost:8000
DEBUG=True
LOG_LEVEL=DEBUG

Staging

# .env dosyası veya K8s ConfigMap
PUBLIC_URL=https://haproxy-staging.example.com
MANAGEMENT_BASE_URL=https://haproxy-staging.example.com
DEBUG=False
LOG_LEVEL=INFO

Production (OpenShift)

# K8s ConfigMap: k8s/manifests/07-configmaps.yaml
data:
  PUBLIC_URL: 'https://haproxy-manager.example.com'
  MANAGEMENT_BASE_URL: 'https://haproxy-manager.example.com'
  DEBUG: 'False'
  LOG_LEVEL: 'INFO'

🔐 Güvenlik

Hassas Bilgiler

.env dosyası hassas bilgiler içerir:

❌ Database şifreleri
❌ Secret key'ler
❌ API token'ları

Bu yüzden:

✅ .env → .gitignore'da (commit edilmez)
✅ .env.template → Git'e commit edilir (örnek değerler)
✅ Production'da: Kubernetes Secrets kullan

.gitignore Kontrolü

# .env dosyalarının ignore edildiğini kontrol et
grep "^\.env" .gitignore

# Çıktı olmalı:
# .env
# .env.local
# .env.development.local
# .env.test.local
# .env.production.local

📚 Environment Variable Detayları

PUBLIC_URL

Ne İşe Yarar: Agent kurulum script'lerinde kullanılır

Örnekler:

# Development
PUBLIC_URL=http://localhost:8000

# Production
PUBLIC_URL=https://haproxy-manager.example.com

# OpenShift
PUBLIC_URL=https://haproxy-manager.example.com

Nasıl Kullanılır:

Agent Management sayfasından "Generate Install Script"
Script içinde {{MANAGEMENT_URL}} bu değerle değiştirilir
Agent bu URL'ye bağlanarak backend'i dinler

REACT_APP_API_URL

Ne İşe Yarar: Frontend'in backend'e bağlanacağı URL

Özel Durum:

# Boş bırakılırsa → Auto-detect (production için önerilen)
REACT_APP_API_URL=

# Development için explicit
REACT_APP_API_URL=http://localhost:8000

Auto-detect Mantığı:

// frontend/src/utils/api.js
if (process.env.REACT_APP_API_URL) {
  return process.env.REACT_APP_API_URL;
}

// Production'da same-origin kullan
if (window.location) {
  return `${window.location.protocol}//${window.location.hostname}`;
}

🚀 Deployment Senaryoları

Docker Compose

# 1. .env dosyası oluştur
cp .env.template .env

# 2. Değerleri düzenle
nano .env

# 3. Başlat
docker-compose up -d

# 4. Kontrol et
docker-compose logs backend | grep "PUBLIC_URL"

Kubernetes/OpenShift

# 1. ConfigMap'i düzenle
vim k8s/manifests/07-configmaps.yaml

# 2. Apply
kubectl apply -f k8s/manifests/

# 3. Kontrol et
kubectl get configmap backend-config -n haproxy-manager -o yaml

Manuel (Development)

# 1. Backend
cd backend
cp ../.env.template .env
export $(cat .env | xargs)
uvicorn main:app --reload

# 2. Frontend (başka terminal)
cd frontend
export REACT_APP_API_URL=http://localhost:8000
npm start

🔧 Troubleshooting

Agent Script'inde Yanlış URL

Sorun: Agent script hala eski URL içeriyor

Çözüm:

# 1. Backend'deki değeri kontrol et
docker exec haproxy-openmanager-backend env | grep PUBLIC_URL

# 2. Container'ı yeniden başlat
docker-compose restart backend

# 3. Yeni script oluştur
# UI'dan tekrar "Generate Install Script"

Frontend Backend'e Bağlanamıyor

Sorun: CORS hatası veya connection refused