التراجع والاستئناف
كيف يسجّل planfs كل تغيير، وكيف يستأنف التنفيذ المنقطع، وكيف يعيد كل شيء كما كان.
السجل#
كل تغيير يُكتب في السجل فور وقوعه، ويُفرض حفظه على القرص قبل الانتقال إلى التغيير التالي. السجل الافتراضي هو
.planfs/journal.jsonl في المجلد الذي تعمل منه، ويمكن اختيار غيره بـ --journal أو بمتغير البيئة PLANFS_JOURNAL.
وإذا انتهى اسم الملف بـ .tsv كُتب جدولًا بأعمدة: الوقت، والعملية، ومن، وإلى، والسبب، والخطة.
وفي الخطط الضخمة على القرص المحلي يستغرق فرض الحفظ بعد كل تغيير معظم الوقت؛ فإن أردت السرعة فالخيار
--journal-sync batch يحفظ كل نصف ثانية، ويبقى الاستئناف سليمًا لأن planfs يعرف التغييرات غير المسجّلة من حال الملفات.
planfs log # الخطط وعدد تغييراتها
planfs log --plan rename # تغييرات خطة واحدة
الاستئناف#
إذا انقطع التنفيذ (انقطاع الشبكة، أو Ctrl-C، أو انطفاء الجهاز) فأعد الأمر نفسه:
planfs apply rename.tsv
تظهر الأسطر المنفّذة بعلامة = «نُفّذ من قبل»، ويُكمل planfs الباقي. وإن وقع الانقطاع بين تنفيذ تغيير وكتابة سطره في
السجل، عرف planfs ذلك من حال الملفات (المصدر غائب والهدف حاضر) فسجّله ولم يكرره.
إن تغيّرت الخطة
إن عدّلت ملف الخطة بعد تنفيذ جزء منه، رفض planfs الاستئناف لأن بصمة الخطة تغيّرت؛ احفظ النسخة الجديدة باسم آخر،
أو أكّد بـ --force.
التراجع#
planfs undo rename --dry-run # المعاينة فقط
planfs undo rename # المعاينة ثم السؤال ثم التنفيذ
planfs undo rename -o undo.tsv # كتابة الخطة المعاكسة في ملف لتعديلها
يبني planfs الخطة المعاكسة من السجل، من آخر تغيير إلى أوله: يعيد كل نقل، ويُخرج المحذوف من مجلد العزل إلى مكانه، ويعيد المجلدات التي فرغت، ويزيل المجلدات التي أنشأتها الخطة إن بقيت فارغة. ويعرف المجلد الهدف من السجل نفسه.
الحذف النهائي
ما حُذف بـ --hard-delete لا يعود؛ ويذكره planfs بالاسم قبل التراجع.
ماذا لو تغيّر شيء بين المعاينة والتنفيذ؟#
يعيد planfs المعاينة تحت القفل قبل أول تغيير، فإن اختلفت عما وافقت عليه توقّف دون أن يمس شيئًا. وفي أثناء التنفيذ لا يكتب فوق ملف موجود أبدًا، حتى لو ظهر الملف بعد المعاينة بلحظة.