SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor · Diperbarui 2026-10-18

Menjalankan Database di Docker atau Host Server?

Menjalankan PostgreSQL, MySQL, MongoDB, atau Redis di Docker aman untuk produksi. Pelajari risiko pengelolaan volume, upgrade versi, backup, dan limit memori container.

Apakah database sebaiknya berjalan di Docker atau pada host?

Jalankan database di Docker. Untuk satu stack aplikasi pada satu VPS, PostgreSQL, MySQL, MongoDB, atau Redis dalam container merupakan pilihan produksi yang wajar. Perdebatan tentang hal ini biasanya berfokus pada argumen yang keliru. Container adalah proses Linux dengan namespace dan cgroup di sekitarnya, bukan mesin virtual. Jadi, tidak ada hypervisor antara database dan disk. Dengan bind mount atau local named volume, operasi baca dan tulis berlangsung pada filesystem host, yaitu filesystem yang sama dengan yang digunakan oleh instalasi paket.

Biaya sebenarnya terletak pada aspek operasional. Empat hal menentukan apakah pengaturan ini berjalan baik atau berubah menjadi masalah yang lambat dan sulit ditangani: lokasi data, pemilik direktori tersebut, proses upgrade major version, dan apakah Anda pernah memulihkan backup. Jika semua hal itu benar, container hanya menjadi detail implementasi. Jika tidak, container akan menjadi hal yang Anda salahkan.

Keputusan ini berlaku untuk setiap database server. Contoh di bawah menggunakan PostgreSQL, MySQL, MongoDB, dan Redis. Perbedaan khusus setiap produk akan dijelaskan jika relevan.

Apa yang sebenarnya diubah oleh container

Bukan path penyimpanan, selama Anda melakukan mount. Kernel yang sama, page cache yang sama, sistem berkas yang sama.

Ada satu jebakan performa yang nyata, yaitu jika Anda tidak melakukan mount apa pun. Tanpa volume, direktori data masuk ke lapisan writable container, yaitu overlay filesystem yang ditumpuk di atas image. Penulisan di sana lebih lambat, dan seluruh lapisan tersebut dihapus saat container dihapus. Itulah asal mula keluhan "database saya kosong pagi ini".

Apa yang benar-benar berubah:

  • Siklus hidup. docker compose down menghancurkan container. Apa pun yang tidak berada dalam volume akan ikut hilang.
  • Versi. Tag image adalah versinya. Tidak ada apt upgrade di dalam container database yang bertahan setelah docker compose pull berikutnya.
  • Akuntansi memori. Batas cgroup adalah dinding keras yang ditegakkan oleh kernel, dan sebagian besar default database tidak menyesuaikan diri dengan batas tersebut. MySQL 9.3 atau yang lebih baru membaca batas tersebut untuk beberapa pengaturan. MongoDB mencoba melakukannya untuk cache WiredTiger-nya, tetapi dokumentasinya sendiri memperingatkan bahwa hal itu mungkin tidak berhasil dalam beberapa kasus. PostgreSQL dan Redis tidak melakukannya.
  • Pengguna. Proses berjalan sebagai numeric user id di dalam container, yang mungkin tidak memiliki akses apa pun di host Anda.

Lokasi data menentukan semuanya

Ada dua pilihan yang baik dan satu kesalahan umum.

  • Named volume: pgdata:/var/lib/postgresql/data. Docker membuat direktori di /var/lib/docker/volumes/<project>_pgdata/_data, lalu entrypoint image menetapkan ownership pada eksekusi pertama. Ini adalah pilihan default.
  • Bind mount: /srv/appname/pg:/var/lib/postgresql/data. Anda menentukan path-nya, sehingga Anda bertanggung jawab atas masalah permission.
  • Tanpa mount sama sekali. Lihat penjelasan di atas. Data berada di dalam container.

Perbandingan lengkapnya merupakan topik tersendiri, dan bind mount dibandingkan named volume membahasnya. Untuk database, ringkasnya: gunakan named volume kecuali Anda memiliki alasan khusus untuk mengetahui path di host. Jika menggunakan bind mount, letakkan di lokasi yang stabil seperti /srv/appname/pg, bukan di dalam direktori project yang dapat dijangkau oleh git clean.

Berhati-hatilah dengan penyimpanan jaringan. Jangan menempatkan direktori data database di NFS (network file system) atau mount jaringan lain yang perilaku locking dan fsync-nya belum Anda uji. PostgreSQL mendokumentasikan satu persyaratan tegas untuk NFS, yaitu mount yang menggunakan opsi hard, dan sangat merekomendasikan opsi export sync pada server NFS. Tanpa opsi tersebut, fsync pada client tidak dijamin mencapai disk server. Database mengasumsikan bahwa fsync yang berhasil berarti byte sudah tersimpan pada penyimpanan yang stabil. Jika asumsi tersebut keliru, kerusakan data dapat muncul beberapa minggu kemudian.

Tetapkan nama volume sebelum volume hilang

Compose memberi nama volume <project>_<volume>, dan nama project secara default mengikuti nama direktori. Jadi, identitas volume bergantung pada nama direktori, yang dapat diubah orang tanpa menyadarinya.

Pindahkan /srv/app ke /srv/app-old, atau ubah nama key pgdata di file compose, lalu docker compose up -d berikutnya akan membuat volume kosong yang benar-benar baru. Postgres menginisialisasi cluster baru ke dalamnya. Container tetap sehat, aplikasi berjalan, dan semua tabel hilang. Volume lama masih tersimpan di disk dengan nama lama. Ini kabar baiknya.

docker volume ls
docker volume inspect app_pgdata

Tetapkan nama tersebut secara eksplisit agar hal ini tidak terjadi. Tetapkan nama project dan nama volume secara eksplisit:

name: myapp

services:
  db:
    image: postgres:17
    volumes:
      - pgdata:/var/lib/postgresql/data

volumes:
  pgdata:
    name: myapp_pgdata

Jika volume yang tidak sesuai sudah menyimpan data Anda, salin data tersebut saat database dihentikan:

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 db

Jika Anda menyalinnya saat database masih berjalan, hasilnya adalah salinan file yang tidak konsisten karena file tersebut sedang ditulis. Hentikan database terlebih dahulu.

Siapa yang memiliki direktori data

Image resmi Postgres, MySQL, dan MongoDB menjalankan servernya sebagai user numerik tanpa hak istimewa: 999 pada tag default, dan 70 pada tag Postgres -alpine. Saat container dimulai sebagai root, entrypoint mengubah kepemilikan direktori data ke user tersebut, lalu menurunkan hak aksesnya. Karena itu, bind mount yang kosong biasanya langsung berfungsi pada percobaan pertama.

Hal ini gagal segera setelah Anda menetapkan user: dalam file compose, karena entrypoint tidak lagi memiliki hak istimewa untuk memperbaiki apa pun. Postgres menyatakannya secara langsung:

initdb: error: could not change permissions of directory "/var/lib/postgresql/data": Operation not permitted

Direktori data yang sudah ada dengan mode yang salah menghasilkan pesan berbeda. Pesan ini perlu dikenali karena perbaikannya adalah chmod, bukan chown:

FATAL:  data directory "/var/lib/postgresql/data" has invalid permissions
DETAIL:  Permissions should be u=rwx (0700) or u=rwx,g=rx (0750).

Entrypoint MongoDB memperbaiki kepemilikan dengan cara yang sama. Jadi, error file lock ini berarti proses tersebut gagal melakukannya. Penyebabnya biasanya user: ditetapkan, atau mount menolak chown dari root:

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.

Perbaikannya adalah menjalankan chown pada direktori host menggunakan id numerik, bukan nama:

sudo chown -R 999:999 /srv/appname/pg
sudo chmod 700 /srv/appname/pg
ls -ldn /srv/appname/pg

ls -ldn menampilkan angka, bukan nama, dan hasilnya seharusnya menunjukkan 999 999. Untuk image Postgres -alpine, gunakan 70:70 sebagai gantinya dan hasilnya seharusnya 70 70. Account bernama postgres pada host Anda dan account bernama postgres di dalam image tidak saling terkait. Kernel membandingkan angka, sedangkan nama dicari secara terpisah pada masing-masing sisi. cara PUID dan PGID memetakan user host ke dalam container menjelaskan pemetaan tersebut dengan benar. Pada Docker rootless atau pemetaan user namespace, angkanya dapat berubah lagi. Karena itu, baca id dari container yang sedang berjalan, bukan mengasumsikan nilainya 999.

Named volume membuat seluruh masalah pada bagian ini tidak terjadi saat pertama kali dijalankan, karena Docker membuat direktori kosong dan entrypoint menjadi pemiliknya.

Upgrade: pemutakhiran paket dibandingkan perubahan tag image

Pada host, apt upgrade membawa Anda ke versi minor berikutnya. Distribusi Anda tidak akan menaikkan versi mayor database secara otomatis. Saat Anda memilih untuk menaikkannya, kedua rangkaian biner dapat diinstal sekaligus. Inilah yang diperlukan oleh pg_upgrade.

Dalam container, tag adalah versinya. Jadi, upgrade berarti mengubah satu baris. Pemutakhiran minor menjadi sederhana, sedangkan pemutakhiran mayor memerlukan prosedur.

Ubah postgres:16 menjadi postgres:17, jalankan docker compose up -d, dan container langsung berhenti:

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.

Tidak ada data yang rusak. Biner baru menolak membaca tata letak katalog pada disk yang lama. Tata letak ini berubah di antara versi mayor. Kembalikan tag ke postgres:16 dan container akan berjalan kembali. Rollback ini merupakan satu-satunya keuntungan upgrade yang benar-benar diberikan oleh container.

Metode yang didukung adalah dump dan restore. PostgreSQL menyarankan agar dump dibuat oleh client yang lebih baru. Jadi, jalankan perintah tersebut dari image baru terhadap server lama yang masih berjalan di jaringan compose:

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.sql

File tersebut setidaknya harus berukuran puluhan kilobyte dan diakhiri oleh baris yang berisi PostgreSQL database cluster dump complete. File berukuran beberapa ratus byte berarti dump gagal. Jika Anda melanjutkan, Anda hanya akan menghapus volume tanpa hasil. Lakukan pemeriksaan berikutnya hanya setelah itu:

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.sql

Siapkan satu perubahan lagi pada postgres:18. Mulai versi 18, image resmi menyimpan datanya dalam direktori berversi di bawah /var/lib/postgresql, yaitu /var/lib/postgresql/18/docker untuk versi 18, dan mendeklarasikan volumenya di /var/lib/postgresql. Volume yang masih di-mount pada /var/lib/postgresql/data akan membuat container berhenti dengan error yang diawali Error: in 18+, these Docker images are configured to store database data. Saat berpindah ke versi 18 atau yang lebih baru, ubah mount menjadi pgdata:/var/lib/postgresql. Path /var/lib/postgresql/data dalam tulisan ini berlaku untuk versi 17 dan yang lebih lama.

Engine lain memiliki perbedaan berikut:

  • MySQL 8 memperbarui data dictionary-nya sendiri saat startup. Karena itu, perubahan tag minor biasanya hanya memerlukan restart. Baca release notes sebelum berpindah antarseri rilis, dan buat dump terlebih dahulu dalam kedua kasus.
  • MariaDB mengharuskan mariadb-upgrade dijalankan setelah server aktif pada versi baru.
  • MongoDB harus di-upgrade satu versi mayor setiap kali. Setelah setiap langkah, Anda harus menetapkan feature compatibility version sebelum melanjutkan. Melewati suatu versi berarti mongod menolak untuk berjalan dan mencatat baris UPGRADE PROBLEM yang menyebutkan featureCompatibilityVersion. Mulai MongoDB 7.0, perintah tersebut memerlukan flag konfirmasi eksplisit: db.adminCommand({ setFeatureCompatibilityVersion: "8.0", confirm: true }).
  • Redis dapat memuat file snapshot versi lama, tetapi tidak dapat memuat file versi yang lebih baru. Karena itu, upgrade berarti restart, sedangkan downgrade dapat gagal memuat data.

Aturan umumnya: container memudahkan downgrade, tetapi tidak membuat upgrade menjadi lebih mudah.

Mengapa container database saya keluar dengan kode 137?

Karena OOM (out of memory) killer milik kernel telah mematikannya. 137 adalah 128 ditambah sinyal 9.

docker compose ps --all
docker inspect myapp-db-1 | grep -i oomkilled
journalctl -k | tail -n 20

docker compose ps --all menampilkan Exited (137). Tanpa --all, Compose hanya mencantumkan container yang sedang berjalan, sehingga database yang mati tidak muncul dalam output. Baris inspect membaca "OOMKilled": true, dan log kernel memuat entri yang cocok:

Memory cgroup out of memory: Killed process 4711 (postgres) total-vm:2170416kB

OOMKilled hanya memberi tahu Anda bahwa OOM killer mengakhiri proses di dalam container. Awalan Memory cgroup out of memory adalah penanda bahwa itu adalah batas container itu sendiri. Kekurangan memori di seluruh host mencatat Out of memory: Killed process sebagai gantinya, dan dalam kasus itu perbaikannya ada di host, bukan di dalam container.

Berikut adalah mekanismenya, dan ini mengejutkan banyak orang. Di dalam container, free dan /proc/meminfo tetap melaporkan total memori host, dan batas cgroup tidak mengubah angka tersebut. PostgreSQL tidak menentukan ukuran apa pun berdasarkan angka itu: shared_buffers defaultnya adalah 128MB, dan nilai yang lebih besar adalah nilai yang Anda pilih atau yang disarankan oleh panduan tuning. innodb_buffer_pool_size milik MySQL juga defaultnya adalah 128M. Masalah dimulai ketika pengaturan ditentukan berdasarkan apa yang dilaporkan oleh sistem. Panduan PostgreSQL sendiri menyarankan 25% dari memori sistem sebagai shared_buffers awal, jadi pada host 16 GB dengan batas 2 GB, aturan tersebut menghasilkan 4 GB, dan cgroup akan mematikan database jauh sebelum host itu sendiri mengalami tekanan. Beberapa mesin sekarang membaca batas tersebut untuk beberapa pengaturan default: MySQL 9.3 ke atas melakukannya, dan MongoDB menggunakannya untuk cache WiredTiger saat ia dapat mendeteksinya. Keduanya tidak menentukan ukuran segalanya berdasarkan batas tersebut, dan dokumentasi MongoDB sendiri menyatakan bahwa deteksi bisa gagal. Jadi, batas memori saja tidak cukup. Anda juga harus memberi tahu database apa yang dimilikinya:

  • PostgreSQL: atur shared_buffers, dan perhatikan work_mem. work_mem berlaku untuk setiap operasi sort atau hash, dan setiap koneksi dapat menjalankan beberapa operasi sekaligus, jadi nilai yang besar dikalikan lima puluh koneksi adalah penyebab umum container mati di bawah beban, bukan saat startup.
  • MySQL dan MariaDB: atur innodb_buffer_pool_size, yang defaultnya adalah 128M. Pada MySQL sebelum 9.3, biarkan innodb_dedicated_server mati di dalam container, karena ia menentukan ukuran buffer pool dari memori mesin, yang dalam hal ini berarti memori host. Mulai 9.3 ke atas, MySQL membaca batas container dan innodb_dedicated_server menentukan ukuran berdasarkan batas tersebut, tetapi ukuran buffer pool yang eksplisit tetap menjadi pilihan yang dapat diprediksi.
  • MongoDB: atur ukuran cache WiredTiger secara eksplisit. MongoDB menggunakan batas container saat ia dapat mendeteksinya (hostInfo melaporkannya sebagai memLimitMB), tetapi dokumentasinya sendiri memperingatkan bahwa hal itu mungkin tidak berhasil dalam beberapa kasus dan menyarankan Anda untuk mengatur --wiredTigerCacheSizeGB atau --wiredTigerCacheSizePct di bawah memori container.
  • Redis: maxmemory defaultnya tidak terbatas, sehingga Redis akan terus tumbuh sampai cgroup menghentikannya. Atur maxmemory dengan aman di bawah batas container dan pilih maxmemory-policy.

Postgres juga melaporkan kejadian tersebut dari sisinya sendiri, dan pasangan baris ini adalah apa yang akan Anda temukan di log:

LOG:  server process (PID 123) was terminated by signal 9: Killed
LOG:  terminating any other active sessions due to crash of another server process

Satu backend yang dimatikan memaksa setiap backend lainnya untuk restart, karena memori bersama mungkin menjadi tidak konsisten. Itu adalah badai koneksi bagi aplikasi Anda, bukan peristiwa yang tenang. mengatur batas memori di Docker Compose mencakup sintaksis dan perbedaan antara mem_limit dan bentuk deploy.resources.

Tidak ada dari hal ini yang hilang di host. Masalah ini hanya berpindah. Tanpa cgroup, database akan bersaing dengan semua hal lain di sistem, dan OOM killer host akan memilih korban berdasarkan skor, yang bisa jadi adalah sshd. Batas yang mematikan database secara terprediksi lebih mudah dikelola daripada OOM host yang mengunci akses Anda.

Cadangan: lakukan dump di dalam, buat cadangan di luar

Jangan membuat cadangan database yang sedang berjalan dengan menyalin direktori datanya. Salinan tingkat berkas yang dibuat saat server sedang menulis merupakan salinan yang tidak utuh. Masalahnya baru diketahui saat pemulihan.

Ada dua metode yang benar: lakukan dump menggunakan alat bawaan database saat database berjalan, lalu buat cadangan dump tersebut; atau hentikan container dan salin volume dalam kondisi tidak aktif.

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 sangat penting. Tanpanya, docker compose exec dapat menghubungkan terminal ke perintah tersebut, dan lapisan terminal menambahkan carriage return ke aliran output. Dump teks kemudian dipulihkan dengan error yang tidak wajar, sedangkan dump biner menjadi rusak. Kegagalan ini tidak terlihat saat pencadangan, tetapi baru muncul satu bulan kemudian.

--single-transaction memberi mysqldump snapshot konsisten untuk tabel InnoDB tanpa mengunci seluruh server.

Perintah tersebut masing-masing menulis satu file. Perintah itu bukan sistem pencadangan: tidak ada retensi, salinan di luar server, atau verifikasi. Serahkan direktori dump kepada alat yang menangani ketiganya. Itulah kegunaan pencadangan restic dari VPS. Buat cadangan /srv/backups, bukan /var/lib/docker/volumes.

Selanjutnya, jalankan pemulihan karena cadangan yang belum pernah dipulihkan bukanlah cadangan:

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 seharusnya menampilkan tabel aplikasi Anda. Hasil kosong atau Did not find any relations. berarti dump tersebut tidak seperti yang Anda kira. Hapus restore_test setelah selesai.

Perintah yang menghapus semuanya

docker compose down -v.

down biasa menghapus container dan network. -v juga menghapus setiap named volume yang dideklarasikan dalam file compose tersebut, serta setiap anonymous volume yang terpasang pada container-container itu. Tidak ada konfirmasi dan tidak ada cara untuk membatalkannya. Ini adalah cara paling umum yang menyebabkan database self-hosted hancur. Biasanya hal ini terjadi saat melakukan troubleshooting terhadap masalah yang tidak terkait, karena sebuah jawaban di forum menyarankan perintah tersebut.

Empat hal berikut mengurangi dampak kerusakan:

  • Deklarasikan volume database sebagai external: true. Compose tidak akan menghapus volume yang bukan miliknya, sehingga -v tidak dapat menjangkaunya. Buat volume tersebut sekali dengan docker volume create myapp_pgdata.
  • Gunakan docker compose stop dan docker compose start untuk restart rutin. perbandingan down dan stop di Compose menjelaskan hal yang dihapus oleh masing-masing perintah.
  • Simpan dump pada host path di luar semua volume yang dikelola compose.
  • Jangan pernah menempelkan -v dari jawaban troubleshooting ke stack yang menyimpan data penting.

Jangan publikasikan port database

Baris ini menempatkan database Anda di Internet publik:

    ports:
      - "5432:5432"

Baris tersebut mengikat port ke semua antarmuka. Docker memublikasikan port dengan mengubah tujuan paket sebelum aturan input firewall Anda memprosesnya. Aturan ufw berada di rantai input, sehingga ufw deny 5432 sama sekali tidak berpengaruh. mengapa port yang dipublikasikan Docker melewati ufw menjelaskan penelusuran rantai tersebut.

Aplikasi dalam project compose yang sama dapat mengakses database menggunakan nama service pada jaringan compose, sehingga tidak memerlukan port yang dipublikasikan. Hapus blok tersebut. Jika Anda ingin client pada host mengaksesnya, ikat port hanya ke loopback:

    ports:
      - "127.0.0.1:5432:5432"

Periksa port yang benar-benar sedang listening:

sudo ss -ltnp | grep 5432

127.0.0.1:5432 adalah konfigurasi yang Anda inginkan. 0.0.0.0:5432 berarti siapa pun dapat mencoba kata sandi Anda.

Jalankan di mana

Satu aplikasi pada satu VPS. Gunakan container. Pakai named volume dengan nama yang ditetapkan, tanpa port yang dipublikasikan, memory limit yang sesuai dengan pengaturan database, serta dump setiap malam ke path pada host yang dikumpulkan oleh restic. Mulai dari instalasi Docker yang bersih pada VPS dan simpan stack dalam satu file compose yang Anda commit. Keuntungannya nyata: versi database menjadi baris yang dapat ditinjau di git.

Host yang menjalankan beberapa service. Gunakan container, satu database untuk setiap aplikasi, bukan satu server bersama untuk semuanya. Server bersama mengikat semua aplikasi pada satu jadwal upgrade, dan satu query yang tidak terkendali dapat menyebabkan outage untuk semua aplikasi. Berikan setiap container memory limit sendiri agar query yang bermasalah hanya berdampak pada aplikasi yang menjalankannya. Beberapa instance Postgres kecil membutuhkan sedikit lebih banyak disk, tetapi jauh lebih sedikit koordinasi.

Database adalah produknya. Jalankan database pada host dari repository paket vendor, atau gunakan managed service berbayar. pg_upgrade memerlukan kedua versi mayor binary terpasang secara bersamaan. Hal ini dapat disediakan oleh paket, tetapi tidak oleh image dengan satu versi. Replication dan point in time recovery dengan pengarsipan WAL (write ahead log) juga lebih mudah jika database mengelola mesin dan disk-nya sendiri. Pilih cara yang sederhana dan stabil untuk sistem yang akan mengirimkan page kepada Anda pada 03:00.

Aplikasinya kecil. Pertimbangkan untuk tidak menjalankan server database sama sekali. Aplikasi web single-writer pada satu VPS sering kali lebih sesuai menggunakan SQLite di production pada VPS, karena backup-nya hanya satu file dan jalur upgrade-nya berupa versi library.

FAQ

Apakah aman menjalankan database produksi di Docker?

Ya, untuk stack aplikasi pada satu server. Container adalah proses Linux dengan namespace dan cgroup di sekelilingnya. Dengan volume yang di-mount, database menulis ke filesystem host yang sama seperti jika database diinstal dari package. Risikonya bersifat operasional, bukan terkait kecepatan: volume yang namanya tidak dipatok, bind mount yang dimiliki user id yang salah, restore yang belum pernah diuji, dan docker compose down -v. Jika keempat hal tersebut ditangani, container dapat digunakan dengan baik. Gunakan instalasi langsung pada host ketika database menjadi workload utama dan Anda memerlukan pg_upgrade, replikasi, atau point-in-time recovery.

Sebaiknya menggunakan bind mount atau named volume untuk data database?

Gunakan named volume, kecuali Anda memiliki alasan khusus untuk mengetahui path pada host. Docker membuat direktori tersebut, dan entrypoint image mengatur ownership saat pertama kali dijalankan. Dengan demikian, masalah permission tidak muncul. Tetapkan volume dengan name: eksplisit atau tandai sebagai external: true. Jika tidak, penggantian nama direktori project secara diam-diam akan menghasilkan volume kosong baru dan database kosong. Bind mount dapat digunakan jika Anda menjalankan chown pada direktori host agar dimiliki numeric user id yang digunakan image. Nilainya adalah 999 untuk tag default image resmi Postgres, MySQL, dan MongoDB, serta 70 untuk tag Postgres -alpine. Verifikasi dengan ls -ldn, karena ls -l menampilkan nama pada host untuk angka tersebut dan nama itu tidak bermakna di dalam container.

Apa yang dihapus oleh docker compose down -v?

Perintah tersebut menghapus container dan network seperti down biasa. Selain itu, -v menghapus semua named volume yang dideklarasikan dalam file compose tersebut, serta semua anonymous volume yang terhubung ke container tersebut. Itu termasuk database. Tidak ada prompt konfirmasi dan tidak ada pemulihan. Volume yang ditandai external: true tidak dihapus. Inilah alasan utama untuk menandai volume database sebagai external. Untuk restart rutin, gunakan docker compose stop dan docker compose start.

Bagaimana cara meng-upgrade PostgreSQL ke versi major baru di Docker?

Lakukan dump dan restore. Mengubah postgres:16 menjadi postgres:17 lalu melakukan restart menghasilkan FATAL: database files are incompatible with server dengan baris DETAIL yang mencantumkan kedua versi. Binary baru tidak dapat membaca layout catalog lama. Tidak ada data yang rusak. Kembalikan tag lama dan database dapat dijalankan kembali. Buat pg_dumpall menggunakan client versi baru terhadap container lama yang sedang berjalan. Pastikan file tersebut diakhiri dengan PostgreSQL database cluster dump complete. Kemudian jalankan tag baru pada volume kosong dan muat dump tersebut. Mulai postgres:18, mount volume tersebut pada /var/lib/postgresql, bukan /var/lib/postgresql/data. Upgrade minor dalam satu versi major hanya memerlukan pull dan restart.

Mengapa container database saya berhenti dengan kode 137?

137 adalah 128 ditambah signal 9. Artinya, suatu proses menghentikan proses tersebut secara paksa. Jalankan docker inspect <container> | grep -i oomkilled. Nilai true berarti OOM killer menghentikan proses di dalam container, biasanya karena container mencapai batas memory cgroup-nya sendiri. Penyebab umumnya adalah pengaturan memory yang disesuaikan dengan host, bukan dengan container. Tool di dalam container tetap melaporkan total memory host. Akibatnya, buffer yang disesuaikan untuk 16 GB dapat berada di dalam batas 2 GB. Atur shared_buffers dan work_mem, atau innodb_buffer_pool_size, agar sesuai dengan batas yang diberikan kepada container. Periksa journalctl -k untuk menemukan baris Memory cgroup out of memory yang sesuai. Ini memastikan proses yang dipilih kernel dan memastikan bahwa penyebabnya adalah batas container, bukan Out of memory tingkat host.

Apakah artikel ini bermanfaat?