Bakım

Yaygın Komutlar link

rtCloud konteynerlerinizi yönetmek için bu komutları düzenli olarak kullanın. Bunları docker-compose.production.yml dosyasını içeren dizinden çalıştırın.

  # Tüm konteynerlerin durumunu ve sağlığını kontrol et
docker compose -f docker-compose.production.yml ps

# Canlı günlükleri görüntüle (tüm hizmetler)
docker compose -f docker-compose.production.yml logs -f

# Yalnızca uygulama için günlükleri görüntüle
docker compose -f docker-compose.production.yml logs -f rtcloud

# Tek bir konteyneri yeniden başlat
docker compose -f docker-compose.production.yml restart rtcloud

# Tüm hizmetleri durdur
docker compose -f docker-compose.production.yml down

# Tüm hizmetleri başlat
docker compose -f docker-compose.production.yml up -d

# Uygulama konteyneri içinde bir kabuk aç
docker compose -f docker-compose.production.yml exec rtcloud bash
  

Yükseltme link

rtCloud güncellemeleri yeni Docker görüntü etiketleri olarak dağıtılır. Yükseltme, en son görüntüyü çeker ve uygulama konteynerini yeniden oluşturur. Veritabanı geçişleri başlangıçta otomatik olarak çalışır.

1. En son görüntüyü çekin:

  docker compose -f docker-compose.production.yml pull
  

2. Uygulama konteynerini yeniden oluşturun:

  docker compose -f docker-compose.production.yml up -d
  

Docker yalnızca görüntüsü değişen konteynerleri değiştirir. MySQL konteyneri ve tüm adlandırılmış birimler etkilenmez.

Sürümü Sabitleme link

latest yerine belirli bir sürüme yükseltmek için .env dosyasındaki RTCLOUD_IMAGE‘ı güncelleyin:

  RTCLOUD_IMAGE=rtawebteam/rta-smartsurvey:1.2.3
  

Ardından yukarıdaki gibi docker compose pull ve up -d komutlarını çalıştırın.

Sürüm Düşürme link

Veritabanı geçişleri geri alınamayacağından, sürüm düşürme genellikle önerilmez. Sürüm düşürme gerekirse, yükseltmeden önce alınan bir veritabanı yedeğinden geri yükleyin.

Yedekleme ve Geri Yükleme link

Veritabanını Yedekleme link

Uygulama veritabanını bir SQL dosyasına dışa aktarmak için bu komutu çalıştırın:

  docker compose -f docker-compose.production.yml exec mysql \
  mysqldump -u root -p"$(grep MYSQL_ROOT_PASSWORD .env | cut -d= -f2)" smartsurvey \
  > backup-$(date +%Y%m%d-%H%M%S).sql
  

Yedek dosyası, ana bilgisayardaki geçerli dizininize yazılır.

Veritabanını Geri Yükleme link

  docker compose -f docker-compose.production.yml exec -T mysql \
  mysql -u root -p"$(grep MYSQL_ROOT_PASSWORD .env | cut -d= -f2)" smartsurvey \
  < backup-20240101-120000.sql
  

Yüklenen Dosyaları Yedekleme link

Anket gönderimleri genellikle adlandırılmış Docker birimlerinde saklanan yüklenmiş dosyaları (fotoğraflar, ses, belgeler) içerir. Bunları veritabanından ayrı olarak yedekleyin:

  # Yüklemeleri yedekle
docker run --rm \
  -v rtcloud_uploads:/data \
  -v "$(pwd):/backup" \
  alpine tar czf /backup/uploads-$(date +%Y%m%d).tar.gz -C /data .

# Ses kayıtlarını yedekle
docker run --rm \
  -v rtcloud_audios:/data \
  -v "$(pwd):/backup" \
  alpine tar czf /backup/audios-$(date +%Y%m%d).tar.gz -C /data .
  

Varsayılanı değiştirdiyseniz rtcloud_uploads ve rtcloud_audios‘u gerçek birim adlarınızla değiştirin (COMPOSE_PROJECT_NAME ile ön eklenmiş).

Yüklenen Dosyaları Geri Yükleme link

  docker run --rm \
  -v rtcloud_uploads:/data \
  -v "$(pwd):/backup" \
  alpine tar xzf /backup/uploads-20240101.tar.gz -C /data
  

Otomatik Günlük Yedeklemeler link

Yedeklemeleri otomatik olarak çalıştırmak için ana bilgisayara bir cron görevi ekleyin. Root crontab’ı crontab -e ile düzenleyin:

  # Sabah 2:00'de günlük veritabanı yedeklemesi, 30 günlük geçmiş tutun
0 2 * * * cd /opt/rtcloud && docker compose -f docker-compose.production.yml exec -T mysql \
  mysqldump -u root -p"$(grep MYSQL_ROOT_PASSWORD .env | cut -d= -f2)" smartsurvey \
  > /backups/db-$(date +\%Y\%m\%d).sql && \
  find /backups -name "db-*.sql" -mtime +30 -delete
  

Sorun Giderme link

Uygulama konteyneri başlamıyor link

Hata mesajları için konteyner günlüklerini kontrol edin:

  docker compose -f docker-compose.production.yml logs rtcloud
  

Yaygın nedenler:

• .env dosyasında eksik veya geçersiz ortam değişkenleri
• MySQL henüz hazır değil (60 saniye bekleyin ve tekrar kontrol edin)
• Port çakışması — başka bir işlem APP_PORT‘u zaten kullanıyor

MySQL sağlıklı değil link

  docker compose -f docker-compose.production.yml logs mysql
  

Yaygın nedenler:

• .env dosyasında MYSQL_ROOT_PASSWORD ayarlanmamış
• Bozuk veri birimi (nadir — disk alanını df -h ile kontrol edin)

MySQL ilk açılışta başlatılması 30–60 saniye sürebilir. Başarısız olduğunu varsaymadan önce bekleyin ve tekrar kontrol edin.

Port zaten kullanımda link

.env dosyasında APP_PORT veya SHINY_PORT‘u boş bir porta değiştirin, ardından konteynerleri yeniden oluşturun:

  docker compose -f docker-compose.production.yml up -d --force-recreate
  

Ana bilgisayarda bir portu neyin kullandığını bulmak için:

  lsof -i :8080
  

400 CSRF Belirteci Doğrulanamadı link

Bu hata, istek kaynağının beklenen ana bilgisayarla eşleşmediği yerel veya ters proxy ortamlarında görünür. CSRF doğrulamasını yalnızca yerel geliştirme için devre dışı bırakın:

  CSRF_VALIDATION_ENABLED=false
  

Ardından uygulamayı yeniden başlatın:

  docker compose -f docker-compose.production.yml up -d --force-recreate rtcloud
  

Üretimde CSRF doğrulamasını devre dışı bırakmayın. Bu hata üretimde oluşursa, ters proxy’nizin doğru Host ve X-Forwarded-For başlıklarını ilettiğinden emin olun.

Yönetici Şifresini Unuttum link

Yönetici şifresini doğrudan veritabanında sıfırlayın. MySQL konteynerine bağlanın ve şifre karmasını güncelleyin:

Adım 1 — Yeni şifre karmasını oluşturun. newpassword‘ü istediğiniz şifreyle değiştirin:

  docker compose -f docker-compose.production.yml exec rtcloud php -r "
  \$salt = trim(shell_exec(\"mysql -h mysql -u root -p\\\"\${MYSQL_ROOT_PASSWORD}\\\" \${MYSQL_DATABASE} -se \\\"SELECT salt FROM ss_user WHERE username='admin';\\\"\"));
  echo md5(\$salt . 'newpassword') . PHP_EOL;
"
  

Adım 2 — Veritabanındaki karmayı güncelleyin:

  docker compose -f docker-compose.production.yml exec mysql \
  mysql -u root -p"${MYSQL_ROOT_PASSWORD}" smartsurvey \
  -e "UPDATE ss_user SET password='<hash_from_step_1>' WHERE username='admin';"
  

Konteyner sürekli yeniden başlıyor link

Sağlık kontrolünün başarısız olup olmadığını kontrol edin:

  docker compose -f docker-compose.production.yml ps
docker inspect rtcloud-app --format '{{json .State.Health}}'
  

Uygulama sağlık kontrolü /health uç noktasını çağırır. Defalarca başarısız olursa, başlatma hataları için uygulama günlüklerini kontrol edin.

Disk alanı doldu link

Neyin alan tükettiğini belirleyin:

  # Ana bilgisayar disk kullanımını kontrol et
df -h

# Docker disk kullanımını kontrol et (görüntüler, konteynerler, birimler)
docker system df

# Kullanılmayan görüntüleri ve durdurulan konteynerleri kaldır (güvenli çalıştırılabilir)
docker system prune
  

docker system prune --volumes kullanmayın, çünkü bu uygulama verilerini siler.

Sağlık Kontrolleri link

Her hizmetin otomatik bir sağlık kontrolü vardır. Konteyner durumu sonucu yansıtır:

Başarısız sağlık kontrolüne sahip konteynerler, RESTART_POLICY ayarına (varsayılan: unless-stopped) göre otomatik olarak yeniden başlatılır.