Veritabanı Docker içinde mi yoksa host üzerinde mi?
PostgreSQL, MySQL veya Redis gibi veritabanlarını Docker içinde çalıştırmanın üretim ortamındaki risklerini keşfedin. Hatalı volume, yedekleme ve sürüm yönetimi detaylarını inceleyin.
Veritabanı Docker içinde mi yoksa host üzerinde mi çalışmalı?
Veritabanını Docker içinde çalıştırın. Tek bir VPS üzerinde tek bir uygulama yığını için container haline getirilmiş PostgreSQL, MySQL, MongoDB veya Redis standart bir üretim tercihidir; bu konuda yapılan tartışmalar genellikle yanlış bir zemine oturmaktadır. Bir container, etrafında namespace ve cgroup bulunan bir Linux sürecidir, sanal makine değildir; dolayısıyla veritabanı ile disk arasında bir hypervisor katmanı bulunmaz. Bind mount veya yerel bir named volume kullanıldığında, okuma ve yazma işlemleri, paket kurulumunun kullanacağı dosya sistemiyle aynı olan host dosya sistemine doğrudan ulaşır.
Asıl maliyet operasyoneldir. Bu kurulumun sorunsuz mu yoksa yavaş bir felaket mi olacağını dört unsur belirler: verinin nerede yaşadığı, o dizinin sahibinin kim olduğu, ana sürüm yükseltme işleminin nasıl gerçekleştiği ve daha önce hiç yedekten geri yükleme yapıp yapmadığınız. Bunları doğru yapılandırdığınızda container sadece bir detaydan ibarettir. Yanlış yapılandırdığınızda ise suçlayacağınız ilk şey container olacaktır.
Bu karar, sunucudaki her veritabanı için aynıdır. Aşağıdaki örneklerde PostgreSQL, MySQL, MongoDB ve Redis kullanılmıştır; ürüne özgü farklar, önem arz ettikleri noktalarda belirtilmiştir.
Bir container gerçekte neyi değiştirir?
Bir mount işlemi yaptığınız sürece depolama yolunu değiştirmez. Aynı kernel, aynı page cache ve aynı filesystem kullanılır.
Gerçek bir performans sorunu vardır. Bu sorun, hiçbir şeyi mount etmediğiniz durumda ortaya çıkar. Volume olmadan data directory, image üzerine yerleştirilmiş bir overlay filesystem olan container'ın yazılabilir katmanına yazılır. Bu katmandaki yazma işlemleri daha yavaştır. Container kaldırıldığında katmanın tamamı silinir. “Veritabanım bu sabah boştu” durumunun nedeni budur.
Gerçekte değişenler şunlardır:
- Yaşam döngüsü.
docker compose downcontainer'ı siler. Bir volume içinde bulunmayan her şey container ile birlikte silinir. - Sürüm. Image etiketi sürümü belirtir. Bir veritabanı container'ında, sonraki
docker compose pullişleminden sonra da varlığını sürdüren birapt upgradebulunmaz. - Bellek muhasebesi. cgroup sınırı, kernel tarafından uygulanan kesin bir sınırdır. Veritabanlarının varsayılan ayarları genellikle bu sınıra göre kendini ayarlamaz. MySQL 9.3 veya sonraki sürümler, bazı ayarlar için bu sınırı okur. MongoDB, WiredTiger cache için bunu yapmayı dener; ancak kendi belgelerinde bazı durumlarda bunu yapamayabileceği belirtilir. PostgreSQL ve Redis bunu yapmaz.
- Kullanıcı. Süreç, container içinde sayısal bir user id ile çalışır. Bu kullanıcı, host üzerinde hiçbir dosyanın sahibi olmayabilir.
Verilerin nerede tutulduğu her şeyi belirler
İki iyi seçenek ve sık yapılan bir hata vardır.
- Named volume:
pgdata:/var/lib/postgresql/data. Docker, dizini/var/lib/docker/volumes/<project>_pgdata/_dataaltında oluşturur ve image entrypoint'i ilk çalıştırmada sahiplik ayarını yapar. Varsayılan tercih budur. - Bind mount:
/srv/appname/pg:/var/lib/postgresql/data. Yolu siz seçersiniz; bu nedenle izin sorunundan siz sorumlusunuz. - Hiç mount kullanmamak. Yukarıya bakın. Veriler container içindedir.
Tüm ödünleşimler ayrı bir konudur ve bind mount ile named volume karşılaştırması bunları ele alır. Veritabanı için kısa cevap şudur: Host yolunu bilmek için özel bir nedeniniz yoksa named volume kullanın. Bind mount kullanacaksanız bunu /srv/appname/pg gibi kararlı bir konuma yerleştirin. git clean erişebileceği proje dizininin içine yerleştirmeyin.
Network storage kullanırken dikkatli olun. Veritabanı veri dizinini NFS (network file system) veya kilitleme ve fsync davranışını test etmediğiniz başka bir network mount üzerinde tutmayın. PostgreSQL, NFS için hard seçeneğini kullanan bir mount gerektirir. Ayrıca NFS sunucusunda sync export seçeneğinin kullanılmasını güçlü biçimde önerir. Bu seçenek olmadan istemcideki fsync işleminin sunucunun diskine ulaşacağı garanti edilmez. Veritabanları, başarılı bir fsync işleminin byte'ların kalıcı depolamaya yazıldığı anlamına geldiğini varsayar. Bu varsayım yanlış olduğunda, haftalar sonra ortaya çıkan veri bozulmalarıyla karşılaşırsınız.
Volume ismini sabitleyin, volume kaybolmadan önlem alın
Compose, bir volume ismini <project>_<volume> olarak belirler ve proje ismi varsayılan olarak dizin ismini alır. Bu nedenle volume kimliği, kullanıcıların üzerinde düşünmeden değiştirebildiği bir dizin ismine bağımlı hale gelir.
/srv/app dizinini /srv/app-old konumuna taşırsanız veya compose dosyasındaki pgdata anahtarını yeniden adlandırırsanız, bir sonraki docker compose up -d komutu yepyeni ve boş bir volume oluşturur. Postgres, bu yeni volume içinde temiz bir küme başlatır. Container sağlıklı görünür, uygulama başlar ancak tüm tablolar silinmiş olur. İyi haber şudur: Eski volume, eski ismiyle diskte durmaya devam eder.
docker volume ls
docker volume inspect app_pgdataBu durumun yaşanmaması için isimleri sabitleyin. Proje ismini ve volume ismini açıkça tanımlayın:
name: myapp
services:
db:
image: postgres:17
volumes:
- pgdata:/var/lib/postgresql/data
volumes:
pgdata:
name: myapp_pgdataEğer verileriniz sahipsiz bir volume içinde kaldıysa, veritabanını durdurarak verileri yeni volume içine kopyalayın:
docker compose stop db
docker run --rm -v app_pgdata:/from -v myapp_pgdata:/to alpine sh -c 'cp -a /from/. /to/'
docker compose start dbVeritabanı çalışırken kopyalama yaparsanız, yazılmakta olan dosyaların tutarsız bir kopyasını alırsınız. Önce veritabanını durdurun.
Veri dizininin sahibi
Resmî Postgres, MySQL ve MongoDB imajları, sunucularını ayrıcalıksız bir sayısal kullanıcı kimliğiyle çalıştırır: varsayılan etiketlerde 999, Postgres -alpine etiketlerinde ise 70. Container root olarak başlatıldığında entrypoint, veri dizininin sahipliğini bu kullanıcıya geçirir ve ardından ayrıcalıkları bırakır. Bu nedenle boş bir bind mount genellikle ilk denemede çalışır.
Compose dosyasında user: ayarlandığı anda bu işlem başarısız olur. Çünkü entrypoint'in artık düzeltme yapacak ayrıcalığı kalmaz. Postgres bunu doğrudan belirtir:
initdb: error: could not change permissions of directory "/var/lib/postgresql/data": Operation not permittedYanlış izinlerle mevcut olan bir veri dizini farklı bir mesaj üretir. Bu mesajın tanınması önemlidir; çünkü çözüm chmod, chown değildir:
FATAL: data directory "/var/lib/postgresql/data" has invalid permissions
DETAIL: Permissions should be u=rwx (0700) or u=rwx,g=rx (0750).MongoDB entrypoint'i de sahipliği aynı şekilde düzeltir. Bu nedenle bu kilit dosyası hatası, işlemin bunu yapamadığı anlamına gelir: genellikle user: ayarlanmıştır veya mount, root tarafından yapılan chown işlemini reddeder:
Unable to create/open the lock file: /data/db/mongod.lock (Permission denied). Ensure the user executing mongod is the owner of the lock file and has the appropriate permissions.Çözüm, host dizininin sahipliğini bir kullanıcı adına değil, sayısal kimliğe vermektir:
sudo chown -R 999:999 /srv/appname/pg
sudo chmod 700 /srv/appname/pg
ls -ldn /srv/appname/pgls -ldn adlar yerine sayıları yazdırır ve 999 999 göstermelidir. Bir Postgres -alpine imajı için bunun yerine 70:70 kullanın ve 70 70 bekleyin. Host üzerindeki postgres adlı hesap ile imaj içindeki postgres adlı hesap birbirinden bağımsızdır: kernel sayısal kimlikleri karşılaştırır; adlar ise her iki tarafta ayrı ayrı çözümlenir. PUID ve PGID'nin host kullanıcılarını container içine nasıl eşlediği bu eşlemeyi ayrıntılı biçimde açıklar. Rootless Docker veya user namespace remapping kullanıldığında sayılar yeniden değişir. Bu nedenle 999 varsayımında bulunmak yerine kimlikleri çalışan container içinden okuyun.
Named volume kullanıldığında bu bölüm ilk çalıştırmada gereksiz hale gelir. Bunun nedeni, Docker'ın boş bir dizin oluşturması ve entrypoint'in bu dizinin sahibi olmasıdır.
Yükseltmeler: paket yükseltmesi ve image tag değişikliği
Host üzerinde apt upgrade komutu, minor sürüm içinde ilerlemenizi sağlar. Dağıtımınız bir database major sürümünü sizin yerinize otomatik olarak yükseltmez. Yükseltmeye karar verdiğinizde her iki binary seti de aynı anda kurulabilir. pg_upgrade için gereken durum tam olarak budur.
Container ortamında tag sürümü belirtir. Bu nedenle yükseltme, tek satırın düzenlenmesinden ibarettir. Böylece minor yükseltmeler basit, major yükseltmeler ise bir prosedür haline gelir.
postgres:16 değerini postgres:17 olarak değiştirin, docker compose up -d komutunu çalıştırın. Container hemen çıkar:
PostgreSQL Database directory appears to contain a database; Skipping initialization
FATAL: database files are incompatible with server
DETAIL: The data directory was initialized by PostgreSQL version 16, which is not compatible with this version 17.Hiçbir veri bozulmaz. Yeni binary'ler, major sürümler arasında değişen eski disk üzerindeki catalog düzenini okumayı reddeder. Tag değerini postgres:16 olarak geri alın. Container yeniden başlar. Bu rollback, container'ların sağladığı gerçek yükseltme avantajıdır.
Desteklenen yöntem dump ve restore işlemleridir. PostgreSQL, dump işleminin daha yeni client ile alınmasını önerir. Bu nedenle dump işlemini yeni image içinden, compose network üzerinde hâlâ çalışan eski server'a karşı çalıştırın:
docker run --rm --network myapp_default -e PGPASSWORD="$POSTGRES_PASSWORD" \
postgres:17 pg_dumpall -h db -U postgres > /srv/backups/all.sql
ls -lh /srv/backups/all.sql
tail -n 2 /srv/backups/all.sqlDosya en az onlarca kilobyte büyüklüğünde olmalı ve PostgreSQL database cluster dump complete satırıyla bitmelidir. Birkaç yüz byte büyüklüğündeki dosya, dump işleminin başarısız olduğunu gösterir. Böyle bir durumda bir volume'u gereksiz yere silmek üzeresiniz. Yalnızca bu kontrolden sonra şu işlemi yapın:
docker compose down
docker volume rm myapp_pgdata
# edit the compose file: image: postgres:17
docker compose up -d db
docker compose exec -T db psql -U postgres -f /dev/stdin < /srv/backups/all.sqlpostgres:18 değerinde bir değişiklik daha yapılacağını planlayın. 18 sürümünden itibaren resmi image, verilerini /var/lib/postgresql altında sürüm numarası içeren bir directory'de tutar; 18 sürümü için bu directory /var/lib/postgresql/18/docker değeridir. Volume, /var/lib/postgresql konumunda tanımlanır. Hâlâ /var/lib/postgresql/data konumuna mount edilmiş bir volume, container'ın Error: in 18+, these Docker images are configured to store database data ile başlayan bir hata vererek çıkmasına neden olur. 18 veya sonraki bir sürüme geçerken mount konumunu pgdata:/var/lib/postgresql olarak değiştirin. Bu yazıdaki /var/lib/postgresql/data yolları 17 ve önceki sürümler içindir.
Diğer engine'lerde durum farklıdır:
- MySQL 8, startup sırasında kendi data dictionary yapısını yükseltir. Bu nedenle minor tag değişikliği genellikle yalnızca restart işleminden ibarettir. Release serileri arasında geçiş yapmadan önce release notes belgesini okuyun. Her iki durumda da önce dump alın.
- MariaDB, yeni sürümle server başladıktan sonra
mariadb-upgradekomutunun çalıştırılmasını bekler. - MongoDB, her seferinde yalnızca bir major sürüm yükseltilmelidir. Her adımdan sonra ilerlemeden önce feature compatibility version ayarlanmalıdır. Bir sürüm atlanırsa
mongodbaşlatılamaz vefeatureCompatibilityVersionadını içerenUPGRADE PROBLEMsatırını log'a yazar. MongoDB 7.0 ve sonraki sürümlerde komut için açık bir confirmation flag gerekir:db.adminCommand({ setFeatureCompatibilityVersion: "8.0", confirm: true }). - Redis, daha eski snapshot dosyalarını sorunsuz yükler; ancak daha yeni snapshot dosyalarını yükleyemez. Bu nedenle yükseltme bir restart işlemidir. Downgrade sonrasında data yüklenemeyebilir.
Genel kural şudur: Container downgrade işlemini kolaylaştırır, ancak upgrade işlemini kolaylaştırmaz.
Veritabanı container'ım neden 137 çıkış koduyla sonlanıyor?
Çünkü kernel'in out of memory (OOM) killer'ı süreci sonlandırmıştır. 137, 128 ile signal 9'un toplamıdır.
docker compose ps --all
docker inspect myapp-db-1 | grep -i oomkilled
journalctl -k | tail -n 20docker compose ps --all, Exited (137) bilgisini gösterir. --all olmadan Compose yalnızca çalışan container'ları listeler; bu nedenle sonlanan veritabanı çıktıda görünmez. Inspect satırında "OOMKilled": true okunur ve kernel günlüğünde buna karşılık gelen bir kayıt bulunur:
Memory cgroup out of memory: Killed process 4711 (postgres) total-vm:2170416kBOOMKilled yalnızca bir OOM killer'ın container içindeki bir süreci sonlandırdığını gösterir. Bunun container'ın kendi limitinden kaynaklandığını belirten ifade Memory cgroup out of memory önekidir. Host genelindeki bellek yetersizliği ise Out of memory: Killed process olarak kaydedilir. Bu durumda düzeltme container'da değil, host üzerinde yapılmalıdır.
Mekanizma şöyledir ve çoğu kişiyi şaşırtır. Container içinde free ve /proc/meminfo hâlâ host'un toplam belleğini bildirir; cgroup limiti bu değeri değiştirmez. PostgreSQL boyutlandırmayı bu değere göre yapmaz: shared_buffers varsayılan olarak 128MB'dir ve daha büyük bir değer, sizin veya bir ayar rehberinin seçtiği değerdir. MySQL'de innodb_buffer_pool_size de varsayılan olarak 128M'dir. Sorun, ayarların sistemin bildirdiği bellek miktarına göre boyutlandırılmasıyla başlar. PostgreSQL'in kendi önerisi, başlangıç shared_buffers değeri olarak sistem belleğinin %25'ini kullanır. Bu nedenle 2 GB limitli 16 GB bir host'ta bu kural 4 GB değer verir ve cgroup, host henüz bellek baskısı altında değilken veritabanını sonlandırır. Bazı veritabanı motorları artık belirli varsayılan değerler için limiti okuyabilir: MySQL 9.3 ve sonraki sürümleri bunu yapar; MongoDB de algılayabildiğinde WiredTiger önbelleği için bu değeri kullanır. Ancak her şeyi bu limite göre boyutlandırmazlar ve MongoDB'nin kendi belgeleri algılamanın başarısız olabileceğini belirtir. Bu nedenle yalnızca bellek limiti yeterli değildir. Veritabanına kullanılabilir belleği ayrıca bildirmek gerekir:
- PostgreSQL:
shared_buffersayarlanmalı vework_memdeğerine dikkat edilmelidir.work_memher sıralama veya hash işlemi için ayrı ayrı uygulanır. Her bağlantı aynı anda birden fazla işlem çalıştırabilir. Bu nedenle elli bağlantıyla çarpıldığında yüksek bir değer, başlangıçta değil yük altında sonlanan bir container'ın yaygın nedenidir. - MySQL ve MariaDB: Varsayılan olarak 128M olan
innodb_buffer_pool_sizeayarlanmalıdır. 9.3 öncesi MySQL sürümlerinde container içindeinnodb_dedicated_serverkapalı bırakılmalıdır; çünkü bu seçenek buffer pool boyutunu makinenin belleğine göre belirler ve burada makinenin belleği host'un belleğidir. 9.3 ve sonraki sürümlerde MySQL container limitlerini okur veinnodb_dedicated_serverdeğerini bunlara göre belirler. Ancak açık bir buffer pool boyutu kullanmak yine daha öngörülebilir bir seçimdir. - MongoDB: WiredTiger önbellek boyutu açıkça ayarlanmalıdır. MongoDB algılayabildiğinde container limitini kullanır (
hostInfobunumemLimitMBolarak bildirir). Ancak kendi belgeleri bazı durumlarda bunun mümkün olmayabileceği konusunda uyarır ve--wiredTigerCacheSizeGBveya--wiredTigerCacheSizePctdeğerinin container belleğinden düşük ayarlanmasını önerir. - Redis:
maxmemoryvarsayılan olarak sınırsızdır; bu nedenle Redis, cgroup tarafından durdurulana kadar büyür.maxmemorydeğeri container limitinin rahatça altında ayarlanmalı ve birmaxmemory-policyseçilmelidir.
Postgres olayı kendi tarafından da kaydeder. Günlükte şu iki satır bulunur:
LOG: server process (PID 123) was terminated by signal 9: Killed
LOG: terminating any other active sessions due to crash of another server processBir backend'in sonlandırılması, paylaşılan bellek artık tutarsız olabileceği için diğer tüm backend'lerin yeniden başlatılmasına neden olur. Bu, uygulama için sessiz bir olay değil, bir bağlantı fırtınasıdır. Docker Compose'ta bellek limitlerini ayarlama, söz dizimini ve mem_limit ile deploy.resources biçimi arasındaki farkı açıklar.
Bunların hiçbiri host üzerinde ortadan kalkmaz; yalnızca etkisi başka yere taşınır. cgroup olmadan veritabanı host üzerindeki diğer tüm süreçlerle belleği paylaşmak zorunda kalır. Host'un OOM killer'ı da sshd gibi bir süreci skoruna göre hedef seçebilir. Veritabanını öngörülebilir biçimde sonlandıran bir limit, sizi host OOM nedeniyle sistemden dışarıda bırakan bir durumdan daha kolay işletilir.
Yedekleme: içeride dump alın, dışarıda yedekleyin
Çalışan bir veritabanını veri dizinini kopyalayarak yedeklemeyin. Sunucu yazma işlemi yaparken alınan dosya seviyesindeki bir kopyalama işlemi "torn copy" (parçalı kopya) oluşturur ve bunu ancak geri yükleme aşamasında fark edersiniz.
İki güvenilir yöntem mevcuttur: veritabanı çalışırken kendi aracıyla dump almak ve bu dump dosyasını yedeklemek ya da container'ı durdurup volume dizinini soğuk yedeklemek.
docker compose exec -T db pg_dump -U postgres -Fc appdb > /srv/backups/appdb.dump
docker compose exec -T db mysqldump -u root -p"$MYSQL_ROOT_PASSWORD" --single-transaction --all-databases > /srv/backups/mysql.sql
docker compose exec -T db mongodump --archive --gzip --db appdb > /srv/backups/appdb.archive.gz
docker compose exec -T redis redis-cli BGSAVE-T parametresi önemlidir. Bu parametre olmadan docker compose exec komutu terminali sürece bağlayabilir ve terminal katmanı çıktı akışına satır başı karakterleri ekleyebilir. Bu durumda metin tabanlı dump dosyaları geri yüklenirken garip hatalar oluşur, ikili (binary) dump dosyaları ise doğrudan bozulur. Yedekleme sırasında sessizce başarısız olan bu durum, bir ay sonra geri yükleme yapmaya çalıştığınızda büyük sorunlara yol açar.
--single-transaction parametresi, mysqldump aracına tüm sunucuyu kilitlemeden InnoDB tablolarının tutarlı bir anlık görüntüsünü (snapshot) alma imkanı tanır.
Bu komutlar tek bir dosya oluşturur. Bunlar tek başlarına bir yedekleme sistemi değildir; saklama politikası (retention), sunucu dışına aktarım veya doğrulama mekanizmaları içermezler. Dump dizinini bu üç özelliği de sağlayan bir araca emanet edin; restic ile VPS yedekleme rehberinin amacı budur. /var/lib/docker/volumes değil, /srv/backups yedeğini alın.
Ardından geri yükleme işlemini test edin; çünkü daha önce geri yüklemediğiniz bir yedek, yedek sayılmaz:
docker compose exec -T db createdb -U postgres restore_test
docker compose exec -T db pg_restore -U postgres -d restore_test < /srv/backups/appdb.dump
docker compose exec -T db psql -U postgres -d restore_test -c '\dt'\dt komutu uygulamanızın tablolarını listelemelidir. Boş bir sonuç veya Did not find any relations. hatası, dump dosyasının beklediğiniz içerikte olmadığını gösterir. İşiniz bittiğinde restore_test veritabanını silin.
Her şeyi silen komut
docker compose down -v.
Düz down container'ları ve ağı kaldırır. -v ise bu Compose dosyasında tanımlanan tüm adlandırılmış volume'ları ve bu container'lara bağlı tüm anonim volume'ları da kaldırır. Herhangi bir onay istemi göstermez ve geri alma seçeneği yoktur. Self-hosted bir veritabanının yok edilmesinin en yaygın yolu budur. Bu durum genellikle ilgisiz bir sorunun sorun giderme sürecinde, bir forum yanıtı bu komutun çalıştırılmasını önerdiği için meydana gelir.
Etki alanını daraltan dört önlem vardır:
- Veritabanı volume'unu
external: trueolarak tanımlayın. Compose, sahibi olmadığı bir volume'u kaldırmaz; bu nedenle-vona erişemez. Volume'u bir kezdocker volume create myapp_pgdataile oluşturursunuz. - Rutin yeniden başlatmalar için
docker compose stopvedocker compose startkullanın. Compose'ta down ile stop arasındaki fark her birinin neyi kaldırdığını açıklar. - Dump dosyalarını, Compose'un yönettiği tüm volume'ların dışında bir host path üzerinde tutun.
- Önem verdiğiniz verileri barındıran bir stack'e, sorun giderme yanıtından alınan
-vkomutunu asla yapıştırmayın.
Veritabanı portunu dış dünyaya açmayın
Bu satır, veritabanınızı genel internete açık hale getirir:
ports:
- "5432:5432"Bu yapılandırma, veritabanını tüm ağ arayüzlerine bağlar. Docker, bir portu yayınlarken paketin hedef adresini, güvenlik duvarınızın giriş kuralları devreye girmeden önce yeniden yazar. ufw kuralları ise giriş zincirinde (input chain) yer aldığından, ufw deny 5432 hiçbir işe yaramaz. Docker tarafından yayınlanan portların ufw'yi neden devre dışı bıraktığı bağlantısı, paketlerin zincir üzerindeki hareketini göstermektedir.
Aynı compose projesi içindeki bir uygulama, veritabanına compose ağı üzerinden servis adıyla erişebilir; bu nedenle dışarıya açılmış bir porta ihtiyaç duymaz. İlgili bloğu silin. Eğer ana makine (host) üzerinden bir istemci ile bağlanmak istiyorsanız, yalnızca loopback arayüzüne bağlayın:
ports:
- "127.0.0.1:5432:5432"Hangi servislerin dinlemede olduğunu kontrol edin:
sudo ss -ltnp | grep 5432İstediğiniz durum 127.0.0.1:5432 çıktısını görmektir. 0.0.0.0:5432 çıktısı, herkesin parolanızı deneyebileceği anlamına gelir.
Nerede ne çalıştırılmalı
Tek bir VPS üzerinde tek bir uygulama. Container kullanın. Sabitlenmiş bir isme sahip adlandırılmış bir volume, dışarıya açılmamış bir port, veritabanı ayarlarıyla uyumlu bir bellek sınırı ve restic tarafından toplanan, ana makine yoluna alınan günlük dökümler kullanın. VPS üzerinde temiz bir Docker kurulumu ile başlayın ve yığını commit ettiğiniz tek bir compose dosyasında tutun. Avantajı gerçektir: veritabanı sürümü, git üzerinde gözden geçirilebilir bir satır haline gelir.
Birden fazla servis çalıştıran bir ana makine. Her uygulama için bir veritabanı olacak şekilde container'lar kullanın; hepsini tek bir paylaşımlı sunucuya toplamayın. Paylaşımlı bir sunucu, her uygulamayı tek bir yükseltme takvimine bağlar ve tek bir hatalı sorgu herkesin kesintiye uğramasına neden olur. Her container'a kendi bellek sınırını atayın; böylece hatalı bir sorgu, sadece onu yazan uygulamayla sınırlı kalır. Birkaç küçük Postgres örneği, biraz daha fazla disk alanı harcar ancak koordinasyon yükünü ciddi oranda azaltır.
Veritabanı ürünün kendisidir. Veritabanını, sağlayıcının paket deposundan ana makine üzerinde çalıştırın veya yönetilen bir hizmet için ödeme yapın. pg_upgrade, ikili dosyaların her iki ana sürümünün de aynı anda yüklü olmasını gerektirir; paketler bunu sağlar ancak tek sürümlü bir imaj sağlamaz. Veritabanı makineye ve disklere tam hakim olduğunda, replikasyon ve WAL (write ahead log) arşivleme ile belirli bir ana geri dönüş (point in time recovery) işlemleri çok daha kolaydır. Sizi saat 03:00'te uyandıracak sistemler için her zaman en güvenilir ve standart yolu seçin.
Uygulama küçük ölçeklidir. Hiç sunucu tabanlı veritabanı çalıştırmamayı değerlendirin. Tek bir VPS üzerinde tek yazarlı bir web uygulaması için genellikle üretim ortamında SQLite kullanmak daha iyidir; bu yöntemde yedekleme tek bir dosyadan ibarettir ve yükseltme yolu bir kütüphane sürümünden geçer.
FAQ
Üretim veritabanını Docker üzerinde çalıştırmak güvenli midir?
Tek sunuculu bir uygulama yığını için evet. Container, etrafında namespace ve cgroup bulunan bir Linux sürecidir. Bir volume mount edildiğinde veritabanı, paketten kurulmuş olsaydı kullanacağı host dosya sistemine yazar. Riskler hızla değil, operasyonla ilgilidir: adı sabitlenmemiş bir volume, yanlış kullanıcı kimliğine ait bir bind mount, hiç test edilmemiş bir geri yükleme ve docker compose down -v. Bu dört noktayı güvence altına alındığında container uygundur. Veritabanı ana iş yükü olduğunda ve pg_upgrade, replication veya point-in-time recovery gerektiğinde host kurulumuna geçilmelidir.
Veritabanı verileri için bind mount mı, named volume mü kullanılmalıdır?
Host yolunu bilmek için özel bir neden yoksa named volume kullanılmalıdır. Docker dizini oluşturur ve image entrypoint'i ilk başlatmada sahipliği ayarlar. Böylece izin sorunu oluşmaz. Volume, açık bir name: ile sabitlenmeli veya external: true olarak işaretlenmelidir. Aksi halde proje dizininin yeniden adlandırılması sessizce yeni ve boş bir volume oluşturur; veritabanı da boş kalır. Host dizini, image'in çalıştığı sayısal kullanıcı kimliğine chown edildiğinde bind mount kullanılabilir. Resmi Postgres, MySQL ve MongoDB image'larının varsayılan tag'leri için bu değer 999, Postgres -alpine tag'leri için 70'tir. ls -ldn ile doğrulama yapılmalıdır. Çünkü ls -l host sisteminizin bu sayı için kullandığı adı gösterir ve bu ad container içinde anlam taşımaz.
docker compose down -v neyi siler?
Düz bir down gibi container'ları ve ağı kaldırır. Ayrıca -v, ilgili compose dosyasında tanımlanan tüm named volume'ları ve bu container'lara bağlı tüm anonymous volume'ları kaldırır. Buna veritabanı da dahildir. Onay istemi yoktur ve kurtarma yapılamaz. external: true olarak işaretlenen volume'lar kaldırılmaz. Veritabanı volume'unu external olarak işaretlemenin temel nedeni budur. Rutin yeniden başlatma için bunun yerine docker compose stop ve docker compose start kullanılmalıdır.
PostgreSQL, Docker üzerinde yeni bir major sürüme nasıl yükseltilir?
Dump ve restore yapılmalıdır. postgres:16 değerinin postgres:17 olarak değiştirilmesi ve yeniden başlatma, her iki sürümü adlandıran bir DETAIL satırıyla birlikte FATAL: database files are incompatible with server sonucunu verir. Bunun nedeni, yeni binary'lerin eski catalog düzenini okuyamamasıdır. Veri zarar görmez. Eski tag yeniden ayarlandığında container başlar. Çalışan eski container'a karşı yeni sürümün client'ını kullanarak bir pg_dumpall alınmalı ve dosyanın PostgreSQL database cluster dump complete ile bittiği doğrulanmalıdır. Ardından yeni tag boş bir volume üzerinde başlatılmalı ve dump yüklenmelidir. postgres:18 sonrasında bu volume, /var/lib/postgresql/data yerine /var/lib/postgresql konumuna mount edilmelidir. Aynı major sürüm içindeki minor yükseltmeler için yalnızca pull ve yeniden başlatma gerekir.
Veritabanı container'ım neden 137 koduyla kapanıyor?
137, 128 ile signal 9'un toplamıdır. Bu nedenle süreci doğrudan sonlandıran bir işlem vardır. docker inspect <container> | grep -i oomkilled çalıştırılmalıdır. true değeri, OOM killer'ın container içindeki bir süreci sonlandırdığı anlamına gelir. Bunun olağan nedeni, container'ın kendi cgroup bellek sınırına ulaşmasıdır. Yaygın sorun, bellek ayarlarının container yerine host için yapılandırılmasıdır. Container içindeki araçlar host'un toplam belleğini göstermeye devam eder. Bu nedenle 16 GB için ayarlanan bir buffer, 2 GB belleğin içinde çalışmaya zorlanır. Container'a verilen sınıra uygun olacak şekilde shared_buffers ve work_mem veya innodb_buffer_pool_size ayarlanmalıdır. Hangi sürecin kernel tarafından seçildiğini ve sonlandırmanın host genelindeki bir Out of memory değil, container sınırı nedeniyle gerçekleştiğini doğrulamak için journalctl -k içindeki ilgili Memory cgroup out of memory satırı kontrol edilmelidir.