Anda memulai database dalam sebuah wadah, menambahkan beberapa data, menghapus wadah dan memulai yang baru. Datanya hilang. Hampir semua orang mempelajari pelajaran ini dengan cara yang sulit. Volume Docker dan pengikatan pengikat ada untuk menjaga data tetap hidup melebihi masa pakai satu container.

Panduan ini menjelaskan cara kerja masing-masing dan cara memilih. Perintah dan file di sini adalah contoh standar, berdasarkan perilaku Docker yang terdokumentasi, dan kami tidak menjalankannya untuk artikel ini, jadi cobalah terlebih dahulu pada data yang dapat dibuang. Detailnya dapat berbeda antara versi Docker dan Docker Desktop. Jika Anda baru mengenal container, mulailah dengan Tutorial Docker untuk pemula kami.

Mengapa data kontainer hilang

Gambar Docker terbuat dari lapisan hanya-baca. Saat sebuah container dimulai, Docker menambahkan lapisan tipis yang dapat ditulisi di atasnya, dan perubahan apa pun akan terjadi di sana. Lapisan tersebut bertahan jika dihentikan dan dimulai ulang, namun akan dihapus saat penampung dihapus.

docker run -d --name db -e POSTGRES_PASSWORD=devonly postgres:17
# ... create tables and add data ...
docker rm -f db
docker run -d --name db -e POSTGRES_PASSWORD=devonly postgres:17
# The data you added is not there

Ini memang disengaja, karena memungkinkan Anda mengganti wadah dengan bebas. Artinya, apa pun yang perlu Anda simpan harus berada di luar wadahnya. Ada tiga cara untuk melakukannya:

Volume Docker vs pengikatan pengikatan berdampingan

Volume bernama

Volume adalah penyimpanan yang dibuat dan dikelola oleh Docker. Anda menyebutnya dengan namanya, dan Anda tidak perlu peduli di mana ia tinggal secara fisik.

docker volume create pgdata

docker run -d --name db \
  -e POSTGRES_PASSWORD=devonly \
  -v pgdata:/var/lib/postgresql/data \
  postgres:17

Sekarang file database berada di pgdata. Hapus penampung dan mulai yang baru dengan volume yang sama, dan data Anda akan tetap ada. Di Linux, volume biasanya berada di bawah /var/lib/docker/volumes/, tetapi Anda tidak boleh mengedit file tersebut secara langsung. Di Docker Desktop, mereka tinggal di dalam mesin virtual, bukan di folder normal.

Jalur di dalam penampung bergantung pada gambar, jadi periksa dokumentasi gambar. Memasang ke jalur yang salah adalah kesalahan klasik: semuanya tampak berfungsi, namun data masih ditulis ke lapisan penampung. Versi utama gambar yang lebih baru juga dapat mengubah jalur ini, jadi bacalah catatan rilis sebelum memutakhirkan.

Docker akan membuat volume bernama secara otomatis jika tidak ada. Volume anonim, yang dibuat tanpa nama, juga berfungsi, namun mendapat ID acak yang panjang dan mudah hilang jejaknya. Selalu beri nama volume Anda.

Mengikat tunggangan

Bind mount memetakan jalur host tertentu langsung ke dalam container. Kedua belah pihak langsung melihat file yang sama. Ini membuatnya sempurna untuk pengembangan, karena pengeditan di editor Anda akan berlaku di container yang sedang berjalan tanpa perlu membangun kembali:

docker run -d --name web \
  -p 8080:80 \
  -v "$(pwd)/site:/usr/share/nginx/html:ro" \
  nginx:1.27

Edit file di site/, segarkan browser dan Anda akan melihat perubahannya. :ro menjadikan mount hanya-baca di dalam container, yang merupakan kebiasaan baik ketika container tidak perlu menulis di sana.

Bind mount hadir dengan beberapa trade-off:

• Mereka mengikat Anda ke host. Jalurnya harus ada di setiap mesin, sehingga penyiapannya kurang portabel.
• Mereka menyembunyikan konten gambar. Jika Anda memasang di atas /app, gambar apa pun yang ada di sana menjadi tidak terlihat. Contoh umum adalah node_modules hilang.
• Mereka mengekspos host. Sebuah container dengan mount yang dapat ditulisi dapat mengubah atau menghapus file host sebenarnya. Jangan pernah memasang jalur sensitif seperti / atau soket Docker kecuali Anda sepenuhnya memahami risikonya.
• Kinerja dapat bervariasi. Di Docker Desktop untuk macOS dan Windows, berbagi file melewati batas virtualisasi, dan bisa lebih lambat dibandingkan di Linux.

tmpfs dipasang

Mount tmpfs ada di memori host, dan tidak pernah ditulis ke lapisan container. Itu hilang ketika kontainer berhenti, sehingga sesuai dengan file sementara, cache, dan data sensitif yang berumur pendek:

docker run -d --tmpfs /app/cache:size=64m myapp:1.0

tmpfs tersedia di host Linux. Ini juga dapat mempercepat database di lingkungan pengujian sekali pakai, di mana Anda tidak peduli dengan penyimpanan datanya.

-v atau –mount?

Kedua bendera berfungsi. --mount lebih panjang, tetapi lebih eksplisit, dan banyak orang lebih menyukainya dalam skrip:

# Short form
docker run -v pgdata:/var/lib/postgresql/data postgres:17

# Explicit form
docker run --mount type=volume,source=pgdata,target=/var/lib/postgresql/data postgres:17

# Bind mount, read-only
docker run --mount type=bind,source="$(pwd)"/site,target=/usr/share/nginx/html,readonly nginx:1.27

Ada satu perbedaan yang berarti. Dengan -v, jalur host yang hilang akan dibuat untuk Anda sebagai folder kosong, yang dapat menyembunyikan kesalahan ketik. Dengan --mount dan tipe pengikatan, Docker malah melaporkan kesalahan. Selain itu, dengan -v, sisi kiri menentukan jenisnya: nama berarti volume, dan jalur berarti pengikatan. Jadi -v data:/x dan -v ./data:/x melakukan hal yang sangat berbeda.

Volume di Docker Compose

Sebagian besar proyek nyata mendeklarasikan penyimpanan dalam file Compose. Yang ini menggunakan kedua jenis, masing-masing untuk pekerjaan yang tepat:

services:
  web:
    build: .
    ports:
      - "3000:3000"
    volumes:
      - ./src:/app/src      # bind mount: live code
    depends_on:
      - db

  db:
    image: postgres:17
    environment:
      POSTGRES_PASSWORD: devonly
    volumes:
      - pgdata:/var/lib/postgresql/data   # named volume: data

volumes:
  pgdata:

Volume yang diberi nama harus dideklarasikan di bagian tingkat atas volumes. Compose mengawali nama sebenarnya dengan nama proyek. Lihat tutorial Docker Compose kami untuk panduan lengkapnya.

Perintah volume yang berguna

Periksa apa yang prune akan hapus sebelum Anda mengonfirmasinya, karena hal ini tidak dapat dibatalkan. Volume yang saat ini tidak digunakan oleh penampung mungkin masih menyimpan data penting.

Cadangkan dan pulihkan volume

Volume dapat dicadangkan dengan menjalankan container berumur pendek yang memasang volume dan folder host:

# Back up
docker run --rm \
  -v pgdata:/data:ro \
  -v "$(pwd)":/backup \
  alpine tar czf /backup/pgdata.tar.gz -C /data .

# Restore into a new volume
docker volume create pgdata_restored
docker run --rm \
  -v pgdata_restored:/data \
  -v "$(pwd)":/backup \
  alpine tar xzf /backup/pgdata.tar.gz -C /data

Untuk database langsung, menyalin file seperti ini dapat menangkap keadaan yang tidak konsisten. Hentikan penampung terlebih dahulu, atau lebih baik lagi, gunakan alat database sendiri, seperti pg_dump untuk PostgreSQL. Dan cadangan yang belum pernah Anda pulihkan sebenarnya hanyalah sebuah harapan, jadi ujilah pemulihan tersebut.

Izin berkas

“Izin ditolak” adalah masalah paling umum pada mount. File menyimpan ID pengguna dan grup numeriknya di Linux, jadi jika kontainer berjalan sebagai pengguna 1000 dan folder host milik pengguna lain, penulisan akan gagal. Beberapa cara untuk memperbaikinya:

• Jalankan penampung dengan pengguna yang cocok: docker run --user "$(id -u):$(id -g)" ...
• Siapkan kepemilikan yang benar pada gambar Anda, seperti yang dijelaskan dalam praktik terbaik Dockerfile kami.
• Pilih volume bernama untuk data, karena volume baru mengambil alih kepemilikan folder gambar saat pertama kali digunakan.
• Pada sistem yang menggunakan SELinux, pengikatan pengikatan mungkin memerlukan label :z atau :Z.

Hindari godaan chmod 777, seperti yang dijelaskan dalam panduan kami untuk perintah Linux.

Mana yang harus Anda gunakan?

Baris terakhir itu penting. Dalam produksi, kode termasuk dalam gambar, sehingga apa yang Anda uji adalah apa yang Anda jalankan. Dalam cluster, penyimpanan data kembali berfungsi secara berbeda, melalui volume persisten, yang tercakup dalam dokumentasi Kubernetes yang lebih luas. Panduan Docker vs Kubernetes kami menjelaskan hubungan keduanya.

Kesalahan umum

• Memasang ke jalur yang salah. Data masih berada di lapisan penampung, dan kemudian menghilang.
• Menjalankan down -v dengan santai. Ini akan menghapus volume bernama Anda.
• Menggunakan jalur relatif dengan -v. Formulir seperti -v data:/x membuat volume, bukan pemetaan folder.
• Menempatkan rahasia dalam pengikatan yang dapat ditulis. Memasangnya hanya-baca, atau gunakan fitur rahasia.
• Menunjuk dua kontainer database pada satu volume. Hal ini dapat merusak data.
• Tidak memiliki cadangan. Volume bukanlah cadangan. Itu tinggal di disk yang sama.

Penutup

Aturan praktisnya singkat: memberi nama volume untuk data, mengikat mount untuk kode yang Anda edit, dan tmpfs untuk hal-hal yang tidak akan bertahan lama. Cobalah di database sekali pakai. Buat volume bernama, tambahkan baris, hapus wadah, mulai yang baru, dan konfirmasikan bahwa baris Anda bertahan. Kemudian praktikkan pencadangan dan pemulihan sebelum Anda membutuhkannya.

Pertanyaan yang sering diajukan

Teruslah belajar