SYSTEMD-IMDSD@.SERVICE(8)

الاسم
systemd-imdsd@.service، systemd-imdsd، systemd-imdsd.socket، systemd-imdsd-early-network.service - عميل IMDS السحابي (خدمة بيانات المثيل)

موجز

systemd-imdsd@.service

systemd-imdsd.socket

systemd-imdsd-early-network.service

/usr/lib/systemd/systemd-imdsd

الوصف

systemd-imdsd@.service هي خدمة نظام توفر وصولاً محلياً لوظيفة IMDS (خدمة بيانات المثيل؛ أو ما يعادلها)، كما تقدمها العديد من السحب العامة.

توفر الخدمة واجهة Varlink IPC عبر /run/systemd/io.systemd.InstanceMetadata للاستعلام عن حقول IMDS.

systemd-imdsd-early-network.service هي خدمة نظام تُنشئ ملف systemd.network(5) متوافقاً مع systemd-networkd.service(8) لتكوين شبكة الإقلاع المبكر للتمكن من الاتصال بنقطة نهاية IMDS.

قد تُستخدم أداة systemd-imds(1) للاستعلام عن المعلومات من هذه الخدمة.

خيارات سطر أوامر النواة

تُحدد نقطة نهاية IMDS عادةً آلياً عبر سجلات hwdb(7)، ولكن يمكن أيضاً تكوينها صراحةً عبر سطر أوامر النواة، عبر الخيارات التالية:

systemd.imds.network=
    يأخذ أحد الخيارات "off"، "locked"، "uocked". يتحكم في ما إذا كان ستُعد الشبكة للوصول إلى نقطة نهاية IMDS وكيفية ذلك. ما لم يُضبط على "off"، تُمكّن شبكة بدء التشغيل المبكر، مما يضمن إمكانية الوصول إلى نقطة نهاية IMDS. إذا ضُبط على "locked" (الوضع المبدئي)، يُعطل الوصول المباشر إلى نقطة نهاية IMDS بواسطة العمليات العادية غير المميزة عبر مسار "prohibit"، بحيث يجب أن يتم أي وصول من خلال systemd-imdsd@.service أو الأدوات المرتبطة به. إذا ضُبط على "unlocked"، فلن يُنشئ مسار "prohibit" هذا، ويمكن للعمليات العادية غير المميزة الاتصال بـ IMDS مباشرةً.

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

systemd.imds.vendor=
    سلسلة محارف قصيرة تُعرّف بائع السحابة.

    مثال:

        systemd.imds.vendor=foobarcloud

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

systemd.imds.token_url=
    إذا كان يجب الحصول على رمز حامل للتحدث مع خدمة IMDS، فهذا هو عنوان URL للحصول عليه منه.

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

systemd.imds.refresh_header_name=
    يأخذ اسم حقل رأس HTTP (باستثناء ":") الذي يُعلن حقل الرأس لتمرير قيمة TTL (بالثواني) إلى خادم HTTP عند الحصول على رمز. يُطبق فقط إذا كان systemd.imds.token_url= مُعيَّناً أيضاً.

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

systemd.imds.data_url=
    يأخذ عنوان URL الأساسي للحصول على بيانات IMDS منه (نقطة نهاية IMDS). تُحصل جميع حقول البيانات من أسفل هذا العنوان. لا ينبغي أن ينتهي هذا العنوان عادةً بـ "/".

    تُركب عناوين URL للبيانات من هذا العنوان الأساسي، ومفتاح IMDS، واللاحقة المُهيأة عبر systemd.imds.data_url_suffix= أدناه. يمكن تكوين مفاتيح IMDS المعروفة عبر خيارات systemd.imds.key=* أدناه.

    مثال:

        systemd.imds.data_url=http://169.254.169.254/metadata

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

systemd.imds.data_url_suffix=
    إذا حُدد، يُلحق هذا الحقل بنهاية عنوان URL للبيانات (بعد إلحاق مفتاح IMDS بعنوان URL الأساسي للبيانات)، انظر أعلاه.

    مثال:

        systemd.imds.data_url_suffix=?api-version=2025-04-07&format=text

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

systemd.imds.token_header_name=
    يأخذ اسم حقل رأس HTTP (باستثناء ":") الذي يُعلن حقل الرأس لتمرير رمز الحامل المُحصل عليه من عنوان URL للرمز (انظر أعلاه). يُطبق فقط إذا كان systemd.imds.token_url= مُعيَّناً أيضاً.

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

systemd.imds.extra_header=
    يأخذ تعبير رأس HTTP كاملاً (اسم الحقل وقيمته، مفصولين بنقطتين ":") لتمريره إلى خادم HTTP عند طلب البيانات. قد يُستخدم عدة مرات لتعيين رؤوس متعددة.

    مثال:

        systemd.imds.extra_header=Metadata:true

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

systemd.imds.address_ipv4=
    يُهيئ عنوان IPv4 الذي يُتصل به نقطة نهاية IMDS. يجب أن يكون هذا عادةً عنوان IP المُهيأ أيضًا عبر systemd.imds.data_url= (إذا استُخدم IPv4) ويُستخدم لإعداد توجيه IP.

    مثال:

        systemd.imds.address_ipv4=169.254.169.254

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

systemd.imds.address_ipv6=
    يُهيئ عنوان IPv6 الذي يُتصل به نقطة نهاية IMDS. يجب أن يكون هذا عادةً عنوان IP المُهيأ أيضًا عبر systemd.imds.data_url= (إذا استُخدم IPv6) ويُستخدم لإعداد توجيه IP.

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

systemd.imds.key.hostname=, systemd.imds.key.region=, systemd.imds.key.zone=, systemd.imds.key.ipv4_public=, systemd.imds.key.ipv6_public=, systemd.imds.key.ssh_key=, systemd.imds.key.userdata=, systemd.imds.key.userdata_base=, systemd.imds.key.userdata_base64=
    يُهيئ سلاسل محارف لتُضاف إلى عنوان URL لقاعدة البيانات (انظر أعلاه) للحصول على بيانات لحقول "معروفة" مختلفة. يجب أن تبدأ هذه السلاسل بمحرف "/". يجب أن تُرجع البيانات ذات الصلة بنص عادي.

    حالة خاصة هي المفاتيح الثلاثة "userdata": يجب استخدام الخيار systemd.imds.key.userdata_base= إذا كانت خدمة IMDS تعرف مفهوم حقول بيانات مستخدم متعددة، وبالتالي لا يزال معرّف الحقل بحاجة إلى الإضافة إلى عنوان URL لقاعدة بيانات المستخدم. يجب استخدام الخيار systemd.imds.key.userdata= إذا كان حقل بيانات مستخدم واحد فقط مدعومًا. يجب استخدام الخيار systemd.imds.key.userdata_base64= في نفس الحالة، ولكن فقط إذا كان حقل بيانات المستخدم مُعمّىً بـ Base64.

    مثال:

        systemd.imds.key.hostname=/instance/compute/osProfile/computerName

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

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

يدعم systemd-imdsd@.service منطق بيانات استيثاق الخدمة كما هو مُنفَّذ بواسطة ImportCredential=/LoadCredential=/SetCredential= (انظر systemd.exec(5) للتفاصيل). تُستخدم بيانات الاستيثاق التالية عند تمريرها:

imds.vendor, imds.vendor_token, imds.refresh_header_name, imds.data_url, imds.data_url_suffix, imds.token_header_name, imds.extra_header, imds.extra_header2, imds.extra_header3, imds.extra_header..., imds.address_ipv4, imds.address_ipv6, imds.key_hostname, imds.key_region, imds.key_zone, imds.key_ipv4_public, imds.key_ipv6_public, imds.key_ssh_key, imds.key_userdata, imds.key_userdata_base, imds.key_userdata_base64
    معاملات نقطة نهاية IMDS المختلفة. الدلالات قريبة جدًا من تلك القابلة للتهيئة عبر سطر أوامر النواة، انظر أعلاه للقائمة المطابقة.

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

انظر أيضًا

systemd(1), systemd-imds(1), systemd-imds-generator(8), systemd-networkd.service(8)

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

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

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