🗄️ databases-stack

Tek docker compose up ile MariaDB · PostgreSQL · MongoDB · Redis

Admin panelleri + Prometheus exporters + 15-dakikalık otomatik backup + Google Drive sync + least-privilege user setup

⭐ Beğendiyseniz yıldız bırakın — bu tip self-hosted stack'ler nadir.

---

🎯 Niye var?

Geliştiriciler için "bir tek-makine veritabanı sunucusu" kurmanın zor tarafı 4 farklı container, 4 farklı admin panel, 4 farklı backup yöntemi, 4 farklı user-permission mantığını uyumlu kurmak. Bu repo:

• 4 popüler DB'yi tek docker compose up ile çalıştırır
• Her birine web UI (phpMyAdmin / pgAdmin / Mongo Express / RedisInsight + Adminer)
• Her birinin Prometheus exporter'ı kurulu, scrape edilmeye hazır
• 15 dakikada bir tam backup + 7 gün retention
• Google Drive'a rclone ile sync (offsite backup)
• Least-privilege app user (DROP DATABASE yasak, DELETE serbest)
• Tek nginx dashboard ile her şey tek pencerede

⚠️ Bu bir "production database cluster" değil. Single-machine, single-replica, dev/staging veya küçük production için. HA/multi-region için Patroni, CloudNativePG, Aurora vb. kullanın.

---

📦 Servisler

Servis	Port	Image	Açıklama
mariadb	3306	mariadb:11.4	MySQL-uyumlu, slow query log açık, 256MB buffer pool
postgresql	5432	postgres:15	tuned (shared_buffers=256M, max_connections=200)
mongodb	27017	mongo:4.4	auth açık, 250MB cache
redis	6379	redis:8-alpine	requirepass, AOF, allkeys-lru
phpmyadmin	8081	phpmyadmin:latest	MariaDB UI
pgadmin	8082	dpage/pgadmin4:latest	PostgreSQL UI
mongo-express	8083	mongo-express:latest	MongoDB UI
redis-insight	8084	redis/redisinsight:latest	Redis UI
adminer	8085	adminer:latest	Universal DB UI
nginx-dashboard	80	nginx:alpine	Tüm panellere link landing page
mysql-exporter	9104	prom/mysqld-exporter:latest	Prometheus metric'i
postgres-exporter	9187	prometheuscommunity/postgres-exporter	Prometheus metric'i
mongodb-exporter	9216	percona/mongodb_exporter:0.40	Prometheus metric'i
redis-exporter	9121	oliver006/redis_exporter:latest	Prometheus metric'i

🪄 Cassandra opsiyonel olarak cassandra/ altında ayrı compose'da. Ana 4 DB'ye dahil değil.

---

🚀 Hızlı Başlangıç

1. Klonla

git clone https://github.com/halilibrahimd27/databases-stack.git
cd databases-stack

2. Env dosyasını hazırla

cp .env.example .env

# Güçlü bir parola üret
echo "DB_PASSWORD=$(openssl rand -base64 32 | tr -d '+/=')" >> .env

# .env'i editörde aç ve kalan zorunlu alanları doldur

3. Stack'i ayağa kaldır

docker compose up -d
docker compose ps

4. Doğrulama

curl http://localhost/health             # nginx dashboard
docker compose logs --tail=30 mariadb

5. (Opsiyonel) App user oluştur

DB_ROOT_PASSWORD="$(grep DB_PASSWORD .env | cut -d= -f2)" \
APP_PASSWORD="$(openssl rand -base64 24)" \
  ./setup_db_users.sh all

6. (Opsiyonel) 15-dakikalık backup cron

chmod +x backup.sh
crontab crontab     # crontab dosyasını cron'a yükle

7. (Opsiyonel) Google Drive sync

# rclone'u kur ve gdrive remote'unu yapılandır
curl https://rclone.org/install.sh | sudo bash
rclone config
# → New remote → name: gdrive → Storage: drive → ...

# Test
./sync_remote.sh test
./sync_remote.sh         # ilk sync

---

🔌 Erişim

URL	Servis	Auth
http://<HOST>	Nginx Dashboard (landing)	nginx basic auth (root / ${DB_PASSWORD})
http://<HOST>:8081	phpMyAdmin	MariaDB user (root / ${DB_PASSWORD})
http://<HOST>:8082	pgAdmin	admin@admin.com / ${DB_PASSWORD}
http://<HOST>:8083	Mongo Express	root / ${DB_PASSWORD}
http://<HOST>:8084	RedisInsight	UI'da connection ekle
http://<HOST>:8085	Adminer	DB tipi seç + creds

⚠️ Production'da hiçbiri public açmayın. Reverse proxy + VPN/IP whitelist arkasına alın.

---

💾 Backup Sistemi

backup.sh 1000+ satırlık production-grade script. Özellikler:

• ✅ Lock mekanizması — concurrent run engeller
• ✅ Tüm DB'ler (sadece defaultdb değil)
• ✅ Per-DB single backup opsiyonu
• ✅ Backup integrity verification (gzip/tar test)
• ✅ Disk space check (5GB altında abort)
• ✅ Container health check
• ✅ Retention (default 7 gün)
• ✅ Restore komutları her DB için
• ✅ Detaylı log + colored output

Kullanım

./backup.sh all                  # tüm DB'leri yedekle
./backup.sh mariadb              # sadece MariaDB
./backup.sh mariadb-single mydb  # tek bir MariaDB DB'si
./backup.sh stats                # istatistik raporu
./backup.sh list                 # son yedekleri listele
./backup.sh clean 7              # 7 günden eski yedekleri sil
./backup.sh restore-postgresql /path/to/backup.sql.gz

Cron (15 dakikada bir, önerilen)

crontab dosyasını yükle:

crontab crontab

Bu ekler:

• Her 15 dk → full backup
• Her 15 dk + 5 dk → Google Drive sync
• Her saat → 360 dk'dan eski local backup'ları temizle
• Her gün 08:00 → istatistik raporu

---

☁️ Google Drive Sync

sync_remote.sh — rclone ile Google Drive'a otomatik yedek.

./sync_remote.sh test     # bağlantı testi
./sync_remote.sh          # şimdi sync
./sync_remote.sh status   # local + remote stats
./sync_remote.sh cleanup  # eski uzak yedekleri sil

Önkoşul: GOOGLE_DRIVE_SETUP.md okuyun (rclone kurulum, Google Drive auth).

---

🔒 Least-Privilege App User

setup_db_users.sh — uygulamanın bağlanacağı kısıtlı kullanıcı oluşturur.

✅ İzin verilen	❌ Yasak
SELECT, INSERT, UPDATE, DELETE	DROP DATABASE
CREATE TABLE, CREATE INDEX	DROP TABLE
ALTER TABLE	TRUNCATE
Stored procedures, functions	SUPERUSER, GRANT
DEL (Redis)	FLUSHALL, FLUSHDB

APP_PASSWORD='$(openssl rand -base64 24)' ./setup_db_users.sh all

# Sadece tek DB
./setup_db_users.sh mariadb
./setup_db_users.sh remove   # kullanıcıyı kaldır

---

📊 Monitoring (Prometheus + Grafana)

Exporter'lar zaten kurulu — Prometheus'u stack'in dışında bir yere kurup şu target'ları scrape edin:

# prometheus.yml
scrape_configs:
  - job_name: 'mariadb'
    static_configs:
      - targets: ['<HOST>:9104']
  - job_name: 'postgresql'
    static_configs:
      - targets: ['<HOST>:9187']
  - job_name: 'mongodb'
    static_configs:
      - targets: ['<HOST>:9216']
  - job_name: 'redis'
    static_configs:
      - targets: ['<HOST>:9121']

Grafana dashboard ID önerileri:

• MariaDB: 7362
• PostgreSQL: 9628
• MongoDB: 2583
• Redis: 763

---

🛡️ Güvenlik Notları

• ✅ Tüm secret'lar .env üzerinden, ${VAR} interpolasyonu (hardcoded yok)
• ✅ Container'lar resource limit'li (memory hard cap)
• ✅ Health check'li (auto-restart kötü state'te)
• ✅ App user least-privilege
• ⚠️ DB portları (3306/5432/27017/6379) default'ta host'a expose. Production'da:

  # docker-compose.yml override
  mariadb:
    ports: []        # sadece compose network içinden

• ⚠️ Admin panel'leri auth'lu ama VPN/whitelist olmadan public açmayın
• ⚠️ Nginx dashboard basic-auth kullanır — production'da OAuth proxy/SSO

Önerilen production hardening

# 1. Strong password
openssl rand -base64 32 > /tmp/dbpass
sed -i "s/^DB_PASSWORD=.*/DB_PASSWORD=$(cat /tmp/dbpass)/" .env
shred -u /tmp/dbpass

# 2. DB portlarını host'a açma (override.yml ile)
cat > docker-compose.override.yml <<'EOF'
services:
  mariadb: { ports: [] }
  postgresql: { ports: [] }
  mongodb: { ports: [] }
  redis: { ports: [] }
EOF

# 3. Reverse proxy + TLS
# Caddy / nginx + Let's Encrypt arkasından dashboard'a açın

---

📁 Repo Yapısı

databases-stack/
├── docker-compose.yml         # Ana stack (MariaDB+PG+Mongo+Redis+UIs+exporters)
├── backup.sh                  # 1000+ satırlık backup script
├── sync_remote.sh             # Google Drive sync (rclone)
├── setup_db_users.sh          # Least-privilege app user setup
├── sc.sh                      # İlk kurulum yardımcısı (opsiyonel)
├── crontab                    # Cron jobs (15-min backup + sync)
├── .env.example               # Ortam değişkenleri şablonu
├── .gitignore
├── GOOGLE_DRIVE_SETUP.md      # Rclone setup detayı
├── mariadb/config/my.cnf      # Custom MariaDB config
├── nginx/
│   ├── nginx.conf             # Reverse proxy + auth
│   └── html/index.html        # Dashboard landing
└── cassandra/                 # Opsiyonel: Cassandra alt-stack
    ├── docker-compose.yml
    ├── backup.sh
    ├── setup_users.sh
    └── ...

---

🆘 Sorun Giderme

Container ayağa kalkıyor ama bağlanamıyorum

docker compose ps
docker compose logs <SERVICE> --tail=50
docker exec <CONTAINER> printenv | grep -i pass

"DB_PASSWORD not set" hatası

.env dosyasında DB_PASSWORD= doldurulmamış. Düzelt + docker compose down && up -d.

Backup script "lock acquired" sonra hiçbir şey yapmıyor

Önceki bir backup hâlâ çalışıyor olabilir. cat /tmp/db_backup.lock ile PID kontrol et.

rm -f /tmp/db_backup.lock      # son çare — gerçekten boştaysa

Google Drive sync auth fail

rclone config reconnect gdrive:
./sync_remote.sh test

MongoDB Express login loop

Mongo Express bazen ilk start'ta sorun çıkarır:

docker compose restart mongodb
sleep 30
docker compose restart mongo-express

pgAdmin "could not connect to server"

pgAdmin container'ını ilk açtığında PostgreSQL henüz hazır olmayabilir. Server config'i UI'da elle ekleyin:

• Host: postgresql
• Port: 5432
• Username: root
• Password: ${DB_PASSWORD}

---

📜 Lisans

MIT — LICENSE dosyasına bakın.

---

🌟 Destek olmak istersen

Süre	Yardım
5 sn	⭐ Star
30 sn	Twitter/LinkedIn'de paylaş
5 dk	Issue aç (eksik bulduğun şey)
2 saat	Yeni DB ekle (Cassandra benzeri alt-stack)