SYSTEMD-IMDS(1)

الاسم
systemd-imds, systemd-imds-import.service - أداة IMDS السحابية (خدمة بيانات تعريف المثيل)

موجز

systemd-imds-import.service

systemd-imds [خيارات...] [مفتاح]

الوصف

systemd-imds هي أداة لجلب البيانات من خدمة بيانات تعريف المثيل (IMDS)، كما هي متوفرة في العديد من بيئات السحابة. وهي عميل لـ systemd-imdsd@.service(8)، وتوفر الوصول إلى بيانات IMDS من بيئات الصدفة.

يمكن للأداة العمل في واحدة من خمسة أنماط:

    • دون وسائط موضعية (وبدون المفتاح --well-known=) تُعرض بيانات خدمة IMDS العامة وبعض الحقول المعروفة بشكل مناسب للبشر.

    • مع وسيط موضعي (ودون --well-known=) تُجلب بيانات IMDS المشار إليها بالمفتاح المُحدد وتُكتب إلى المخرج القياسي، بشكل غير معالج. مفاتيح IMDS هي جزء عنوان URL لجلب IMDS الذي يُلحق بعنوان URL الأساسي. يجب أن تبدأ مفاتيح IMDS بشرطة مائلة ("/"). لاحظ أن مفاتيح IMDS عادة ما تكون خاصة بالتطبيق.

    • مع تحديد الخيار --well-known= (انظر أدناه)، يُكتب الحقل المعروف المُشار إليه إلى المخرج القياسي، بشكل غير معالج. يُجرد مفهوم الحقول المعروفة اختلافات تطبيقات IMDS إلى مستوى ما، كاشفاً واجهة موحدة لحقول IMDS التي توجد عادة في العديد من التطبيقات المختلفة، ولكن تحت مفاتيح خاصة بالتطبيق.

    • مع تحديد الخيار --userdata (انظر أدناه) تُكتب "بيانات المستخدم" المقدمة عبر IMDS إلى المخرج القياسي. في جوهر الأمر هذا مشابه لـ --well-known=userdata-base أو --well-known=userdata أو --well-known=userdata-base64. يُجرب كل من الثلاثة بدوره (بهذا الترتيب)، ويُعاد أول متاح. بالنسبة لـ --well-known=userdata-base يُطلب عنصر "systemd-userdata" لبيانات المستخدم. بالنسبة لـ --well-known=userdata-base64 تُفك شفرة البيانات المُعادة آلياً من Base64.

    • مع تحديد الخيار --import، تُستورد حقول معروفة وبيانات مستخدم متنوعة إلى مخزن بيانات الاعتماد المحلي، حيث تُستخدم لتكوين النظام وتحديد معاملاته. للتفاصيل انظر أدناه.

الخيارات والأوامر

--well-known=, -K
    يأخذ واحداً من "hostname" أو "region" أو "zone" أو "ipv4-public" أو "ipv6-public" أو "ssh-key" أو "userdata" أو "userdata-base" أو "userdata-base64". يجلب حقلاً "معروفاً" محدداً من IMDS. العديد من هذه الحقول مدعومة عادة من قبل تطبيقات IMDS المختلفة، لكن بعض الحقول عادة غير مدعومة. لاحظ أنه إذا استُخدم --well-known=userdata-base فيجب تحديد مفتاح فرعي إضافي كوسيط موضعي، والذي يرمز لعنصر بيانات المستخدم المحدد المطلوب جلبه.

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

--refresh=
    يأخذ وقتاً بالثواني كوسيط، ويشير إلى "حداثة" البيانات المطلوبة، في حال استخدام بيانات مخبأة.

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

--cache=
    يأخذ قيمة منطقية. إذا ضُبطت على false يُعطل التخزين المؤقت المحلي لـ IMDS، وتُجلب البيانات دائماً حديثة من نقطة نهاية IMDS.

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

--userdata, -u
    يجلب بيانات مستخدم IMDS لهذا المثيل، إن كانت متوفرة. انظر أعلاه للتفاصيل.

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

--import
    يجلب بيانات IMDS ويكتب الحقول ذات الصلة كبيانات اعتماد إلى /run/credstore/. يغطي هذا حالياً:

        • إذا كانت بيانات مستخدم IMDS كائن JSON صالحاً يحتوي على حقل systemd.credentials (بقيمة مصفوفة JSON) فإنها تُعالج، مستوردة بيانات اعتماد عشوائية مدرجة في المصفوفة. يجب أن يحتوي كل عنصر مصفوفة على حقل name يشير إلى اسم بيانات الاعتماد. قد يحتوي على حقل واحد text أو data أو encrypted، يحتوي على بيانات الاعتماد. إذا استُخدم text فيجب أن تكون القيمة سلسلة محارف حرفية لقيمة بيانات الاعتماد. إذا استُخدم data فقد تكون القيمة بيانات ثنائية عشوائية مُرمزة في سلسلة Base64. إذا استُخدم encrypted فيجب أن تكون القيمة بيانات اعتماد معمّاة مُرمزة بـ Base64. انظر systemd.system-credentials(7) للحصول على معلومات حول بيانات الاعتماد التي قد تُستورد بهذه الطريقة.

        • إذا كان الحقل المعروف ssh-key متوفراً، فستُستورد قيمته في بيانات الاعتماد ssh.authorized_keys.root.

        • إذا كان الحقل المعروف hostname متوفراً، فستُستورد قيمته في بيانات الاعتماد firstboot.hostname.

    يُستدعى هذا الأمر بواسطة systemd-imds-import.service الذي يُشغل عند الإقلاع.

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

-h، --help
    اطبع نص مساعدة قصير واخرج.

--version
    اطبع سلسلة إصدار قصيرة واخرج.

حالة الخروج

عند النجاح، يُعاد الرقم 0، وإلا فيُعاد رمز فشل غير صفري.

انظر أيضًا

systemd(1), systemd-imdsd@.service(8), systemd-imds-generator(8), systemd.system-credentials(7)

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

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

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