shopback/DOCKER_CELERY_QUICKSTART.md

🐳 Docker Compose ile Celery - Hızlı Başlangıç

Bu döküman, Docker Compose ile Celery'yi hızlıca çalıştırmak için gerekli adımları içerir.

✅ Hazırlık

1. Docker ve Docker Compose yüklü olmalı
2. Redis erişimi olmalı (CELERY_BROKER_URL)

🚀 Development Ortamı

Başlatma

# Tüm servisleri başlat (Django + Celery)
docker-compose up

# Arka planda çalıştır
docker-compose up -d

# Logları takip et
docker-compose logs -f

# Sadece Celery logları
docker-compose logs -f celery

Test Etme

# 1. Contact API'yi test et
curl -X POST http://localhost:8000/api/v1/contact/create/ \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Test User",
    "email": "test@example.com",
    "subject": "Test Subject",
    "message": "This is a test message."
  }'

# 2. Celery loglarını kontrol et
docker-compose logs -f celery

# 3. Email'i MailPit'te kontrol et
open http://localhost:8025

Durdurma

# Servisleri durdur
docker-compose down

# Volume'leri de sil
docker-compose down -v

🌐 Production Ortamı

Hazırlık

# .env dosyası oluştur
cp .env.example .env

# .env dosyasını düzenle
nano .env

# Gerekli değerler:
# - SECRET_KEY
# - DJANGO_ALLOWED_HOSTS
# - CELERY_BROKER_URL
# - POSTGRES_* (database ayarları)

Başlatma

# Tüm servisleri başlat (Django + Celery + Nginx)
docker-compose -f docker-compose.prod.yml up -d

# Build ile başlat
docker-compose -f docker-compose.prod.yml up --build -d

# Logları kontrol et
docker-compose -f docker-compose.prod.yml logs -f

# Celery logları
docker-compose -f docker-compose.prod.yml logs -f celery-atahan

Servis Durumları

# Container durumlarını kontrol et
docker-compose -f docker-compose.prod.yml ps

# Kaynak kullanımı
docker stats

Durdurma

# Servisleri durdur
docker-compose -f docker-compose.prod.yml down

# Yeniden başlat
docker-compose -f docker-compose.prod.yml restart

# Sadece Celery'yi yeniden başlat
docker-compose -f docker-compose.prod.yml restart celery-atahan

🔧 Yararlı Komutlar

Migrations

# Development
docker-compose exec web python manage.py makemigrations
docker-compose exec web python manage.py migrate

# Production
docker-compose -f docker-compose.prod.yml exec web-atahan python manage.py migrate

Django Shell

# Development
docker-compose exec web python manage.py shell

# Production
docker-compose -f docker-compose.prod.yml exec web-atahan python manage.py shell

Celery Container'a Bağlanma

# Development
docker-compose exec celery bash

# Production
docker-compose -f docker-compose.prod.yml exec celery-atahan bash

Task Sonuçlarını Görme

# Shell aç
docker-compose exec web python manage.py shell

# Shell içinde:
from django_celery_results.models import TaskResult
TaskResult.objects.all()
TaskResult.objects.filter(status='SUCCESS')
TaskResult.objects.order_by('-date_done')[:10]

📊 İzleme

Container Logları

# Tüm servisler (Development)
docker-compose logs -f

# Tüm servisler (Production)
docker-compose -f docker-compose.prod.yml logs -f

# Son 100 satır
docker-compose logs --tail=100 celery

# Belirli zaman aralığı
docker-compose logs --since 2026-01-15T10:00:00 celery

Celery İstatistikleri

# Aktif task'lar
docker-compose exec celery celery -A core inspect active

# Worker istatistikleri
docker-compose exec celery celery -A core inspect stats

# Kayıtlı task'lar
docker-compose exec celery celery -A core inspect registered

Django Admin

1. Admin panele gir:

   • Development: http://localhost:8000/admin/
   • Production: http://your-domain.com/admin/

2. Task sonuçlarını gör:

   • Django Celery Results → Task results

3. Periyodik task'ları yönet:

   • Django Celery Beat → Periodic tasks

🐛 Sorun Giderme

Celery Çalışmıyor

# 1. Logları kontrol et
docker-compose logs celery

# 2. Container durumunu kontrol et
docker-compose ps

# 3. Container'ı yeniden başlat
docker-compose restart celery

# 4. Rebuild et
docker-compose up --build celery

Email Gönderilmiyor

# 1. Celery loglarını kontrol et
docker-compose logs -f celery

# 2. MailPit çalışıyor mu? (Development)
open http://localhost:8025

# 3. Email ayarlarını kontrol et
docker-compose exec web python manage.py shell
>>> from django.conf import settings
>>> print(settings.EMAIL_BACKEND)
>>> print(settings.EMAIL_HOST)

Redis Bağlantı Hatası

# Environment variable'ları kontrol et
docker-compose exec celery env | grep CELERY

# Redis bağlantısını test et
docker-compose exec celery python -c "
from django.conf import settings
print(settings.CELERY_BROKER_URL)
"

📚 Servis Portları

Development

• Django: http://localhost:8000
• MailPit UI: http://localhost:8025
• MailPit SMTP: localhost:1025

Production

• Nginx: http://localhost:8077
• Django (Direct): http://localhost:8800

🔐 Environment Variables

Development (.env veya docker-compose.yml)

DEBUG=1
CELERY_BROKER_URL=redis://default:password@host:6379/5
CELERY_RESULT_BACKEND=django-db
POSTGRES_DB=server_dj
POSTGRES_USER=server_dj
POSTGRES_PASSWORD=1234
POSTGRES_HOST=10.80.80.50
POSTGRES_PORT=5432

Production (.env)

DEBUG=0
SECRET_KEY=your-secret-key-here
DJANGO_ALLOWED_HOSTS=yourdomain.com
CELERY_BROKER_URL=redis://default:password@host:6379/5
CELERY_RESULT_BACKEND=django-db
POSTGRES_DB=your-db
POSTGRES_USER=your-user
POSTGRES_PASSWORD=your-password
POSTGRES_HOST=your-host
POSTGRES_PORT=5432

📖 Detaylı Dökümanlar

• DOCKER_CELERY.md - Celery kullanımı hakkında detaylı bilgi
• DOCKER_README.md - Docker genel kullanımı
• CONTACT_EMAIL_SETUP.md - Contact email kurulumu

🎯 Önemli Notlar

1. ✅ Celery worker ve beat aynı container'da çalışır
2. ✅ Redis harici olarak çalışmalı (CELERY_BROKER_URL)
3. ✅ PostgreSQL harici olarak çalışmalı
4. ✅ MailPit development için email testleri sağlar
5. ✅ Production'da gerçek SMTP kullanın

🚨 İlk Başlatmada Yapılacaklar

# 1. Servisleri başlat
docker-compose up -d

# 2. Migration'ları uygula
docker-compose exec web python manage.py migrate

# 3. Superuser oluştur
docker-compose exec web python manage.py createsuperuser

# 4. Static dosyaları topla (Production)
docker-compose exec web python manage.py collectstatic --noinput

# 5. Test et
curl -X POST http://localhost:8000/api/v1/contact/create/ \
  -H "Content-Type: application/json" \
  -d '{"name":"Test","email":"test@test.com","subject":"Test","message":"Test"}'

# 6. Logları kontrol et
docker-compose logs -f celery

---

Yardım: Sorun yaşarsanız DOCKER_CELERY.md dosyasına bakın veya logları kontrol edin.