الاسم¶
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،
وإلا
فيُعاد رمز
فشل غير
صفري.
ترجمة¶
تُرجمت
هذه الصفحة
من الدليل
بواسطة
زايد
السعيدي
<zayed.alsaidi@gmail.com>
هذه
الترجمة هي
وثيقة
مجانية؛
راجع
رخصة
جنو العامة
الإصدار 3
أو ما بعده
للاطلاع
على شروط
حقوق النشر.
لا توجد أي
ضمانات.
إذا وجدت
أي أخطاء في
ترجمة صفحة
الدليل
هذه، يرجى
إرسال بريد
إلكتروني
إلى قائمة
بريد
المترجمين:
kde-l10n-ar@kde.org.
