SSD Nodes Learn Hosting plans →
الأدلة Matt Connorبقلم Matt Connor

تشغيل قواعد البيانات في Docker أم على الخادم المباشر؟

هل تشغيل PostgreSQL أو MySQL أو Redis داخل حاوية Docker آمن للإنتاج؟ اكتشف المخاطر الحقيقية المتعلقة بإدارة المجلدات والنسخ الاحتياطي وترقيات الإصدارات لتجنب فقدان البيانات.

هل يجب تشغيل قاعدة البيانات داخل Docker أم على الخادم المضيف؟

شغّل قاعدة البيانات داخل Docker. بالنسبة لمكدس تطبيقات واحد على خادم VPS واحد، يُعد استخدام PostgreSQL أو MySQL أو MongoDB أو Redis في حاوية خياراً طبيعياً في بيئات الإنتاج، والجدل الدائر حول هذا الموضوع غالباً ما يركز على نقاط غير جوهرية. الحاوية هي عملية Linux معزولة بـ namespaces وcgroups، وليست جهازاً افتراضياً، لذا لا يوجد hypervisor بين قاعدة البيانات والقرص. باستخدام bind mount أو volume محلي مسمى، تصل عمليات القراءة والكتابة مباشرة إلى نظام ملفات المضيف، وهو نفس النظام الذي سيستخدمه تثبيت الحزمة التقليدي.

التكلفة الحقيقية هي تكلفة تشغيلية. هناك أربعة عوامل تحدد ما إذا كان هذا الإعداد جيداً أم كارثة بطيئة: مكان تخزين البيانات، ومن يملك ذلك المجلد، وكيفية إجراء ترقية الإصدار الرئيسي، وما إذا كنت قد اختبرت استعادة نسخة احتياطية من قبل. إذا أتقنت هذه الجوانب، تصبح الحاوية مجرد تفصيل تقني. وإذا أخطأت فيها، ستصبح الحاوية هي السبب الذي ستلومه.

هذا القرار ينطبق على أي قاعدة بيانات خادم. تستخدم الأمثلة أدناه PostgreSQL وMySQL وMongoDB وRedis، وتتم الإشارة إلى الاختلافات الخاصة بكل منتج حيثما كان ذلك مهماً.

ما الذي يغيّره الحاوي فعلياً

لا يغيّر مسار التخزين، ما دمت تربط مساراً به. النواة نفسها، وذاكرة الصفحات نفسها، ونظام الملفات نفسه.

يوجد فخ أداء حقيقي واحد، وهو ألا تربط أي مسار. من دون volume، ينتقل دليل البيانات إلى طبقة الكتابة الخاصة بالحاوي، وهي نظام ملفات overlay مكدّس فوق الصورة. تكون الكتابات هناك أبطأ، وتحذف الطبقة بأكملها عند إزالة الحاوي. من هنا تأتي مشكلة «كانت قاعدة البيانات فارغة هذا الصباح».

ما يتغيّر فعلاً:

  • دورة الحياة. docker compose down يحذف الحاوي. وكل ما لم يكن موجوداً في volume يُحذف معه.
  • الإصدار. وسم الصورة هو الإصدار. لا يوجد apt upgrade داخل حاوي قاعدة البيانات يبقى بعد docker compose pull التالي.
  • احتساب الذاكرة. حد cgroup هو حد صارم تفرضه النواة، ومعظم الإعدادات الافتراضية لقواعد البيانات لا تضبط نفسها وفقاً له. يقرأ MySQL 9.3 أو الإصدارات الأحدث الحد لبعض الإعدادات. ويحاول MongoDB استخدامه لذاكرة التخزين المؤقت في WiredTiger، لكن وثائقه تحذّر من أن ذلك قد لا يحدث في بعض الحالات. أما PostgreSQL وRedis فلا يفعلان ذلك.
  • المستخدم. تعمل العملية بمعرّف مستخدم رقمي داخل الحاوي، وقد لا يملك هذا المعرّف أي ملفات على المضيف.

مكان تخزين البيانات يحدد كل شيء

هناك خياران جيدان وخطأ شائع واحد.

  • وحدة تخزين مسماة: pgdata:/var/lib/postgresql/data. ينشئ Docker الدليل في /var/lib/docker/volumes/<project>_pgdata/_data، ويضبط entrypoint للصورة الملكية عند التشغيل الأول. هذا هو الخيار الافتراضي.
  • ربط mount: /srv/appname/pg:/var/lib/postgresql/data. أنت تختار المسار، لذلك تكون مسؤولاً عن مشكلة الصلاحيات.
  • من دون mount على الإطلاق. راجع ما سبق. تكون البيانات داخل الحاوية.

المفاضلة الكاملة موضوع مستقل، ويتناولها الربط مقابل وحدات التخزين المسماة. وباختصار بالنسبة إلى قاعدة البيانات: استخدم وحدة تخزين مسماة ما لم يكن لديك سبب محدد لمعرفة مسار المضيف، وإذا استخدمت ربط mount، فضَعه في مكان ثابت مثل /srv/appname/pg بدلاً من وضعه داخل دليل المشروع حيث يمكن لـgit clean الوصول إليه.

توخَّ الحذر مع التخزين الشبكي. لا تضع دليل بيانات قاعدة البيانات على NFS (نظام ملفات شبكي)، أو على أي mount شبكي آخر لم تختبر سلوك القفل وfsync فيه. توثّق PostgreSQL متطلباً واضحاً لـNFS، وهو استخدام mount للخيار hard، وتوصي بشدة بخيار التصدير sync على خادم NFS، لأنه من دونه لا يُضمن أن يصل fsync على العميل إلى قرص الخادم. تفترض قواعد البيانات أن نجاح fsync يعني أن وحدات البايت موجودة على تخزين ثابت. عندما يكون هذا الافتراض خاطئاً، يحدث تلف في البيانات لا يظهر إلا بعد أسابيع.

ثبّت اسم المجلد (Volume) قبل أن يضيع

يُسمّي Compose المجلد باستخدام <project>_<volume>، ويعتمد اسم المشروع افتراضياً على اسم المجلد الذي يحتوي الملف. لذا، تعتمد هوية المجلد على اسم المجلد، وهو أمر يغيره المستخدمون دون تفكير.

إذا نقلت /srv/app إلى /srv/app-old، أو أعدت تسمية مفتاح pgdata في ملف compose، فإن أمر docker compose up -d التالي سينشئ مجلداً جديداً وفارغاً. سيقوم Postgres بتهيئة قاعدة بيانات جديدة فيه. ستعمل الحاوية بشكل سليم، وسيبدأ التطبيق، لكن جميع الجداول ستكون مفقودة. الخبر السار هو أن المجلد القديم لا يزال موجوداً على القرص بالاسم القديم.

docker volume ls
docker volume inspect app_pgdata

ثبّت الأسماء لمنع حدوث ذلك. حدد اسم المشروع واسم المجلد بشكل صريح:

name: myapp

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

volumes:
  pgdata:
    name: myapp_pgdata

إذا كان هناك مجلد مهجور يحتوي على بياناتك، انسخ محتوياته بعد إيقاف قاعدة البيانات:

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

لا تنسخ البيانات أثناء عمل قاعدة البيانات، لأنك ستحصل على نسخة تالفة من الملفات التي كانت قيد الكتابة. أوقفها أولاً.

ملكية دليل البيانات

تشغّل صور Postgres وMySQL وMongoDB الرسمية خادمها باستخدام معرّف مستخدم رقمي غير مميّز: 999 في الوسوم الافتراضية، و70 في وسوم Postgres -alpine. عندما تبدأ الحاوية بصلاحيات root، يغيّر entrypoint ملكية دليل البيانات إلى ذلك المستخدم ثم يتخلى عن الصلاحيات. لذلك يعمل bind mount الفارغ عادةً من المحاولة الأولى.

يتعطل ذلك بمجرد تعيين user: في ملف compose، لأن entrypoint لا يعود يملك الصلاحيات اللازمة لإصلاح أي شيء. يوضح Postgres ذلك مباشرةً:

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

يعرض دليل البيانات الموجود بوضع خاطئ رسالة مختلفة. من المهم التعرّف إليها لأن الإصلاح هو chmod، وليس 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 الملكية بالطريقة نفسها. لذلك يعني خطأ ملف القفل هذا أنه تعذّر عليه تنفيذ ذلك: عادةً يكون user: معيناً، أو أن mount يرفض تنفيذ chown من 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.

الإصلاح هو تنفيذ chown على دليل المضيف باستخدام المعرّف الرقمي، وليس باستخدام اسم:

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

يطبع ls -ldn الأرقام بدلاً من الأسماء، وينبغي أن يعرض 999 999. بالنسبة إلى صورة Postgres -alpine، استخدم 70:70 بدلاً منه، وتوقّع 70 70. الحساب المسمى postgres على مضيفك والحساب المسمى postgres داخل الصورة غير مرتبطين: تقارن النواة الأرقام، ويُبحث عن الأسماء بشكل منفصل في كل جانب. يشرح كيفية ربط PUID وPGID بمستخدمي المضيف داخل حاوية هذا الربط بالتفصيل. في Docker عديم الجذر أو عند استخدام إعادة تعيين مساحة أسماء المستخدمين، تتغير الأرقام مرة أخرى. لذلك اقرأ المعرّفات من الحاوية قيد التشغيل بدلاً من افتراض أنها 999.

تجعل volumes المسماة هذا القسم غير ضروري في التشغيل الأول، لأن Docker ينشئ دليلاً فارغاً ويمنح entrypoint ملكيته.

الترقيات: ترقية حزمة مقابل تغيير وسم صورة

على المضيف، ينقلك apt upgrade عبر إصدار فرعي. لن توفّر توزيعتك إصداراً رئيسياً جديداً لقاعدة البيانات دون تدخلك. وعندما تختار الانتقال إلى إصدار رئيسي جديد، يمكن تثبيت مجموعتي الملفات الثنائية في الوقت نفسه، وهذا هو بالضبط ما يحتاج إليه pg_upgrade.

في الحاوية، يكون الوسم هو الإصدار، لذلك تتطلب الترقية تعديل سطر واحد. وهذا يجعل الترقيات الفرعية بسيطة جداً، بينما تتطلب الترقيات الرئيسية إجراءً محدداً.

غيّر postgres:16 إلى postgres:17، ثم شغّل docker compose up -d، وستتوقف الحاوية فوراً:

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.

لا يتلف شيء. ترفض الملفات الثنائية الجديدة قراءة بنية فهرس البيانات القديمة على القرص، لأنها تتغير بين الإصدارات الرئيسية. أعد الوسم إلى postgres:16، وستبدأ الحاوية مجدداً. يُعد هذا التراجع الميزة الحقيقية الوحيدة التي توفرها الحاويات في مجال الترقيات.

المسار المدعوم هو التفريغ والاستعادة. يفضّل PostgreSQL إنشاء التفريغ باستخدام العميل الأحدث، لذلك شغّله من الصورة الجديدة مقابل الخادم القديم الذي لا يزال قيد التشغيل على شبكة 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

يجب ألا يقل حجم الملف عن عشرات الكيلوبايتات، وأن ينتهي بسطر يحتوي على PostgreSQL database cluster dump complete. يشير وجود ملف من بضع مئات من البايتات إلى فشل التفريغ، وأنك على وشك حذف volume دون فائدة. بعد هذا التحقق فقط:

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

خطّط لتغيير إضافي عند postgres:18. ابتداءً من 18، تحتفظ الصورة الرسمية ببياناتها في دليل ذي إصدار ضمن /var/lib/postgresql، وهو /var/lib/postgresql/18/docker للإصدار 18، وتعرّف volume عند /var/lib/postgresql. يؤدي استمرار تركيب volume عند /var/lib/postgresql/data إلى خروج الحاوية بخطأ يبدأ بـ Error: in 18+, these Docker images are configured to store database data. عند الانتقال إلى الإصدار 18 أو إصدار أحدث، غيّر نقطة التركيب إلى pgdata:/var/lib/postgresql. مسارات /var/lib/postgresql/data الواردة في هذا المنشور مخصصة للإصدار 17 والإصدارات الأقدم.

تختلف المحركات الأخرى:

  • يحدّث MySQL 8 قاموس البيانات الخاص به عند بدء التشغيل، لذلك تكون زيادة وسم إصدار فرعي عادةً مجرد إعادة تشغيل. اقرأ ملاحظات الإصدار قبل الانتقال بين سلاسل الإصدارات، وأنشئ تفريغاً أولاً في كلتا الحالتين.
  • يتوقع MariaDB تشغيل mariadb-upgrade بعد بدء الخادم بالإصدار الجديد.
  • يجب ترقية MongoDB إصداراً رئيسياً واحداً في كل مرة. وبعد كل خطوة، عيّن إصدار توافق الميزات قبل المتابعة. يعني تخطي إصدار أن mongod يرفض البدء ويسجل سطراً من نوع UPGRADE PROBLEM يذكر featureCompatibilityVersion. ابتداءً من MongoDB 7.0، يتطلب الأمر راية تأكيد صريحة: db.adminCommand({ setFeatureCompatibilityVersion: "8.0", confirm: true }).
  • يحمّل Redis ملفات snapshot الأقدم دون مشكلة، لكنه لا يحمّل الملفات الأحدث. لذلك تكون الترقية إعادة تشغيل، بينما قد تفشل عملية التراجع في تحميل البيانات.

القاعدة العامة: تجعل الحاوية التراجع إلى إصدار أقدم سهلاً، لكنها لا تجعل الترقية أسهل.

لماذا يخرج حاوي قاعدة البيانات لدي برمز الخروج 137؟

لأن قاتل نفاد الذاكرة (OOM) في النواة أنهى العملية. الرقم 137 يساوي 128 مضافاً إليه الإشارة 9.

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

يعرض docker compose ps --all قيمة Exited (137). من دون --all، يعرض Compose الحاويات قيد التشغيل فقط، ولذلك تختفي قاعدة البيانات المتوقفة ببساطة من الناتج. يقرأ سطر inspect قيمة "OOMKilled": true، ويحمل سجل النواة إدخالاً مطابقاً:

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

يخبرك OOMKilled فقط بأن قاتل OOM أنهى عملية داخل الحاوي. أما السابقة Memory cgroup out of memory فهي التي توضّح أن الحد الخاص بالحاوي هو السبب. ويسجل نقص الذاكرة على مستوى المضيف Out of memory: Killed process بدلاً من ذلك، وعندها يكون الإصلاح على المضيف لا داخل الحاوي.

إليك الآلية، وهي تفاجئ بعض المستخدمين. داخل الحاوي، ما زال free و/proc/meminfo يعرضان إجمالي ذاكرة المضيف، ولا يغيّر حد cgroup هذا الرقم. لا يضبط PostgreSQL إعداداته اعتماداً عليه: القيمة الافتراضية لـ shared_buffers هي 128MB، وأي قيمة أكبر اختارها إما أنت أو دليل ضبط. كما أن القيمة الافتراضية لـ innodb_buffer_pool_size في MySQL هي 128M. تبدأ المشكلة عندما تُضبط الإعدادات اعتماداً على ما يعرضه الخادم. تقترح إرشادات PostgreSQL نفسها استخدام 25% من ذاكرة النظام كنقطة بدء لـshared_buffers، ولذلك تؤدي هذه القاعدة على مضيف بسعة 16 GB وحدّ قدره 2 GB إلى قيمة 4 GB، فيقتل cgroup قاعدة البيانات قبل وقت طويل من تعرض المضيف نفسه لأي ضغط. تقرأ بعض المحركات الآن الحد لبعض القيم الافتراضية: يفعل MySQL 9.3 والإصدارات الأحدث ذلك، ويستخدمه MongoDB لذاكرة التخزين المؤقت في WiredTiger عندما يتمكن من اكتشافه. لكن أياً منهما لا يضبط كل شيء اعتماداً عليه، وتذكر وثائق MongoDB نفسها أن الاكتشاف قد يفشل. لذلك لا يكفي تحديد حد للذاكرة وحده. يجب أن تحدد أيضاً مقدار الذاكرة المتاح لقاعدة البيانات:

  • PostgreSQL: اضبط shared_buffers، وانتبه إلى work_mem. يُطبّق work_mem على كل عملية فرز أو تجزئة، ويمكن لكل اتصال تشغيل عدة عمليات منها في الوقت نفسه. لذلك تكون قيمة كبيرة مضروبة في خمسين اتصالاً هي السبب المعتاد لموت الحاوي تحت الحمل بدلاً من موته عند بدء التشغيل.
  • MySQL وMariaDB: اضبط innodb_buffer_pool_size، وقيمته الافتراضية 128M. في MySQL قبل الإصدار 9.3، اترك innodb_dedicated_server معطلاً داخل الحاوي، لأنه يضبط تجمع المخازن المؤقتة اعتماداً على ذاكرة الجهاز، والمقصود هنا ذاكرة المضيف. بدءاً من الإصدار 9.3، يقرأ MySQL حدود الحاوي ويضبط innodb_dedicated_server اعتماداً عليها، لكن يظل تحديد حجم تجمع المخازن المؤقتة صراحةً هو الخيار الأكثر قابلية للتنبؤ.
  • MongoDB: اضبط حجم ذاكرة التخزين المؤقت في WiredTiger صراحةً. يستخدم MongoDB حد الحاوي عندما يتمكن من اكتشافه (يعرض hostInfo هذا الحد على أنه memLimitMB)، لكن وثائقه تحذّر من أن ذلك قد لا يحدث في بعض الحالات، وتطلب منك ضبط --wiredTigerCacheSizeGB أو --wiredTigerCacheSizePct على قيمة أقل من ذاكرة الحاوي.
  • Redis: القيمة الافتراضية لـmaxmemory غير محدودة، ولذلك يستمر Redis في النمو حتى يوقفه cgroup. اضبط maxmemory على قيمة أقل بكثير من حد الحاوي، واختر maxmemory-policy.

يسجل Postgres الحدث أيضاً من جانبه، وهذان السطران هما ما ستجده في السجل:

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

يؤدي إنهاء backend واحد إلى إعادة تشغيل جميع وحدات backend الأخرى، لأن الذاكرة المشتركة قد تصبح غير متسقة. وهذا يسبب عاصفة اتصالات لتطبيقك، وليس حدثاً هادئاً. يشرح تحديد حدود الذاكرة في Docker Compose الصياغة والفرق بين mem_limit وصيغة deploy.resources.

لا يختفي أي من ذلك على المضيف. بل ينتقل إليه. من دون cgroup، تنافس قاعدة البيانات كل ما يعمل على الخادم، ويختار قاتل OOM في المضيف ضحية وفقاً لدرجة، وقد تكون sshd. تشغيل حد ينهي قاعدة البيانات بطريقة متوقعة أسهل إدارياً من حدوث OOM على المضيف يؤدي إلى فقدان وصولك إليه.

النسخ الاحتياطي: استخرج البيانات داخلياً، واحفظها خارجياً

لا تنسخ قاعدة بيانات قيد التشغيل عبر نسخ مجلد بياناتها مباشرة. النسخ على مستوى الملفات أثناء كتابة الخادم للبيانات يؤدي إلى ملفات تالفة، ولن تكتشف ذلك إلا عند محاولة الاستعادة.

هناك طريقتان سليمتان: استخراج البيانات (dump) باستخدام أداة قاعدة البيانات الأصلية أثناء عملها ثم نسخ ملف الاستخراج، أو إيقاف الحاوية ونسخ المجلد وهي في حالة توقف تام.

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 أمراً جوهرياً. بدونه، قد يقوم docker compose exec بربط طرفية (terminal) بالأمر، وتضيف طبقة الطرفية رموز إرجاع السطر (carriage returns) إلى تدفق المخرجات. سيؤدي ذلك إلى استعادة ملف نصي بأخطاء غريبة، بينما سيتلف ملف البيانات الثنائي (binary dump) تماماً. تفشل هذه العملية بصمت أثناء النسخ، وتظهر نتائجها الكارثية بعد شهر عند الحاجة إليها.

يمنحك --single-transaction لقطة متسقة لجداول InnoDB عبر mysqldump دون الحاجة إلى قفل الخادم بالكامل.

تنتج هذه الأوامر ملفاً واحداً لكل منها. هذه ليست نظام نسخ احتياطي: لا توجد سياسة استبقاء، ولا نسخة خارج الخادم، ولا عملية تحقق. سلّم مجلد النسخ الاحتياطي إلى أداة توفر هذه الخصائص الثلاث، وهو ما يوضحه restic backups from a VPS. انسخ /srv/backups، وليس /var/lib/docker/volumes.

ثم قم بإجراء عملية الاستعادة، لأن النسخة الاحتياطية التي لم تجرب استعادتها قط ليست نسخة احتياطية:

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 جداول تطبيقك. النتيجة الفارغة، أو ظهور Did not find any relations.، يعني أن ملف الاستخراج ليس كما تتوقع. احذف restore_test عند الانتهاء.

الأمر الذي يحذف كل شيء

docker compose down -v.

الأمر down البسيط يزيل الحاويات والشبكة. أما -v فيزيل أيضاً كل وحدة تخزين (volume) مُسمّاة مُعرّفة في ملف compose هذا، بالإضافة إلى كل وحدة تخزين مجهولة مرتبطة بتلك الحاويات. لا توجد مطالبة تأكيد ولا إمكانية للتراجع. هذه هي الطريقة الأكثر شيوعاً لتدمير قاعدة بيانات ذاتية الاستضافة، وعادة ما تحدث أثناء استكشاف أخطاء شيء غير ذي صلة، لأن إجابة في منتدى نصحت بتنفيذه.

هناك أربعة أمور تقلل من نطاق الضرر:

  • عرّف وحدة تخزين قاعدة البيانات كـ external: true. لن يقوم Compose بإزالة وحدة تخزين لا يملكها، لذا لا يمكن لـ -v الوصول إليها. أنت تنشئها مرة واحدة باستخدام docker volume create myapp_pgdata.
  • استخدم docker compose stop و docker compose start لعمليات إعادة التشغيل الروتينية. يشرح الرابط down مقابل stop في Compose ما يزيله كل منهما.
  • احتفظ بنسخ احتياطية (dumps) على مسار في المضيف خارج أي وحدة تخزين يديرها compose.
  • لا تنسخ أبداً -v من إجابة لاستكشاف الأخطاء وإصلاحها إلى حزمة (stack) تحتوي على بيانات تهتم بها.

لا تنشر منفذ قاعدة البيانات

هذا السطر يضع قاعدة بياناتك على الإنترنت العام:

    ports:
      - "5432:5432"

فهو يربط الخدمة بجميع الواجهات. يقوم Docker بنشر المنفذ عبر إعادة كتابة وجهة الحزمة قبل أن تصل إلى قواعد الإدخال في جدار الحماية الخاص بك، وبما أن قواعد ufw تقع في سلسلة الإدخال (input chain)، فإن ufw deny 5432 لا تؤدي أي وظيفة على الإطلاق. يوضح سبب تجاوز المنافذ المنشورة عبر Docker لجدار الحماية ufw مسار عبور السلسلة.

يصل التطبيق الموجود في نفس مشروع compose إلى قاعدة البيانات عبر اسم الخدمة في شبكة compose، لذا فهو لا يحتاج إلى منفذ منشور. احذف هذا الجزء. إذا كنت تريد الوصول إلى قاعدة البيانات من المضيف (host)، اربطها بـ loopback فقط:

    ports:
      - "127.0.0.1:5432:5432"

تحقق مما يستمع فعلياً على المنافذ:

sudo ss -ltnp | grep 5432

127.0.0.1:5432 هو ما تريده. أما 0.0.0.0:5432 فيعني أن أي شخص يمكنه محاولة تخمين كلمة مرورك.

ما الذي يجب تشغيله وأين

تطبيق واحد على خادم VPS واحد. استخدم حاوية (Container). خصص وحدة تخزين (Volume) باسم ثابت، ولا تنشر المنفذ (Port) للعامة، وحدد سقفاً للذاكرة يتناسب مع إعدادات قاعدة البيانات، وقم بإجراء نسخة احتياطية يومية إلى مسار على المضيف ليقوم restic بجمعها. ابدأ من تثبيت Docker نظيف على خادم VPS واحتفظ بمكدس التقنيات في ملف compose واحد تقوم برفعه إلى مستودع git. الفائدة ملموسة: يصبح إصدار قاعدة البيانات سطراً قابلاً للمراجعة في git.

مضيف يشغّل عدة خدمات. استخدم حاويات، وقاعدة بيانات واحدة لكل تطبيق، بدلاً من خادم مشترك للجميع. الخادم المشترك يربط كل تطبيق بجدول تحديث واحد، وقد يؤدي استعلام واحد خارج عن السيطرة إلى توقف جميع الخدمات. امنح كل حاوية سقفاً خاصاً للذاكرة بحيث ينحصر تأثير الاستعلام السيئ في التطبيق الذي تسبب به. استهلاك مساحة قرص إضافية قليلة لعدة نسخ صغيرة من Postgres أفضل بكثير من تعقيدات التنسيق.

قاعدة البيانات هي المنتج الأساسي. شغّلها على المضيف مباشرة من مستودع حزم المورّد، أو اشترك في خدمة مدارة. يحتاج pg_upgrade إلى تثبيت إصدارين رئيسيين من الملفات التنفيذية في وقت واحد، وهو ما توفره الحزم ولا توفره صورة (Image) ذات إصدار واحد. النسخ المتماثل والاستعادة إلى نقطة زمنية محددة عبر أرشفة WAL (سجل الكتابة المسبقة) أسهل عندما تسيطر قاعدة البيانات على الجهاز وأقراصه. اختر المسار الأكثر استقراراً وموثوقية للنظام الذي قد يوقظك من نومك في الساعة 03:00.

التطبيق صغير الحجم. فكّر في عدم تشغيل قاعدة بيانات خادم على الإطلاق. بالنسبة لتطبيق ويب بكاتب واحد على خادم VPS واحد، غالباً ما يكون استخدام SQLite في بيئة الإنتاج على خادم VPS خياراً أفضل، حيث تكون النسخة الاحتياطية ملفاً واحداً، ومسار الترقية هو مجرد تحديث لإصدار المكتبة.

FAQ

هل من الآمن تشغيل قاعدة بيانات إنتاجية داخل Docker؟

نعم، بالنسبة إلى حزمة تطبيقات تعمل على خادم واحد. الحاوية عملية Linux محاطة بـ namespaces وcgroups، لذلك تكتب قاعدة البيانات، عند تركيب volume، في نظام ملفات الخادم نفسه الذي كانت ستستخدمه لو ثبّتها من حزمة. المخاطر تشغيلية وليست متعلقة بالسرعة: volume غير مثبت الاسم، أو bind mount مملوك لمعرّف مستخدم خاطئ، أو عملية استعادة لم تختبرها من قبل، وdocker compose down -v. عالج هذه النقاط الأربع، وستكون الحاوية مناسبة. انتقل إلى تثبيت قاعدة البيانات على الخادم عندما تكون قاعدة البيانات هي الحمل الرئيسي وتحتاج إلى pg_upgrade أو replication أو point in time recovery.

هل أستخدم bind mount أم named volume لبيانات قاعدة البيانات؟

استخدم named volume ما لم يكن لديك سبب محدد لمعرفة مسار الخادم. ينشئ Docker الدليل، ويضبط entrypoint الخاص بالصورة الملكية عند التشغيل الأول، لذلك لا تظهر مشكلة الصلاحيات. ثبّت volume باستخدام name: صريح أو علّمه external: true، وإلا فإن إعادة تسمية دليل المشروع ستنشئ بصمت volume جديداً فارغاً وقاعدة بيانات فارغة. يكون bind mount مناسباً إذا نفّذت chown لدليل الخادم ليصبح مملوكاً لمعرّف المستخدم الرقمي الذي تعمل به الصورة، وهو 999 في الوسوم الافتراضية لصور Postgres وMySQL وMongoDB الرسمية، و70 في وسوم Postgres -alpine. تحقّق من ذلك باستخدام ls -ldn، لأن ls -l يعرض اسم الخادم لهذا الرقم، وهذا الاسم لا معنى له داخل الحاوية.

ماذا يحذف docker compose down -v؟

يزيل الحاويات والشبكة مثل down العادي، كما يزيل -v كل named volume مُعرّف في ملف compose، إضافة إلى كل anonymous volume متصل بهذه الحاويات. ويشمل ذلك قاعدة البيانات. لا تظهر مطالبة تأكيد، ولا توجد إمكانية للاستعادة. لا تُزال volumes المعلّمة بـexternal: true، وهذا هو السبب الرئيسي لوضع علامة external على volume قاعدة البيانات. لإعادة التشغيل الاعتيادية، استخدم docker compose stop وdocker compose start بدلاً من ذلك.

كيف أرقّي PostgreSQL إلى إصدار رئيسي جديد في Docker؟

نفّذ dump ثم restore. يؤدي تغيير postgres:16 إلى postgres:17 وإعادة التشغيل إلى FATAL: database files are incompatible with server مع سطر DETAIL يذكر الإصدارين، لأن الملفات الثنائية الجديدة لا تستطيع قراءة تنسيق catalog القديم. لا يتلف شيء: أعد الوسم القديم، وستبدأ الخدمة. أنشئ pg_dumpall باستخدام عميل الإصدار الجديد مقابل الحاوية القديمة العاملة، وتأكد من أن الملف ينتهي بـPostgreSQL database cluster dump complete، ثم شغّل الوسم الجديد على volume فارغ وحمّل dump. بدءاً من postgres:18، ركّب ذلك volume في /var/lib/postgresql بدلاً من /var/lib/postgresql/data. لا تحتاج الترقيات الثانوية داخل الإصدار الرئيسي نفسه إلا إلى pull وإعادة التشغيل.

لماذا تخرج حاوية قاعدة البيانات لديّ برمز الخروج 137؟

الرمز 137 يساوي 128 مضافاً إليه signal 9، ما يعني أن شيئاً ما أنهى العملية فوراً. شغّل docker inspect <container> | grep -i oomkilled؛ وتعني قيمة true أن OOM killer أنهى عملية داخل الحاوية، وعادةً لأن الحاوية بلغت حد الذاكرة الخاص بـcgroup. السبب المعتاد هو ضبط الذاكرة وفقاً للخادم بدلاً من الحاوية: فما زالت الأدوات داخل الحاوية تعرض إجمالي ذاكرة الخادم، ولذلك ينتهي الأمر بمخزن مؤقت مضبوط لـ16 GB داخل حاوية لا تملك إلا 2 GB. اضبط shared_buffers وwork_mem، أو innodb_buffer_pool_size، بما يتوافق مع الحد الذي منحته للحاوية. افحص journalctl -k بحثاً عن سطر Memory cgroup out of memory المطابق، لتتأكد من العملية التي اختارها kernel، وأن السبب كان حد الحاوية لا Out of memory على مستوى الخادم بأكمله.

هل كان هذا المقال مفيدًا؟