الأحجام الدائمة

أرفِق قرصًا دائمًا بخدمة كي تبقى البيانات المكتوبة في مسار التحميل بعد إعادة التشغيل وإعادة النشر.

الحجم الدائم هو قرص دائم مُرفَق بخدمة عند مسار تحميل. الملفات التي يكتبها تطبيقك هناك تبقى بعد إعادة التشغيل وإعادة النشر وإعادة الجدولة — بخلاف بقية نظام ملفات الخدمة الذي يُعاد ضبطه مع كل نشر.

إرفاق حجم#

  1. 1

    افتح الإعدادات

    في صفحة الخدمة، افتح تبويب الإعدادات وابحث عن الأحجام.

  2. 2

    حجم جديد

    انقر «حجم جديد»، أدخِل مسار تحميل مطلقًا (مثل ‎/data) واسمًا اختياريًا، ثم احفظ.

  3. 3

    أعِد النشر للتطبيق

    يصبح التحميل ساري المفعول في النشر التالي — انقر «نشر» عندما تكون جاهزًا.

عبر CLI#

Shell
gheima volumes add my-app /data --name uploads
gheima volumes list my-app
أرفِق واعرض أحجام خدمة ما (بالمعرّف أو الاسم أو الـ slug).

عبر API#

Shell
curl -X POST https://gheima.ma/api/v1/services/{id}/volumes \
  -H "Authorization: Bearer $GHEIMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"uploads","mountPath":"/data"}'
يعيد معرّف الحجم الجديد؛ استخدم DELETE على /volumes/{volumeId} لفصله.

فصل حجم#

الفصل يزيل التحميل في النشر التالي. القرص الأساسي يُحتفظ به ولا يُحذف، حتى لا يؤدي فصل عرضي إلى فقدان البيانات.

الأحجام محلية للعقدة: تُثبّت المنصة الخدمة التي لديها أحجام على العقدة التي جُدولت عليها، كي تتبعها أقراصها عبر عمليات النشر. لا تُشارَك بين الخدمات ولا تُنسَخ احتياطيًا تلقائيًا — انسخ ما يهمّك إلى تخزين الكائنات إذا احتجت ديمومة تتجاوز العقدة.

الحدود والقواعد#

  • حجم واحد فقط لكل مسار تحميل ولكل خدمة — إرفاق حجم ثانٍ في المسار نفسه يُرفَض.
  • يجب أن يكون مسار التحميل مطلقًا ومُطبَّعًا (بلا مقاطع «.» أو «..»)، ولا يجوز أن يستهدف مجلد نظام محجوزًا (‎/etc أو ‎/bin أو ‎/usr وما شابه).
  • مسارات التحميل محدودة بـ 512 حرفًا.
  • الحد الأقصى لعدد الأحجام في حسابك تحدده خطتك.

لخدمتك تخزين دائم لكل عقدة، للتحميلات أو الذاكرة المؤقتة أو أي بيانات يجب أن تبقى بعد النشر.