دليل
مقتطفات Cloud-init
تخزّن هذه الصفحة ملفات YAML لـ cloud-init تُرفَع إلى تخزين المقتطفات في Proxmox. كُتبت للمشغّل الذي يرفق وكيل الضيف أو سكربت الإقلاع الأول مع حزمة KVM.
القائمة: Addons → Proxmox Suite → Resource → Templates Center → Cloud-init Snippets

الغرض
المقدمة: Manage cloud-init YAML snippets uploaded to Proxmox snippet storage and applied via cicustom at provision time.
يضع التفعيل المقتطفات المدمجة من مجلد الإضافة resources/، بما في ذلك مقتطف وكيل الضيف QEMU. يشير إلى هنا حقل Cloud-init snippet في الحزمة (الوضع Advanced، تبويب System في KVM). يمكن لقوالب KVM أن تحمل أيضاً Cloud-init script الخاص بها.
القائمة
+ Create. الأعمدة: Name (مع شارة System على المدمجة)، Filename، Role (vendor أو user أو meta)، Active (Yes / No)، Edit. عند الفراغ: No snippets yet. Create one or keep the built-in QEMU Guest Agent snippet.
لا يوجد حذف من القائمة، ولا إجراء جماعي، ولا مفتاح في الصف. يمكن للخادم رفض الطلب بالرسالة System snippets cannot be deleted.، وهذه الشاشة لا تعرض الحذف.
إضافة / تعديل
المقدمة: Edit YAML uploaded to Proxmox snippet storage and linked via cicustom.
| الحقل | النوع | ماذا يفعل |
|---|---|---|
| Name | نص، مطلوب | التسمية في قوائم الحزم. عند الفراغ: Name is required. |
| Filename | نص، مطلوب، النص النائب my-snippet.yaml |
اسم الملف بلا مسار. يجب أن يطابق الحروف والأرقام و. و_ و-، وأن ينتهي بـ .yaml أو .yml. وإلا: Filename must end with .yaml or .yml and use safe characters. للقراءة فقط في مقتطف النظام. لا يُفحص التفرّد عند الحفظ. |
| Role | قائمة | vendor أو user أو meta. يقابل مفاتيح cicustom في Proxmox. الصفوف الجديدة تأخذ vendor افتراضياً. الحقل معطّل في مقتطف النظام، ويُرسَل الدور الحالي مخفياً. القيم غير المعروفة تصبح vendor. |
| Snippet content | منطقة نص، مطلوبة | ملف YAML كامل بصيغة #cloud-config، يُرفَع عند تزويد الحزمة. عند الفراغ: Snippet content is required. |
| Active | مفتاح، الافتراضي مفعّل | تبقى المقتطفات غير النشطة في الفهرس، ولا تُعرَض للحزم الجديدة. |
Cancel / Save. يبقى مقتطف النظام موسوماً بأنه نظام بعد الحفظ.
مثال
+ Create، الاسم ops-user، اسم الملف ops-user.yaml، الدور user، والمحتوى كتلة users ضمن #cloud-config، وActive مفعّل، ثم Save. في حزمة KVM، الوضع Advanced، تبويب System، اضبط Cloud-init snippet على ops-user.
الخطوة التالية
اختر المقتطف في VM Plan.