yadm - آنلاین در ابر

برنامه:

نام

yadm - یک مدیر دیگر Dotfiles

خلاصه

یادم فرمان [گزینه های]

یادم git-command-or-alias [گزینه های]

یادم شروع [-f] [-w فهرست راهنما]

یادم کلون کردن آدرس [-f] [-w فهرست راهنما]

یادم پیکربندی نام [ارزش]

یادم پیکربندی [-e]

یادم فهرست [-a]

یادم رمزگذاری

یادم رمزگشایی [-l]

یادم ALT

یادم پرم

شرح

یادم ابزاری برای مدیریت مجموعه ای از فایل ها در چندین رایانه با استفاده از a
مخزن Git به اشتراک گذاشته شده است. علاوه بر این، یادم یک ویژگی برای انتخاب نسخه های جایگزین فراهم می کند
فایل ها بر اساس سیستم عامل یا نام میزبان. در نهایت، یادم توانایی را فراهم می کند
زیرمجموعه ای از فایل های امن را مدیریت کنید، که قبل از گنجاندن در آن رمزگذاری می شوند
مخزن

دستورات

git-command or git-نام مستعار
هر دستوری که به صورت داخلی انجام نشده باشد یادم از طریق به دستگاه گوارش(1). Git
دستورات یا نام مستعار با فراخوانی می شوند یادم مخزن مدیریت شده کار
دایرکتوری برای دستورات git پیکربندی خواهد شد درخت کار (معمولا $ HOME).

Dotfiles با استفاده از استاندارد مدیریت می شود دستگاه گوارش دستورات؛ اضافه کردن, مرتکب شدن, فشار, کشیدن، و غیره

La پیکربندی دستور مستقیماً ارسال نمی شود. در عوض از gitconfig
فرمان (به زیر مراجعه کنید).

ALT پیوندهای نمادین برای هر فایل مدیریت شده ای ایجاد کنید که با قوانین نامگذاری توصیف شده مطابقت دارد
بخش ALTERNATES معمولاً اجرای این دستور غیر ضروری است یادم
به طور خودکار جایگزین ها را به طور پیش فرض پردازش می کند. این رفتار خودکار می تواند باشد
با تنظیم پیکربندی غیرفعال می شود yadm.auto-alt به "کاذب".

کلون کردن آدرس
یک مخزن از راه دور برای ردیابی dotfiles شبیه سازی کنید. بعد از محتویات ریموت
مخزن واکشی شده است، یک "ادغام" از مبدا/استاد تلاش می شود. اگر آنجا
فایل های متناقضی از قبل در موجود هستند درخت کار، این ادغام با شکست مواجه خواهد شد و
در عوض "تنظیم مجدد" از مبدا/استاد انجام خواهد شد. حل آن به عهده کاربر است
این تضادها است، اما اگر عمل مورد نظر این باشد که محتویات در آن باشد
مخزن فایل‌های موجود را بازنویسی می‌کند، سپس یک "هارد ریست" باید انجام شود
که:

تنظیم مجدد Yadm --Hard Original/Master

مخزن در ذخیره می شود $HOME/.yadm/repo.git. به صورت پیش فرض، $ HOME استفاده خواهد شد
عنوان درخت کار، اما این را می توان با رد کرد -w گزینه. یادم می تواند
مجبور به بازنویسی یک مخزن موجود با ارائه آن شد -f گزینه.

پیکربندی این دستور تنظیمات مربوط به آن را مدیریت می کند یادم. این دستور دقیقاً به روش آنها کار می کند
گیت(1) انجام می دهد. برای جزئیات بیشتر به بخش CONFIGURATION مراجعه کنید.

رمزگشایی
رمزگشایی تمام فایل های ذخیره شده در $HOME/.yadm/files.gpg. فایل های رمزگشایی خواهند شد
نسبت به پیکربندی شده درخت کار (معمولا $ HOME). با استفاده از -l گزینه خواهد شد
فایل های ذخیره شده را بدون استخراج لیست کنید.

رمزگذاری
تمام فایل های مطابق با الگوهای موجود در آن را رمزگذاری کنید $HOME/.yadm/encrypt. مشاهده
بخش ENCRYPTION برای جزئیات بیشتر.

gitconfig
گزینه ها را به دستگاه گوارش پیکربندی فرمان از آنجا که یادم در حال حاضر استفاده می کند پیکربندی فرمان
برای مدیریت تنظیمات خود، این دستور به عنوان راهی برای تغییر ارائه شده است
تنظیمات مخزن مدیریت شده توسط یادم. یک مورد مفید ممکن است به
مخزن را پیکربندی کنید تا فایل های ردیابی نشده در دستورات وضعیت نشان داده شوند. یادم
در ابتدا مخزن خود را طوری پیکربندی می کند که فایل های ردیابی نشده نمایش داده نشوند. اگر شما
مایلید از رفتار git پیش فرض (برای نمایش فایل ها و دایرکتوری های ردیابی نشده) استفاده کنید
می تواند این تنظیمات را حذف کند.

yadm gitconfig --unset status.showUntrackedFiles

کمک چاپ خلاصه ای از یادم دستورات

init انجام یک مخزن جدید و خالی برای ردیابی dotfiles راه اندازی کنید. مخزن ذخیره می شود
in $HOME/.yadm/repo.git. به صورت پیش فرض، $ HOME به عنوان استفاده خواهد شد درخت کار، اما این
را می توان با -w گزینه. یادم را می توان مجبور به بازنویسی یک موجود کرد
مخزن با ارائه -f گزینه.

فهرست چاپ لیستی از فایل های مدیریت شده توسط یادم. -a گزینه تمام فایل های مدیریت شده را ایجاد می کند
فهرست شود. در غیر این صورت، لیست فقط شامل فایل های فعلی خواهد بود
دایرکتوری یا زیر

پرم مجوزها را همانطور که در بخش PERMISSION توضیح داده شده است به روز کنید. معمولا هست
غیر ضروری برای اجرای این دستور، به عنوان یادم به طور خودکار مجوزها را پردازش می کند
پیش فرض این رفتار خودکار را می توان با تنظیم پیکربندی غیرفعال کرد
yadm.auto-perms به "کاذب".

نسخه
چاپ نسخه از یادم.

پیکربندی

یادم از یک فایل پیکربندی به نام استفاده می کند $HOME/.yadm/config. این فایل از همان فرمت استفاده می کند
as گیت(1). همچنین می توانید محتویات فایل پیکربندی را از طریق
یادم پیکربندی دستور (که دقیقاً مانند آن کار می کند گیت). مثلا غیر فعال کردن
جایگزین می توانید دستور را اجرا کنید:

پیکربندی yadm yadm.auto-alt false

در زیر لیست کاملی از تنظیمات پشتیبانی شده است:

yadm.auto-alt
پیوند خودکار توضیح داده شده در بخش جایگزین ها را غیرفعال کنید. در صورت غیرفعال شدن،
هنوز ممکن است بدوی یادم ALT به صورت دستی برای ایجاد پیوندهای جایگزین. این ویژگی است
به طور پیش فرض فعال است

yadm.auto-perms
تغییرات خودکار اجازه شرح داده شده در بخش PERMISSION را غیرفعال کنید. اگر
غیرفعال است، همچنان ممکن است اجرا کنید یادم پرم به صورت دستی برای به روز رسانی مجوزها. این
ویژگی به طور پیش فرض فعال است.

yadm.ssh-perms
غیرفعال کردن تغییرات مجوز به $HOME/.ssh/*. این ویژگی توسط
به طور پیش فرض

yadm.gpg-perms
غیرفعال کردن تغییرات مجوز به $HOME/.gnupg/*. این ویژگی توسط
به طور پیش فرض

جایگزین

هنگام مدیریت مجموعه ای از فایل ها در سیستم های مختلف، داشتن یک فایل می تواند مفید باشد
روش خودکار انتخاب یک نسخه جایگزین از یک فایل برای یک سیستم عملیاتی متفاوت،
میزبان یا کاربر یادم یک ویژگی را پیاده سازی می کند که به طور خودکار یک پیوند نمادین ایجاد می کند
به نسخه مناسب یک فایل، تا زمانی که از یک قرارداد نامگذاری خاص پیروی کنید.
یادم می تواند فایل هایی را با نام های ختم شده به:

## or ##سیستم عامل or ##OS.HOSTNAME or ##OS.HOSTNAME.USER

اگر فایلی وجود دارد که توسط آن مدیریت می شود یادممخزن که با این قرارداد نامگذاری مطابقت دارد،
پیوندهای نمادین برای مناسب ترین نسخه ایجاد خواهد شد. این ممکن است بهترین باشد
با مثال نشان داده شده است. فرض کنید فایل های زیر توسط مدیریت می شوند یادممخزن:

- $HOME/path/example.txt##
- $HOME/path/example.txt##Darwin
- $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/path/example.txt -> $HOME/path/example.txt##Darwin.host2

با این حال، در مک بوک دیگری به نام "host3"، یادم یک پیوند نمادین ایجاد می کند که به نظر می رسد
مثل این:

$HOME/path/example.txt -> $HOME/path/example.txt##Darwin

از آنجایی که نام میزبان با هیچ یک از فایل های مدیریت شده مطابقت ندارد، نسخه عمومی تر است
انتخاب شده

اگر روی سرور لینوکس به نام "host4" اجرا شود، پیوند به صورت زیر خواهد بود:

$HOME/path/example.txt -> $HOME/path/example.txt##Linux

اگر روی سرور Solaris اجرا می شود، پیوند از نسخه پیش فرض "##" استفاده می کند:

$HOME/path/example.txt -> $HOME/path/example.txt##

اگر نسخه "##" وجود ندارد و هیچ فایلی با OS/HOSTNAME/USER فعلی مطابقت ندارد، پیوندی وجود ندارد
ایجاد خواهد شد.

سیستم عامل با اجرا تعیین می شود اسم شما -s, HOSTNAME با اجرا کردن نام میزبان -sو USER با اجرا کردن
id -u -n. یادم به طور خودکار این لینک ها را به صورت پیش فرض ایجاد می کند. این را می توان غیرفعال کرد
با استفاده از yadm.auto-alt پیکربندی حتی اگر غیرفعال باشد، پیوندها می توانند به صورت دستی توسط
در حال اجرا یادم ALT.

ثبت نام

مدیریت فایل‌های محرمانه مانند کلیدهای SSH یا GPG در چندین فایل می‌تواند مفید باشد
سیستم های. با این حال، انجام این کار داده های متنی ساده را در یک مخزن Git قرار می دهد، که اغلب
در یک سیستم عمومی ساکن است. یادم قابلیتی را پیاده سازی می کند که می تواند رمزگذاری آن را آسان کند
و مجموعه ای از فایل ها را رمزگشایی کنید تا نسخه رمزگذاری شده در Git نگهداری شود
مخزن این ویژگی تنها در صورتی کار خواهد کرد که gpg(1) فرمان در دسترس است.

برای استفاده از این ویژگی باید لیستی از الگوها ایجاد و به عنوان ذخیره شود $HOME/.yadm/encrypt.
این لیست از الگوها باید نسبت به پیکربندی شده باشد درخت کار (معمولا $ HOME) برای
مثال:

کلید .ssh/*
gnupg/*.gpg

La یادم رمزگذاری دستور تمام فایل های مطابق با الگوها را پیدا می کند و a را از شما می خواهد
کلمه عبور. پس از تأیید رمز عبور، فایل های مطابق رمزگذاری شده و به عنوان ذخیره می شوند
$HOME/.yadm/files.gpg. الگوها و files.gpg باید به آن اضافه شوند یادم مخزن
بنابراین آنها در چندین سیستم در دسترس هستند.

برای رمزگشایی این فایل ها بعداً یا در سیستم دیگری اجرا کنید یادم رمزگشایی و فراهم می کند
رمز عبور صحیح پس از رمزگشایی فایل‌ها، مجوزها به‌طور خودکار به‌روزرسانی می‌شوند
در بخش PERMISSION ها توضیح داده شده است.

توجه داشته باشید: توصیه می شود هنگام نگهداری فایل های محرمانه از یک مخزن خصوصی استفاده کنید.
حتی اگر رمزگذاری شده باشند.

مجوزها

وقتی فایل‌ها از یک مخزن Git بررسی می‌شوند، مجوزهای اولیه آن‌ها وابسته است
بر اساس umask کاربر. این می تواند منجر به فایل های محرمانه با مجوزهای ضعیف شود.

برای جلوگیری از این ، یادم به طور خودکار مجوزهای فایل های محرمانه را به روز می کند.
مجوزهای «گروه» و «دیگران» از فایل‌های زیر حذف خواهند شد:

- $HOME/.yadm/files.gpg

- تمام فایل های مطابق با الگوهای در $HOME/.yadm/encrypt

- فهرست و فایل های SSH، ssh/*

- فهرست و فایل های GPG، .gnupg/*

یادم به طور خودکار مجوزها را به طور پیش فرض به روز می کند. این را می توان با استفاده از غیر فعال کرد
yadm.auto-perms پیکربندی حتی اگر غیرفعال باشد، مجوزها را می توان به صورت دستی به روز کرد
در حال اجرا یادم پرم. پردازش دایرکتوری SSH را می توان با استفاده از غیر فعال کرد yadm.ssh-perms
پیکربندی

با استفاده از خدمات onworks.net از yadm به صورت آنلاین استفاده کنید