Docker v29 على VPS: الهجرة دون كسر المكدسات

لماذا يكسر Docker v29 المكدسات الحالية — ولماذا الآن

ما يُمكّنك هذا الدليل من فعله

• اكتشاف التوتر في إصدار API بين عميل docker الخاص بك و‏daemon‏ VPS، قبل أن تُنتج الأوامر التالية خطأً غامضاً.
• تحديد في 30 ثانية ما إذا كان VPS يعمل بـ docker-compose v1 المستقل — الملف الثنائي المُهمَل منذ Docker Desktop 3.6 والمُزال من الحزم الرسمية.
• الهجرة إلى إضافة docker compose v2 بأمرَين محدَّدَين، ثم التحقق من عمل ملفات docker-compose.yml الحالية دون تغيير في البنية.
• فهم تأثير nftables على مكدّساتك: ما يستمر في العمل ‏(شبكات Docker)‏، وما قد يتعطّل ‏(نصوصك التي تقرأ iptables)‏، وأمر التشخيص الحاسم.
• تفعيل أو تأجيل مخزن containerd وفق جدول هجرتك، مع مفتاح الإعداد الدقيق وأمر التحقق.
• تقييم توافق Dockge وPortainer وCasaOS App Store مع v29، لتجنّب اكتشاف عدم التوافق أثناء حادثة لدى العميل.
• تجهيز أسطول VPS العملاء كي يكون apt upgrade التالي حدثاً مُخطَّطاً، لا طارئاً ليليّاً.

المتطلبات قبل البدء

الخطوة 1 — تشخيص إصدار API

1. 01

   التحقق من إصداري API للعميل و‏daemon

   شغّل الأمرَين التاليَين على كل VPS تريد فحصه:

   docker version --format '{{.Client.APIVersion}}'
   docker version --format '{{.Server.APIVersion}}'

   إذا كان إصدار العميل أقل من 1.44 وكان daemon يعمل بـ v29، ستحصل على خطأ عند الأوامر التالية. العتبة 1.44 هي الحد الأدنى الذي يقبله Docker Engine v29: يفشل عميل مُترجَم لـ 1.43 أو أقدم بالخطأ Error response from daemon: client version 1.43 is too old. Minimum supported API version is 1.44, please upgrade your client.

   إذا أظهر السطران 1.44 أو أعلى، فعميلك متوافق. انتقل إلى الخطوة التالية.

2. 02

   الكشف عن وجود docker-compose v1 المستقل

   أمر docker-compose بالشَرطة وأمر docker compose بدون شَرطة ليسا الشيء ذاته. v1 ملف ثنائي Python مستقل، أما v2 فإضافة Go مُدمَجة في واجهة Docker.

   which docker-compose && docker-compose --version

   إذا أعاد الأمر مساراً في /usr/local/bin/ أو /usr/bin/ مع إصدار 1.x.x، لديك الملف الثنائي المستقل المُهمَل.

   docker compose version

   إذا أعاد هذا الأمر Docker Compose version v2.x.x، فإضافة v2 موجودة بالفعل.

الخطوة 2 — الهجرة من docker-compose v1 إلى إضافة v2

1. 03

   إزالة الملف الثنائي v1 وتثبيت الإضافة

   apt remove docker-compose
   apt install docker-compose-plugin

   على VPS يعمل بـ Debian أو Ubuntu ويستخدم المستودعات الرسمية لـ Docker Inc. ‏(download.docker.com)‏، تتوفر حزمة docker-compose-plugin بدون إعداد إضافي.

   للتحقق بعد الهجرة:

   docker compose version
   # Docker Compose version v2.36.0

2. 04

   التحقق من توافق بنية ملفات Compose الحالية

   الغالبية العظمى من ملفات docker-compose.yml المكتوبة لـ v1 تعمل دون تعديل مع إضافة v2. التحقق من ملفاتك:

   docker compose config

   يُحلّ هذا الأمر متغيرات البيئة ويُتحقق من البنية ويعرض الإعداد المُحلَّل. إخراج بلا أخطاء يعني أن ملفك متوافق.

   إذا كانت فريقك يستخدم نصوص shell تحتوي docker-compose بالشَرطة، أضف اختصاراً في /etc/bash.bashrc على VPS:

   alias docker-compose='docker compose'

الخطوة 3 — فهم تغيير خلفية الشبكة nftables والتكيّف معه

1. 05

   التحقق من أن شبكات Docker لا تزال تعمل

   البشرى السارة: docker network يعمل بشكل صحيح مع nftables. يستمر مرور حركة البيانات بين الحاويات، وترجمة عناوين الشبكة ‏(NAT)‏، وكشف المنافذ في العمل. ما يتغيّر هو الأداة الأساسية التي تكتب القواعد.

   docker network ls

   شبكات bridge الحالية لا تزال مُدرَجة. للتحقق من أن حاوية تستقبل حركة البيانات على المنفذ المتوقع:

   curl -s http://localhost:8080/health

2. 06

   تشخيص التأثير على نصوص iptables البرمجية

   تظهر المشكلة حين يفحص نص برمجي خارجي ‏(مراقبة، أو Ansible، أو قواعد UFW)‏ iptables للتحقق من وجود قواعد Docker:

   iptables -L DOCKER 2>&1

   مع خلفية nftables، هذه السلسلة فارغة أو غائبة. يُعيد النص خطأً بينما Docker يعمل بشكل مثالي. هذا ليس فشلاً في Docker — أداة التدقيق لم تعد تنظر في المكان الصحيح.

   لفحص القواعد الفعلية:

   nft list ruleset | grep -A 20 'docker'

الخطوة 4 — تقييم مخزن صور containerd وتفعيله

1. 07

   التحقق من برنامج تشغيل التخزين الحالي

   docker info | grep 'Storage Driver'

   على VPS مُحدَّث إلى v29 بدون تغييرات في الإعداد، تحصل عادةً على Storage Driver: overlay2. مخزن containerd اختياري في v29 — لا يُفعَّل تلقائياً. سيصبح الافتراضي في v30.

2. 08

   تفعيل مخزن containerd (اختياري، يُنصح به قبل v30)

   لتفعيل مخزن containerd في v29 والاستعداد للهجرة قبل فرضها في v30، أضف المفتاح التالي إلى /etc/docker/daemon.json:

   {
     "features": {
       "containerd-snapshotter": true
     }
   }

   أعد تشغيل daemon:

   systemctl restart docker

   للتحقق:

   docker info | grep 'Storage Driver'
   # Storage Driver: overlayfs

توافق الأدوات الخارجية مع Docker Engine v29

مرّر الجدول أفقيًا

استكشاف الأخطاء — أخطاء حقيقية وحلول

سيناريوهات الأخطاء الشائعة

1. 09

   الخطأ: `client version X.XX is too old. Minimum supported API version is 1.44`

   السبب: الملف الثنائي المستقل docker-compose v1 لا يزال موجوداً ويحاول التواصل مع daemon الإصدار v29.

   الحل:

   apt remove docker-compose
   apt install docker-compose-plugin
   docker compose version

   إذا كان الملف الثنائي مُثبَّتاً يدوياً ‏(خارج apt)‏، ابحث عنه:

   which docker-compose
   rm /usr/local/bin/docker-compose

2. 10

   الخطأ: `docker-compose: command not found` بعد `apt upgrade`

   السبب: تمت إزالة حزمة docker-compose ‏(v1)‏ أثناء التحديث، ولم تُثبَّت إضافة v2.

   الحل:

   apt install docker-compose-plugin

3. 11

   الخطأ: `iptables: No chain/target/match by that name` في نص مراقبة

   السبب: نصك البرمجي يفحص سلسلة DOCKER في iptables، لكن Docker v29 مع nftables لا يكتبها هناك بعد الآن.

   الحل: استبدل فحص iptables بفحص nftables:

   nft list ruleset | grep -c 'docker'

   إذا كان العدد أكبر من صفر، فقواعد Docker موجودة في nftables.

4. 12

   Dockge لا يبدأ بعد التحديث

   السبب: Dockge ‏1.4.1‏ وما قبله يستدعي مسارات API غائبة من Docker Engine v29.

   الحل:

   cd /opt/dockge
   docker compose pull
   docker compose up -d

5. 13

   الحاويات لا تستجيب على منافذها بعد إعادة تشغيل daemon

   السبب: عند أول إعادة تشغيل لـ dockerd في وضع nftables، تُعاد كتابة قواعد NAT في الخلفية الصحيحة، لكن بعض التوزيعات تعاني تعارضاً بين خدمة iptables-legacy وnftables.

   الحل:

   systemctl stop docker
   systemctl disable iptables
   systemctl start docker

   ثم تحقق من إعادة تشغيل الحاويات وكشف المنافذ:

   docker compose up -d
   docker ps --format 'table {{.Names}}\t{{.Ports}}'

تجهيز أسطولك لتجنّب الحادثة التالية

apt-mark hold docker-ce docker-ce-cli containerd.io