SYSTEMD-IMPORT-GENERATOR(8)

الاسم
مولد استيراد النظام - مولد لتنزيل صور الأقراص آليًا عند الإقلاع

موجز

/usr/lib/systemd/system-generators/systemd-import-generator

الوصف

يمكن استخدام systemd-import-generator لتنزيل صور الأقراص (ملفات مضغوطة أو صور أقراص قابلة للتوزيع) آليًا عبر systemd-importd.service(8) عند الإقلاع، استنادًا إلى معاملات سطر أوامر النواة أو عبر بيانات اعتماد النظام. هذا مفيد لنشر صورة systemd-confext(8) أو systemd-sysext(8) أو systemd-nspawn(1)/ systemd-vmspawn(1) أو systemd-portabled.service(8) آليًا عند الإقلاع. يوفر هذا وظائف مكافئة لـ importctl(1)، ولكن يمكن الوصول إليها عبر سطر أوامر النواة وبيانات اعتماد النظام.

ينفذ systemd-import-generator systemd.generator(7).

سطر أوامر النواة

يدرك systemd-import-generator معاملات kernel-command-line(7) التالية:

systemd.pull=
    يأخذ هذا الخيار ثلاثية مفصولة بنقطتين من سلسلة الخيارات واسم الصورة المحلية المستهدفة وعنوان URL البعيد. يمكن تحديد اسم الصورة المحلية المستهدفة كسلسلة فارغة، وفي هذه الحالة يُشتق الاسم من عنوان URL البعيد المحدد. يجب أن يستخدم عنوان URL البعيد مخططات "http://" أو "https://" أو "file://". سلسلة الخيارات نفسها هي قائمة خيارات مفصولة بفواصل:

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

        أُضيف في الإصدار 257.

    verify=
        يتحكم في ما إذا كان التنزيل سيُتحقق منه تشفيريًا قبل تثبيته في مكانه. يأخذ إحدى القيم "no" أو "checksum" أو "signature" (المبدئي إذا لم يُحدد). للتفاصيل، انظر --verify= من importctl(1).

        أُضيف في الإصدار 257.

    sysext, confext, machine, portable
        يتحكم في فئة الصورة المراد تنزيلها، وبالتالي الدليل المستهدف للصورة، اعتمادًا على هذا الاختيار يُحدد الدليل المستهدف /var/lib/extensions/ أو /var/lib/confexts/ أو /var/lib/machines/ أو /var/lib/portables/.

        تحديد واحد بالضبط من هذه الخيارات إلزامي.

        أُضيف في الإصدار 257.

    tar, raw
        يتحكم في نوع المورد المراد تنزيله، أي ملف مضغوط (قد يكون مضغوطًا) يحتاج إلى فك ضغطه في شجرة نظام ملفات، أو صورة قرص خام (قد تكون مضغوطة) (DDI).

        تحديد واحد بالضبط من هذه الخيارات إلزامي.

        أُضيف في الإصدار 257.

    blockdev
        إذا حُدد هذا الخيار، تُرفق الصورة التي تم تنزيلها بجهاز كتلة حلقي (عبر systemd-loop@.service) بعد الإكمال. يسمح هذا بالإقلاع من صور الأقراص التي تم تنزيلها. هذا مدعوم فقط لصور الأقراص "الخام".

        لاحظ عند استخدام هذا الخيار بهدف تثبيت صورة قرص تتوافق مع UAPI.3 مواصفات صورة القرص القابلة للاكتشاف[1] كنظام ملفات جذر، ومعالجة منطق اكتشاف أقسام GPT الآلي كما هو منفذ بواسطة systemd-gpt-auto-generator(8) لها، من الضروري تحديد "rootdisk" كاسم محلي للاستيراد. علاوة على ذلك، يجب تحديد "root=gpt-auto" صراحةً على سطر أوامر النواة. أيضًا، أضف بادئة "rd." لخيار سطر الأوامر "systemd.pull=" لضمان تنفيذه في قرص RAM المبدئي (initrd) بالفعل، انظر أيضًا أدناه.

        أُضيف في الإصدار 258.

    bootorigin
        إذا تم تحديد هذا الخيار، يمكن تحديد اسم ملف بسيط بدلاً من عنوان URL. إذا تم إقلاع النظام عبر الإقلاع الشبكي HTTP UEFI، يتم استبدال المكون الأخير من عنوان URL الأصلي للإقلاع الشبكي بهذا اسم الملف واستخدامه كمصدر للتنزيل. وبالتالي، يسمح هذا باشتقاق عناوين URL لصور الأقراص آليًا من عنوان URL الأصلي للإقلاع المستخدم لاستدعاء النواة أو محمل الإقلاع.

        إذا تم استخدام هذا الخيار ولم يتم إقلاع النظام فعليًا عبر الإقلاع الشبكي HTTP UEFI، يتم تخطي التنزيل بلطف. أو بعبارة أخرى، بدون تعديلات أخرى، من الممكن تجميع صورة initrd ستقلع من قرص محلي إذا كان متاحًا، أو من صورة قرص تم تنزيلها إذا تم استخدامها عبر الإقلاع الشبكي.

        أُضيف في الإصدار 258.

    runtime=
        يأخذ وسيطة منطقية. إذا تم تعيينها إلى true، يتم تنزيل الصورة أسفل التسلسل الهرمي /run/، وإذا تم تعيينها إلى false أسفل التسلسل الهرمي /var/lib/. إذا لم يتم تحديدها، تكون القيمة المبدئية true في قرص RAM الأولي (initrd) وfalse على النظام المضيف.

        أُضيف في الإصدار 258.

    أُضيف في الإصدار 257.

systemd.pull.success_action=, systemd.pull.failure_action=
    يتحكم في ما إذا كان سيتم تنفيذ إجراء مثل إعادة التشغيل، إيقاف التشغيل وما شابه ذلك بعد إكمال التنزيل بنجاح أو دون نجاح. راجع SuccessAction=/FailureAction= في systemd.unit(5) للحصول على تفاصيل حول الإجراءات المتاحة. إذا لم يتم تحديده، لا يتم اتخاذ أي إجراء، وسيستمر النظام في الإقلاع بشكل طبيعي.

    أُضيف في الإصدار 257.

يتم تفسير خيارات سطر أوامر النواة هذه بواسطة النظام المضيف فقط. إذا تمت بادئة هذه الخيارات بـ "rd." يتم تفسيرها بواسطة قرص RAM الأولي (initrd) بدلاً من ذلك.

بيانات الاستيثاق

يدعم systemd-import-generator منطق بيانات استيثاق النظام. يتم استخدام بيانات الاستيثاق التالية عند تمريرها:

import.pull
    يجب أن تكون بيانات الاستيثاق هذه ملفًا نصيًا، مع كل سطر يشير إلى عملية تنزيل واحدة. يجب أن يتبع كل سطر نفس تنسيق قيمة خيار سطر أوامر النواة systemd.pull= الموضح أعلاه.

    أُضيف في الإصدار 257.

أمثلة

مثال 1. تنزيل امتداد التكوين

    systemd.pull=raw,confext::https://example.com/myconfext.raw.gz

مع خيار سطر أوامر نواة مثل ما سبق، يتم تنزيل امتداد تكوين DDI آليًا عند الإقلاع من عنوان URL المحدد، والتحقق منه تشفيريًا، وفك ضغطه، وتثبيته.

مثال 2. تنزيل امتداد النظام (بدون تحقق)

    systemd.pull=tar,sysext,verify=no::https://example.com/mysysext.tar.gz

مع خيار سطر أوامر نواة مثل ما سبق، يتم تنزيل حزمة امتداد النظام آليًا عند الإقلاع من عنوان URL المحدد، وفك ضغطها، وتثبيتها — دون أي تحقق تشفيري. هذا مفيد لأغراض التطوير في الآلات الافتراضية والحاويات. تحذير: لا تنشر نظامًا مع تعطيل التحقق بهذه الطريقة!

مثال 3. تنزيل صورة قرص الجذر (خام) إلى الذاكرة، للإقلاع إليها

    rd.systemd.pull=raw,machine,verify=no,blockdev:image:https://example.com/image.raw.xz root=/dev/disk/by-loop-ref/image.raw-part2

يقوم هذا بتنزيل صورة القرص المحددة، وحفظها محليًا تحت اسم "image"، وإرفاقها بجهاز كتلة حلقة رجوع عند الإكمال. ثم يقلع من القسم الثاني في الصورة.

مثال 4. الإقلاع إلى صورة قرص (خام)، مع عنوان URL مشتق من الإقلاع الشبكي HTTP UEFI

    rd.systemd.pull=raw,machine,verify=no,blockdev,bootorigin:rootdisk:image.raw.xz root=gpt-auto

هذا مشابه للمثال السابق، لكن هذه المرة يُشتق رابط المصدر آليًا من رابط الإقلاع الشبكي HTTP الخاص بـ UEFI. على سبيل المثال، إذا تم إقلاع UKI من رابط "http://example.com/image.efi" فسيؤدي ذلك إلى تنزيل قرص جذر من "http://example.com/image.raw.xz". علاوة على ذلك، يستخدم هذا منطق systemd-gpt-auto-generator(8) لتركيب نظام الملفات الجذر من صورة القرص.

مثال 5. الإقلاع إلى صورة قرص (tar)، مع رابط مشتق من الإقلاع الشبكي HTTP الخاص بـ UEFI

    rd.systemd.pull=tar,machine,verify=no,bootorigin:root:image.tar.xz root=bind:/run/machines/root

هذا مشابه للمثال السابق، لكن بدلاً من صورة قرص خام (أي قائمة على جهاز كتلة) يُقلع النظام إلى حزمة مضغوطة (tarball) تُنزل من خادم UEFI الشبكي الأصلي.

انظر أيضًا

systemd(1), systemd-importd.service(8), kernel-command-line(7), systemd.system-credentials(7), importctl(1), systemd-loop@.service(8), systemd-gpt-auto-generator(8)

ملاحظات

1.  مواصفات صورة القرص القابلة للاكتشاف UAPI.3
    https://uapi-group.org/specifications/specs/discoverable_disk_image/

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.