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

إصلاح تكرار machine-id بعد استنساخ VPS

تظهر المشكلة عندما يتشارك خادمان الملف /etc/machine-id نفسه ويتنافسان على عقدة DHCP. تعرّف إلى الخطأ، وجدّد المعرّف بأمان، وفرّغه قبل أخذ النسخة الذهبية.

ما هو ‎/etc/machine-id‎ ولماذا يهم تكراره

يقلع VPS المستنسخ باستخدام /etc/machine-id نفسه الموجود على الخادم الذي استُنسخ منه، مع أن هذه القيمة يُفترض أن تخص تثبيتاً واحداً فقط. يتطلب الإصلاح أربعة أوامر: إفراغ الملف، وإزالة نسخة D-Bus إذا كان ملفاً حقيقياً، وإعادة التوليد، وإعادة التشغيل. إعادة التشغيل هي الخطوة التي يتجاوزها بعض المستخدمين، وهي التي تجعل التغيير نافذاً.

يحتوي /etc/machine-id على سلسلة سداسية عشرية بأحرف صغيرة، منتهية بمحرف سطر جديد، وطولها 32 محرفاً. عند فك ترميزها، تكون قيمة من 16 بايتاً (128 بت). تصف صفحة الدليل الخاصة بـmachine-id(5) هذه القيمة بأنها سرية، وتذكر أنه يجب عدم كشفها عبر الشبكة، لأن أي جهة تقرأها يمكنها التعرّف إلى جهازك مرة أخرى لاحقاً. تُنشأ عادةً أثناء التثبيت أو عند الإقلاع الأول، وتبقى ثابتة عبر عمليات الإقلاع اللاحقة.

تختلط هنا ثلاثة معرّفات، لذلك من المفيد فصلها. اسم المضيف هو تسمية تختارها ويمكنك تغييرها في أي وقت. يأتي UUID الخاص بمنتج DMI (واجهة إدارة سطح المكتب) في /sys/class/dmi/id/product_uuid من برنامج Hypervisor، ولا يمكن قراءته إلا بواسطة root. أما معرّف الجهاز فهو الثالث: ينشئه نظام التشغيل، ويمكن لكل مستخدم على الجهاز قراءته.

ما الذي يقرأ معرّف الجهاز فعلياً

معرّف عميل DHCP. هذه هي الحالة المسببة للمشكلة. يعود ClientIdentifier= في قسم [DHCPv4] من ملف .network إلى القيمة المحددة في networkd.conf(5)، والقيمة الافتراضية هي duid: معرّف عميل وفق RFC 4361، مبني من IAID وDUID (المعرّف الفريد لـDHCP). يوثّق networkd.conf(5) نوع DUID الافتراضي باعتباره vendor، حيث تُنشأ قيمة DUID باستخدام 43793 بوصفه معرّف المورّد (systemd)، وباستخدام محتوى معرّف الجهاز بعد إجراء التجزئة عليه. يستخدم DHCPv6 معرّف DUID نفسه. إذا كان لدى نسختين مستنسختين معرّف الجهاز نفسه، فستنتجان قيمة التجزئة نفسها لـDUID الافتراضي. وإذا تطابقت IAID أيضاً، فسترسلان معرّف عميل متطابقاً بايتاً ببايت. تُنشئ الآلية IAID تلقائياً عبر إجراء التجزئة على اسم مستمر تحصل عليه من udev، وتعود إلى عنوان MAC عندما لا يتوفر اسم متوقع. لا يضمن تطابق أسماء الواجهات الحالية وحده تطابق IAID. لذلك يمكن لعناوين MAC مختلفة أن تنتج معرّفات عميل مختلفة رغم تطابق معرّفات الأجهزة وأسماء الواجهات. عندما تتطابق معرّفات العميل الكاملة، يرى خادم DHCP عميلاً واحداً بدلاً من عميلين، ويمنح الخادمين نفس عقد الإيجار. يتمثل العَرَض في انتقال العنوان بين الخادمين، أو فقدان أحد الخادمين عنوانه كلما جدّد الخادم الآخر عقد الإيجار.

journald. توجد ملفات السجل الدائمة في /var/log/journal/<machine-id>/، بينما توجد السجلات المتطايرة ضمن /run/log/journal/. يحمل الدليل اسمه حرفياً من المعرّف. يدمج جامع السجلات الذي يجمع السجلات وفق معرّف الجهاز هويتي النسختين المستنسختين. أما systemd-journal-remote فيفصل ملفات الإخراج وفق اسم المضيف أو عنوان نقطة النهاية المصدر.

D-Bus. بدأ تنسيق الملفات هذا في /var/lib/dbus/machine-id. وقد يكون رابطاً رمزياً إلى /etc/machine-id، أو ملفاً حقيقياً منفصلاً يحتوي على نسخته الخاصة. وهذه النسخة هي موضع الخلل في الإجراء التالي.

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

كيفية التحقق من وجود نسخة مكررة

شغّل هذا الأمر على كلا الخادمين، ثم قارن الناتج.

cat /etc/machine-id
ls -l /var/lib/dbus/machine-id
sudo cat /sys/class/dmi/id/product_uuid

تعني مطابقة معرّفات الجهاز على خادمين قيد التشغيل أن أحدهما نُسخ من الآخر. يطبع hostnamectl القيمة نفسها في سطر Machine ID: إذا كنت تفضّل استخدام أمر واحد.

تحدّد نتيجة ls -l الخطوة التالية. يظهر الرابط الرمزي كما يلي:

lrwxrwxrwx 1 root root 15 Aug 21 09:12 /var/lib/dbus/machine-id -> /etc/machine-id

يعني السطر الذي يبدأ بـ -rw-r--r-- أنّه ملف فعلي يحتوي على نسخته الخاصة من المعرّف القديم. يجب حذفه، لأن systemd-machine-id-setup يقرأه قبل أن يفحص UUID الخاص بالـhypervisor أو مولّد القيم العشوائية.

يهم UUID الخاص بالمنتج أيضاً. يستخدم systemd-machine-id-setup(1) UUID الخاص بـKVM قبل الانتقال إلى التوليد العشوائي. لذلك، إذا زوّدك موفّر الخدمة بنسختين تحملان UUID نفسه في SMBIOS (BIOS إدارة النظام)، فستحصل على معرّف الجهاز نفسه مرتين عند إعادة التوليد من هذا المصدر. تمنع UUIDs مختلفة للمنتج هذا التعارض تحديداً، لكن مصادر المعرّف السابقة تظل لها الأولوية.

إعادة إنشاء معرّف الجهاز على VPS مستنسخ

ترتيب الخطوات مهم. يفحص systemd-machine-id-setup(1) أولاً /run/machine-id، ثم يبحث عن معرّف جهاز D-Bus صالح، ثم عن بيانات الاعتماد system.machine_id، قبل أن يحاول استخدام UUID مضبوط للآلة الافتراضية أو للحاوية، وأخيراً ينشئ معرّفاً عشوائياً. اترك /var/lib/dbus/machine-id حقيقياً في مكانه، وما لم تكن /run/machine-id لها الأولوية، فستعيد إنشاء القيمة نفسها التي كنت تحاول التخلص منها. إذا أعاد البرنامج استخدام /run/machine-id أو بيانات اعتماد وبقي المعرّف دون تغيير، فأفرغ معرّف الجهاز في الصورة أثناء إيقاف تشغيلها، ثم أقلعها باستخدام مصادر هوية فريدة.

sudo truncate -s 0 /etc/machine-id
sudo rm -f /var/lib/dbus/machine-id       # only if ls -l showed a real file
sudo systemd-machine-id-setup
sudo ln -sf /etc/machine-id /var/lib/dbus/machine-id
cat /etc/machine-id

يجب التفريغ أولاً، لأن البرنامج يعمل فقط عندما يكون الملف مفقوداً أو فارغاً، ولا يفعل شيئاً إذا كان الملف يحتوي بالفعل على معرّف صالح. يعرض systemd-machine-id-setup ما فعله على standard error. على VPS يعمل بـKVM مع systemd 258 أو إصدار أحدث، عندما يختار UUID الخاص بـhypervisor، سترى:

Initializing machine ID from SMBIOS/DMI UUID.

يصف systemd 255 الخطوة نفسها باستخدام Initializing machine ID from VM UUID.. وتكون Initializing machine ID from random generator. هي الرسالة عند عدم صلاحية أي مصدر معرّف سابق. كلا الناتجين صحيح، ما دام cat /etc/machine-id يطبع الآن قيمة مختلفة عن الخادم الآخر.

يحافظ الرابط الرمزي على استخدام D-Bus وsystemd للقيمة نفسها. إذا كنت تفضّل ملفاً حقيقياً منفصلاً، فنفّذ sudo dbus-uuidgen --ensure بدلاً من أمر إنشاء الرابط الرمزي؛ فعندما يكون ملف D-Bus غير موجود، ينسخ المعرّف الصالح من /etc/machine-id. إذا كان /var/lib/dbus مفقوداً، يفشل ln مع No such file or directory، ويمكنك تخطي هذين السطرين.

ثم أعد التشغيل.

sudo reboot

لماذا لا تُعد إعادة التشغيل اختيارية

كل عملية قرأت القيمة القديمة تستخدمها ما زالت. يخزّن sd_id128_get_machine() المعرّف مؤقتاً لكل خيط؛ لذلك يواصل الخيط الذي قرأه مسبقاً إرجاع القيمة القديمة، ولا يقرأ الملف بعد تغييره إلا خيط لم يطلب المعرّف بعد. لذلك يمكن لخدمة تعمل في الخلفية أن تحتفظ بالمعرّف القديم في خيوطها الحالية، ولا تحصل على المعرّف الجديد إلا في الخيوط التي تبدأها لاحقاً. فتح journald الملف /var/log/journal/<old-id>/system.journal بالفعل، ويواصل الإلحاق به. حسب systemd-networkd معرّف DUID عند بدء تشغيله، ويواصل إرسال معرّف العميل القديم عند كل تجديد. وهذا هو عادةً سبب الفشل الذي تحاول إصلاحه تحديداً. قرأ D-Bus معرّفه عند بدء التشغيل أيضاً. يمكنك إعادة تشغيل الخدمات واحدة تلو الأخرى، لكنك ستفوّت إحداها، كما أن PID 1 يحتفظ بالقيمة القديمة أيضاً.

بعد إعادة التشغيل، تحقّق من الجزأين:

cat /etc/machine-id
ls /var/log/journal/

عند تفعيل التسجيل الدائم، يحتوي /var/log/journal/ الآن على دليل ثانٍ يحمل اسم المعرّف الجديد، وتُكتب الإدخالات الجديدة فيه. يقرأ journalctl العادي دليل الجهاز الحالي فقط، لذلك يختفي السجل السابق للاستنساخ من العرض الافتراضي. لكنه لا يزال موجوداً على القرص؛ إذ يقرأ journalctl --merge جميع أدلة journal، بما فيها الدليل القديم. احذف الدليل القديم بعد التأكد من أنك لم تعد تحتاج إلى تلك السجلات.

ولهذا السبب أيضاً لا يُعدّ container المكان المناسب لتجربة الإجراء. يشترك container في نواة المضيف. ويمكنه تشغيل systemd بوصفه PID 1 الخاص به، لكنه لا يقلع نواة خاصة به أبداً. داخل container، يستخدم systemd-machine-id-setup UUID مكوّناً للـcontainer فقط بعد فشل مصادر المعرّف السابقة؛ وإذا لم يتوفر مصدر صالح، ينشئ معرّفاً عشوائياً. اختبر الإجراء بالطريقة التي يحدث بها في بيئة الإنتاج: استنسخ VM، وشغّل الأوامر، وأعد التشغيل، ثم قارن المعرّف بالمعرّف الموجود في الجهاز المصدر.

افرغ الملف قبل أخذ snapshot، وليس بعد استنساخه

ينجح إصلاح النسخ المستنسخة واحداً تلو الآخر. لكن إصلاح image أفضل، لأن كل خادم يُستعاد من snapshot تالف يرث القيمة نفسها. اجعل هذه الخطوة آخر ما تنفذه قبل إيقاف template.

sudo truncate -s 0 /etc/machine-id
sudo rm -f /var/lib/dbus/machine-id
sudo ln -s /etc/machine-id /var/lib/dbus/machine-id
sudo shutdown -h now

أفرغ الملف. لا تحذفه. توصي machine-id(5) باستخدام ملف فارغ للصور المستخدمة على عدة أجهزة، لأن وجود ملف فارغ يتيح إجراء bind mount لملف مؤقت فوق الملف الفعلي عند استخدام image في وضع القراءة فقط. في /etc للقراءة فقط، يكون المعرّف الذي يُنشأ أثناء الإقلاع في ذلك الملف المؤقت، ثم تكتبه systemd-machine-id-setup --commit مرة واحدة بعد أن يصبح نظام الملفات قابلاً للكتابة.

يعتمد أحد الآثار الجانبية على الطريقة التي تترك بها الملف. توضّح machine-id(5) صراحةً أنه إذا كان /etc/machine-id موجوداً وفارغاً، فلا يُعدّ الإقلاع إقلاعاً أولاً، ولذلك لا يشغّل الملف الفارغ أعلاه الوحدات التي تحمل ConditionFirstBoot=yes. أما الملف المفقود، أو الملف الذي يحتوي على السلسلة uninitialized، فيجعل الإقلاع التالي إقلاعاً أولاً: تُشغَّل تلك الوحدات، كما يطبّق systemd الإعدادات المسبقة على الوحدات. اعرف ما الذي ستشغّله image باستخدام grep -rl ConditionFirstBoot /usr/lib/systemd/system/ قبل إنشاء template.

يختلف template عن snapshot، وهذا الاختلاف يحدد ما إذا كانت الهوية ستُنقل. يكون template منتج بناء تجهزه عمداً، بينما snapshot هو نسخة في نقطة زمنية من خادم واحد قيد التشغيل، وينقل هوية ذلك الخادم مع بياناته.

لماذا تتعامل صور السحابة مع هذا الأمر بشكل صحيح بينما لا تفعل لقطةك

تُبنى صور السحابة الخاصة بالتوزيعات بحيث يمكن استنساخها، لذلك تُشحن دون تعبئة معرّف الجهاز، وتملؤه عملية الإقلاع الأولى. يتضمن cloud-init خطوة موثقة لهذا الغرض تحديداً. يضبط cloud-init clean --machine-id القيمة /etc/machine-id على السلسلة الحرفية uninitialized في أنظمة systemd، ويصفها مرجع واجهة سطر أوامر cloud-init بأنّها أفضل ممارسة عند استنساخ صورة أساسية، ولذلك ينشئ الإقلاع التالي لهذه الصورة معرّف جهاز فريداً.

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

ما الذي ينسخه الاستنساخ أيضاً

  • مفاتيح مضيف SSH. يُنسخ /etc/ssh/ssh_host_* أيضاً، ولذلك يعرض الخادمان بصمة fingerprint نفسها للعملاء. احذف هذه الملفات وشغّل sudo ssh-keygen -A، أو sudo dpkg-reconfigure openssh-server على Debian وUbuntu. سيحذّرك العملاء بعد ذلك من تغيّر مفتاح المضيف، وهذا هو السلوك الصحيح.
  • اسم المضيف. اضبطه باستخدام sudo hostnamectl set-hostname app02، ثم تحقق من أن /etc/hosts ما زال يحلّ الاسم الجديد.
  • إعدادات الشبكة الثابتة. يتعارض استنساخ خادم ذي عنوان ثابت مع الخادم الأصلي بمجرد تشغيله. اقرأ /etc/netplan/ قبل أن ينضم الخادم المستنسخ إلى الشبكة.
  • الساعة. قد تؤدي استعادة لقطة تتضمن ذاكرة قيد التشغيل إلى تأخر ساعة الضيف، إلى أن يصححها الضيف أو الـhypervisor. يؤدي قفز كبير في الساعة على VPS مستعاد إلى تعطيل التحقق من شهادات TLS وإرباك ترتيب السجلات إلى أن تلحق مزامنة الوقت بالوقت الحالي.

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

FAQ

هل يجب أن أعيد التشغيل بعد تغيير /etc/machine-id؟

نعم. تحتفظ البرامج التي قرأت machine ID بالفعل بالنسخة المخزّنة مؤقتاً لديها، لذلك لا تصل القيمة الجديدة إلى الأجزاء المهمة من النظام العامل. يواصل journald الكتابة إلى دليل journal الذي يحمل اسم المعرّف القديم، ويواصل عميل DHCP إرسال معرّف عميل مشتق من القيمة القديمة، وهذا هو عادةً سبب تغييرك لها. تؤدي إعادة تشغيل الخدمات الفردية إلى إصلاح بعض هذه الحالات، لكن PID 1 يحتفظ بالقيمة القديمة أيضاً. أعد التشغيل، ثم أكّد النتيجة باستخدام cat /etc/machine-id وبمقارنة المعرّف بالخادم الآخر.

هل /etc/machine-id هو نفسه UUID الخاص بالأجهزة؟

لا. يأتي UUID الخاص بمنتج DMI في /sys/class/dmi/id/product_uuid من hypervisor، ولا يمكن قراءته إلا بواسطة root. ينشئ نظام التشغيل machine ID، ويخزّنه في ملف عادي يمكن لأي مستخدم قراءته. توجد صلة بينهما في اتجاه واحد: في ضيف KVM، يستخدم systemd-machine-id-setup UUID الخاص بـhypervisor لإنشاء machine ID جديد عندما لا ينطبق أي مصدر سابق للمعرّف. إذا اشترك نسخان في product UUID نفسه، واستخدمت عملية إعادة الإنشاء هذا المعرّف، فسينشئان machine ID نفسه. لذلك قارن هذا الملف أيضاً قبل الوثوق بالنتيجة.

هل يجب أن أحذف /etc/machine-id أم أتركه فارغاً؟

اتركه فارغاً عند إعداد image. يفضّل machine-id(5) الملف الفارغ، لأن systemd يستطيع ربط ملف مؤقت فوقه عندما تعمل image مع /etc للقراءة فقط. ينجح حذف الملف في نظام قابل للكتابة، وتستخدم بعض scripts الخاصة بالاستنساخ هذه الطريقة، لكن الملف الفارغ هو الخيار الافتراضي الأكثر أماناً. يكتب cloud-init الكلمة uninitialized في الملف بدلاً من ذلك. هذه القيمة، مثل غياب الملف، تجعل الإقلاع التالي إقلاعاً أولاً، ولذلك تعمل الوحدات التي تحتوي على ConditionFirstBoot=yes خلاله. أما الملف الفارغ فلا يفعل ذلك.

لماذا حصل الخادمان المستنسخان على عنوان DHCP نفسه؟

لأن كليهما أرسل معرّف العميل نفسه. يستخدم systemd-networkd القيمة ClientIdentifier=duid افتراضياً مع DHCPv4، ويُبنى DUID الافتراضي من تجزئة /etc/machine-id، ولذلك تنتج machine IDs المتطابقة DUIDs افتراضية متطابقة. تتطابق معرّفات العميل الكاملة فقط عندما تتطابق IAIDs أيضاً؛ إذ ينشئ systemd IAID من اسم دائم يحصل عليه من udev، ويعود إلى عنوان MAC عندما لا يتوفر اسم متوقع. لا يضمن تطابق أسماء الواجهات الحالية وحده ذلك. عندما تتطابق المعرّفات الكاملة، يطابق خادم DHCP الطلبات وفق ذلك المعرّف، ويعاملها كعميل واحد، ويمنحها lease واحداً. امنح كل جهاز machine ID خاصاً به، ثم أعد تشغيل الجهازين. إذا استمر الخادم في عرض العنوان القديم، فامسح lease القديم من خادم DHCP نفسه.

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

#machine-id#systemd#cloning#snapshots#dhcp