yadm - الإنترنت في السحابة

برنامج:

اسم

yadm - مدير Dotfiles آخر

موجز

يادم أمر [الخيارات]

يادم أمر بوابة أو اسم مستعار [الخيارات]

يادم فيه [-f] [-w دليل]

يادم استنساخ URL [-f] [-w دليل]

يادم التكوين الاسم [قيمنا]

يادم التكوين [-e]

يادم قائمة [-a]

يادم تشفير

يادم فك تشفير [-l]

يادم ALT

يادم التجاعيد

الوصف

يادم هي أداة لإدارة مجموعة من الملفات عبر أجهزة كمبيوتر متعددة ، باستخدام ملف
مستودع Git المشترك. فضلاً عن ذلك، يادم يوفر ميزة لتحديد الإصدارات البديلة
من الملفات بناءً على نظام التشغيل أو اسم المضيف. أخيرا، يادم يوفر القدرة على
إدارة مجموعة فرعية من الملفات الآمنة ، والتي تم تشفيرها قبل تضمينها في ملف
مستودع.

أوامر

بوابة الأمر or بوابة مستعارة
أي أمر لا يتم معالجته داخليًا بواسطة يادم يتم تمريره إلى طائرة نفاثة(1). شخص سخيف
يتم استدعاء الأوامر أو الأسماء المستعارة باستخدام يادم المستودع المدار. العمل
سيكون دليل أوامر git هو الملف الذي تم تكوينه شجرة العمل (عادة $ الرئيسية).

تتم إدارة ملفات Dotfiles باستخدام المعيار طائرة نفاثة أوامر. تضيف, ارتكاب, دفع, سحب، الخ.

• التكوين لا يتم تمرير الأمر مباشرة من خلال. بدلاً من ذلك ، استخدم ملف gitconfig
الأمر (انظر أدناه).

ALT أنشئ روابط رمزية لأي ملفات مُدارة تطابق قواعد التسمية الموضحة في
قسم البدائل. عادة ما يكون من غير الضروري تشغيل هذا الأمر ، مثل يادم
يقوم تلقائيًا بمعالجة البدائل بشكل افتراضي. يمكن أن يكون هذا السلوك التلقائي
تعطيل عن طريق ضبط التكوين yadm.auto-alt إلى "خطأ".

استنساخ URL
استنساخ مستودع بعيد لتتبع الملفات النقطية. بعد محتويات جهاز التحكم عن بعد
تم جلب المستودع ، "دمج" الأصل / السيد حاول. إن كان هناك
هي الملفات المتضاربة الموجودة بالفعل في شجرة العمل، سيفشل هذا الدمج و
بدلا من "إعادة" الأصل / السيد سينجز. الأمر متروك للمستخدم لحل
هذه التعارضات ، ولكن إذا كان الإجراء المطلوب هو تضمين المحتويات في
يقوم المستودع بالكتابة فوق الملفات الموجودة ، ثم يتم تنفيذ "إعادة ضبط المصنع"
على ما يلي:

إعادة تعيين yadm - أصل صعب / رئيسي

يتم تخزين المستودع في $ HOME / .yadm / repo.git. بشكل افتراضي، $ الرئيسية سوف يستخدم
كما شجرة العمل، ولكن يمكن تجاوز هذا بامتداد -w الخيار. يادم يمكن أن يكون
اضطر إلى الكتابة فوق مستودع موجود من خلال توفير -f الخيار.

التكوين يدير هذا الأمر التكوينات لـ يادم. يعمل هذا الأمر بالطريقة التي يعمل بها بالضبط
بوابة التكوين(1) لا. راجع قسم التكوين للحصول على مزيد من التفاصيل.

فك تشفير
فك تشفير جميع الملفات المخزنة في ملفات $ HOME / .yadm / files.gpg. سيتم فك تشفير الملفات
نسبة إلى تكوين شجرة العمل (عادة $ الرئيسية). باستخدام -l الخيار سوف
قائمة الملفات المخزنة دون استخراجها.

تشفير
قم بتشفير جميع الملفات المطابقة للأنماط الموجودة في $ HOME / .yadm / تشفير. راجع
قسم التشفير لمزيد من التفاصيل.

gitconfig
قم بتمرير الخيارات إلى طائرة نفاثة التكوين يأمر. منذ يادم يستخدم بالفعل التكوين أمر
لإدارة التكوينات الخاصة به ، يتم توفير هذا الأمر كطريقة للتغيير
تكوينات المستودع الذي يديره يادم. قد تكون إحدى الحالات المفيدة هي
تكوين المستودع بحيث تظهر الملفات التي لم يتم تعقبها في أوامر الحالة. يادم
في البداية يقوم بتكوين مستودع التخزين الخاص به بحيث لا يتم عرض الملفات التي لم يتم تعقبها. اذا أنت
ترغب في استخدام سلوك git الافتراضي (لإظهار الملفات والأدلة التي لم يتم تعقبها) ، أنت
يمكن إزالة هذا التكوين.

yadm gitconfig - الحالة غير المحددة

مساعدة اطبع ملخصًا عن يادم أوامر.

الحرف الأول قم بتهيئة مستودع جديد فارغ لتتبع الملفات النقطية. يتم تخزين المستودع
in $ HOME / .yadm / repo.git. بشكل افتراضي، $ الرئيسية سيتم استخدامه على أنه شجرة العملولكن هذا
يمكن تجاوزها بامتداد -w الخيار. يادم يمكن إجبارها على الكتابة فوق موجود
من خلال توفير ملف -f الخيار.

قائمة اطبع قائمة بالملفات التي يديرها يادم. -a الخيار سيتسبب في جميع الملفات المدارة
أن تكون مدرجة. خلاف ذلك ، فإن القائمة سوف تشمل فقط الملفات من الحالي
دليل أو أدناه.

التجاعيد تحديث الأذونات كما هو موضح في قسم PERMISSIONS. من المعتاد
غير ضروري لتشغيل هذا الأمر ، مثل يادم يعالج الأذونات تلقائيًا عن طريق
تقصير. يمكن تعطيل هذا السلوك التلقائي عن طريق تعيين التكوين
yadm.auto-perms إلى "خطأ".

الإصدار
اطبع نسخة يادم.

CONFIGURATION

يادم يستخدم ملف التكوين المسمى $ HOME / .yadm / config. يستخدم هذا الملف نفس التنسيق
as بوابة التكوين(1). أيضًا ، يمكنك التحكم في محتويات ملف التكوين عبر ملف
يادم التكوين الأمر (الذي يعمل تمامًا مثل بوابة التكوين). على سبيل المثال ، لتعطيل
بدائل يمكنك تشغيل الأمر:

تكوين yadm yadm.auto-alt خطأ

فيما يلي القائمة الكاملة للتكوينات المدعومة:

yadm.auto-alt
قم بتعطيل الارتباط التلقائي الموضح في قسم ALTERNATES. إذا تم تعطيله ،
لا يزال بإمكانك الجري يادم ALT يدويًا لإنشاء الروابط البديلة. هذه الميزة
ممكّن افتراضيًا.

yadm.auto-perms
قم بتعطيل تغييرات الأذونات التلقائية الموضحة في قسم الأذونات. لو
معطل ، لا يزال بإمكانك الجري يادم التجاعيد يدويا لتحديث الأذونات. هذا
يتم تمكين الميزة افتراضيًا.

yadm.ssh-perms
تعطيل إذن التغييرات إلى $ HOME / .ssh / *. يتم تمكين هذه الميزة بواسطة
افتراضي.

yadm.gpg-perms
تعطيل إذن التغييرات إلى $ HOME / .gnupg / *. يتم تمكين هذه الميزة بواسطة
افتراضي.

البدائل

عند إدارة مجموعة من الملفات عبر أنظمة مختلفة ، قد يكون من المفيد أن يكون لديك ملف
طريقة تلقائية لاختيار نسخة بديلة من ملف لنظام تشغيل مختلف ،
المضيف أو المستخدم. يادم تنفذ ميزة ستنشئ تلقائيًا رابطًا رمزيًا
إلى الإصدار المناسب من الملف ، طالما أنك تتبع اصطلاح تسمية محددًا.
يادم يمكنه اكتشاف الملفات ذات الأسماء المنتهية بـ:

## or ## نظام التشغيل or ## OS.HOSTNAME or ## OS.HOSTNAME.USER

إذا كان هناك أي ملفات يديرها يادمالذي يتطابق مع اصطلاح التسمية هذا ،
سيتم إنشاء روابط رمزية للإصدار الأنسب. قد يكون هذا أفضل
يتضح من خلال المثال. افترض أن الملفات التالية تتم إدارتها بواسطة يادممستودع ´s:

- $ HOME / المسار / example.txt ##
- $ HOME / path / example.txt ## داروين
- $ HOME / path / example.txt ## Darwin.host1
- $ HOME / path / example.txt ## Darwin.host2
- $ HOME / path / example.txt ## Linux
- $ HOME / path / example.txt ## Linux.host1
- $ HOME / path / example.txt ## Linux.host2

إذا كان يعمل على Macbook باسم "host2" ، يادم سيُنشئ رابطًا رمزيًا يشبه
هذه:

$ HOME / المسار / example.txt -> $ HOME / مسار / example.txt ## Darwin.host2

ومع ذلك ، في جهاز Mackbook آخر باسم "host3" ، يادم سيخلق رابطًا رمزيًا يبدو
مثله:

$ HOME / المسار / example.txt -> $ HOME / path / example.txt ## داروين

نظرًا لأن اسم المضيف لا يتطابق مع أي من الملفات المُدارة ، فإن الإصدار الأكثر عمومية هو
اختيار.

إذا كان يعمل على خادم Linux يسمى "host4" ، فسيكون الرابط:

$ HOME / المسار / example.txt -> $ HOME / path / example.txt ## Linux

في حالة التشغيل على خادم Solaris ، يستخدم الارتباط الإصدار الافتراضي "##":

$ HOME / المسار / example.txt -> $ HOME / المسار / example.txt ##

إذا لم يكن هناك إصدار "##" ولا توجد ملفات تطابق OS / HOSTNAME / USER الحالي ، فلن يكون هناك رابط
سيتم إنشاؤه.

يتم تحديد نظام التشغيل عن طريق التشغيل uname -s، HOSTNAME عن طريق الجري اسم المضيف -sو USER عن طريق التشغيل
id -u -n. يادم سيقوم تلقائيًا بإنشاء هذه الروابط افتراضيًا. يمكن تعطيل هذا
يستخدم ال yadm.auto-alt إعدادات. حتى في حالة التعطيل ، يمكن إنشاء الروابط يدويًا بواسطة
تشغيل يادم ALT.

التشفير

قد يكون من المفيد إدارة الملفات السرية ، مثل مفاتيح SSH أو GPG ، عبر عدة ملفات
الأنظمة. ومع ذلك ، سيؤدي القيام بذلك إلى وضع بيانات النص العادي في مستودع Git ، والذي غالبًا
يتواجد على نظام عام. يادم تنفذ ميزة يمكن أن تجعل من السهل تشفيرها
وفك تشفير مجموعة من الملفات بحيث يمكن الاحتفاظ بالنسخة المشفرة في Git
مخزن. ستعمل هذه الميزة فقط إذا كان ملف المنافع العامة العالمية(1) الأمر متاح.

لاستخدام هذه الميزة ، يجب إنشاء قائمة بالأنماط وحفظها بتنسيق $ HOME / .yadm / تشفير.
يجب أن تكون قائمة الأنماط هذه مرتبطة بملف شجرة العمل (عادة $ الرئيسية). إلى
مثال:

.ssh / *. key
.gnupg / *. gpg

• يادم تشفير سيجد الأمر جميع الملفات المطابقة للأنماط ، ويطلب من ملف
كلمة المرور. بمجرد تأكيد كلمة المرور ، سيتم تشفير الملفات المطابقة وحفظها بتنسيق
$ HOME / .yadm / files.gpg. يجب إضافة الأنماط و files.gpg إلى ملف يادم مستودع
حتى تكون متاحة عبر أنظمة متعددة.

لفك تشفير هذه الملفات لاحقًا ، أو عند تشغيل نظام آخر يادم فك تشفير وتقديم
كلمة المرور الصحيحة. بعد فك تشفير الملفات ، يتم تحديث الأذونات تلقائيًا باسم
الموضحة في قسم الأذونات.

ملحوظة: يوصى باستخدام مستودع خاص عند حفظ الملفات السرية ،
على الرغم من أنها مشفرة.

PERMISSIONS

عندما يتم سحب الملفات من مستودع Git ، فإن أذوناتها الأولية تعتمد
بناءً على مهمة المستخدم. يمكن أن يؤدي هذا إلى ملفات سرية ذات أذونات متساهلة.

لمنع هذا، يادم سيقوم تلقائيًا بتحديث أذونات الملفات السرية.
ستتم إزالة أذونات "المجموعة" و "الآخرين" من الملفات التالية:

- $ HOME / .yadm / files.gpg

- جميع الملفات التي تطابق الأنماط بتنسيق $ HOME / .yadm / تشفير

- دليل وملفات SSH ، .ssh / *

- دليل وملفات GPG ، .gnupg / *

يادم سيتم تحديث الأذونات تلقائيًا بشكل افتراضي. يمكن تعطيل هذا باستخدام
yadm.auto-perms إعدادات. حتى في حالة التعطيل ، يمكن تحديث الأذونات يدويًا بواسطة
تشغيل يادم التجاعيد. يمكن تعطيل معالجة دليل SSH باستخدام ملف yadm.ssh-perms
ترتيب.

استخدم yadm عبر الإنترنت باستخدام خدمات onworks.net