إدارة ملفات الإعدادات Dotfiles ونقلها بين السيرفرات عبر Git وStow
إدارة ملفات الإعدادات Dotfiles ونقلها بين السيرفرات عبر GitHub تعني أن بيئة عملك، اختصارات الصدفة وإعدادات tmux وGit والمحرر، تصبح مستودعاً واحداً تستنسخه على أي سيرفر جديد فتعمل كما اعتدت خلال ثوانٍ. والاسم من النقطة في بداية أسمائها، مثل bashrc. وtmux.conf.، فهي مخفية افتراضياً. ومن يدير أكثر من سيرفرين يعرف المشكلة: اختصار ll موجود هنا ومفقود هناك، وإعدادات tmux على جهازه تختلف عن السيرفر. وفي هذا الدليل نبني مستودع إعدادات بالأداة GNU Stow، ونحمي الأسرار منه، ونجهز سيرفراً ثانياً منه ونقيس الزمن، ثم نواجه التعارض الذي يحدث حين يجد Stow ملفاً موجوداً، ونحله.
نمر بالفكرة، وتنظيم المستودع، والتجربة على سيرفرين، والتعارض وحله، والأسرار، ثم البدائل والسكربت الواحد.
الفكرة

~/dotfiles/ a git repo
bash/.bashrc one folder per tool ("package")
tmux/.tmux.conf
git/.config/git/config
stow -t ~ bash tmux git -> creates symlinks: ~/.bashrc -> dotfiles/bash/.bashrc ...
الملفات الحقيقية تعيش في مجلد واحد هو مستودع Git، ومكانها المعتاد في المجلد المنزلي يصبح رابطاً رمزياً يشير إليها. فتعديل bashrc. يعدل الملف في المستودع مباشرة، ويكفي git commit لحفظه. وStow أداة صغيرة تنشئ هذه الروابط تلقائياً: مجلد لكل أداة، وبنيته الداخلية تطابق مكان الملف في المجلد المنزلي.
تنظيم المستودع
== method: stow (a folder per tool, symlinks into HOME)
LINK: .bashrc => dotfiles/bash/.bashrc
LINK: .tmux.conf => dotfiles/tmux/.tmux.conf
LINK: .config/git/config => ../../dotfiles/git/.config/git/config
~/.bashrc -> dotfiles/bash/.bashrc
~/.tmux.conf -> dotfiles/tmux/.tmux.conf
committed files: .gitignore bash/.bashrc git/.config/git/config tmux/.tmux.conf

نقلنا ثلاثة ملفات إلى ثلاثة مجلدات، وشغلنا Stow مرة واحدة، فأنشأ الروابط الثلاثة، حتى للملف المتداخل داخل config. بمسار نسبي صحيح. ثم أودعنا المستودع. وملف .gitignore في المستودع يمنع الأسرار من الدخول، وسنعود إليه. وأساسيات الصدفة واختصاراتها في أساسيات الطرفية في لينكس.
سيرفر جديد في ثوانٍ
git clone git@github.com:you/dotfiles.git ~/dotfiles
cd ~/dotfiles && stow -t ~ bash tmux git
== machine B: clone + stow, time it
B ready in 0.086 s; aliases found in .bashrc: 2
على السيرفر الثاني، استنساخ المستودع وتشغيل Stow جهز البيئة كلها في أقل من عُشر ثانية، بالاختصارات نفسها. وعلى سيرفر حقيقي يضاف زمن الاتصال بـ GitHub، أي ثانية أو اثنتين. ولسيرفر تدخله كثيراً كمستخدم مشترك، اختر الأدوات التي تحتاجها فقط: tmux وgit دون إعدادات الصدفة الشخصية مثلاً.
التعارض وحله
== conflict: target already has a real .tmux.conf
WARNING! stowing tmux would cause conflicts:
* existing target is neither a link nor a directory: .tmux.conf
All operations aborted.
$ stow --adopt -t ~ tmux # move the existing file INTO the repo, then link it
$ git diff --stat # 1 file changed: the server's version is now in the repo
$ git checkout -- . # discard it to keep your repo version

أغلب السيرفرات فيها bashrc. أصلاً من التوزيعة. وStow يرفض الاستبدال ويلغي العملية كلها، وهذا سلوك آمن. والحل بالخيار adopt: ينقل الملف الموجود إلى المستودع ويضع الرابط مكانه، فيظهر الفرق في git diff، ثم تقرر: تحتفظ بنسخة السيرفر، أو تتجاهلها بالأمر git checkout فتعود نسختك. وهكذا لا يضيع أي ملف دون أن تراه.
الأسرار
# .gitignore
.env
*.key
# keep secrets in ~/.bashrc.local (not in the repo), sourced at the end of .bashrc:
[ -f ~/.bashrc.local ] && . ~/.bashrc.local
أخطر ما في مستودع الإعدادات تسريب رمز وصول أو كلمة مرور، خصوصاً إن كان المستودع عاماً. والقاعدة: لا أسرار في الملفات المشتركة أبداً، بل في ملف محلي لكل سيرفر يُقرأ في آخر bashrc. ولا يدخل المستودع. وافحص المستودع قبل نشره بأمر بحث عن كلمات مثل TOKEN وPASSWORD، كما في البحث المتقدم في لينكس.
البدائل

البديل الشائع مستودع Git مجرد في المجلد المنزلي نفسه، بأمر مستعار config يشير إليه، بلا روابط ولا أداة إضافية. وأدوات متخصصة مثل chezmoi تدعم القوالب، أي ملف واحد بقيم تختلف بين السيرفرات، وتشفير الأسرار. وStow الأبسط والأوضح للبداية. وأضف سكربت install.sh صغيراً في المستودع يثبت الأدوات ويشغل Stow، فيصبح تجهيز أي سيرفر أمراً واحداً.
سيرفرات الفريق
على سيرفر يدخله أكثر من شخص بحساب مشترك، لا تفرض إعداداتك الشخصية على الجميع. والنمط المفيد مستودعان: مستودع للفريق فيه الإعدادات المتفق عليها، مثل سجل أوامر طويل وأدوات tmux الأساسية، ويثبت على كل السيرفرات، ومستودعك الشخصي لحسابك أنت فقط. وكلاهما يُجهز بالطريقة نفسها.
أخطاء شائعة
أسرار في المستودع
ملف محلي لكل سيرفر خارج Git.
حذف الملف الموجود لتجاوز التعارض
استخدم adopt وراجع الفرق.
إعدادات شخصية على حساب مشترك
اختر الأدوات المحايدة فقط.
مستودع عام بلا مراجعة
ابحث عن الأسرار قبل كل نشر.
أسئلة يطرحها الناس
عام أم خاص على GitHub؟
خاص أسلم، والعام مفيد للمشاركة بشرط الخلو من الأسرار والمعلومات الداخلية.
هل تعمل الروابط إن حُذف المستودع؟
لا، تصبح روابط مكسورة، فاحتفظ بالمستودع في مكانه.
الخلاصة
جمعنا ملفات الإعدادات في مستودع Git بمجلد لكل أداة، فأنشأ Stow الروابط في المجلد المنزلي، وجهز سيرفراً ثانياً في أقل من عُشر ثانية، ورفض الاستبدال عند التعارض حتى حللناه بالخيار adopt ومراجعة الفرق، وبقيت الأسرار في ملف محلي خارج المستودع.


