git-annex-enableremote(1) General Commands Manual git-annex-enableremote(1)

git-annex-enableremote - فعال‌سازی استفاده از یک مخزن دوردست (remote) در git-annex

git annex enableremote name|uuid|desc [param=value ...]

امکان استفاده از یک مخزن دوردست (remote) موجود را در مخزن جاری فعال می‌کند؛ مخزنی که قبلاً با اجرای دستور git annex initremote در یک کلون دیگر از مخزن راه‌اندازی شده است.

هنگام فعال‌سازی یک ریموت، همان نامی را مشخص کنید که در زمان راه‌اندازی اولیه آن با git annex initremote به کار رفته است. اجرای git annex enableremote بدون هیچ نامی، فهرستی از نام‌های ریموت‌ها را نمایش می‌دهد. همچنین می‌توانید به جای نام، UUID یا توضیحات ریموت را مشخص کنید.

برخی از انواع ریموت‌های ویژه نیاز دارند که هر بار هنگام فعال‌سازی پارامترهایی برای آن‌ها مشخص شود. برای نمونه، ریموت ویژه دایرکتوری (directory) هر بار نیازمند پارامتر directory= است. در صورت جا انداختن هر پارامتر الزامی، دستور از شما درخواست ورودی خواهد کرد.

از این دستور همچنین می‌توان برای تغییر پیکربندی یک ریموت ویژه موجود استفاده کرد، از طریق مشخص کردن مقادیر جدید برای پارامترهایی که معمولاً هنگام استفاده از initremote تنظیم می‌شوند. (با این حال، برخی از تنظیمات مانند طرح رمزنگاری، پس از ایجاد ریموت ویژه قابل تغییر نیستند.)

کلیدهای GPG که ریموت ویژه رمزنگاری‌شده با آن‌ها رمز شده است را می‌توان با استفاده از پارامترهای keyid+= و keyid-= تغییر داد. این پارامترها به ترتیب کلیدها را به فهرست اضافه یا از آن حذف می‌کنند. با این حال، توجه داشته باشید که حذف یک کلید لزوماً مانع از دسترسی مالک آن کلید به داده‌های موجود در ریموت ویژه رمزنگاری‌شده نمی‌شود (که از نظر طراحی، بدون حذف کامل ریموت، غیرممکن است).

یک مورد کاربرد keyid-= جایگزینی یک کلید ابطال‌شده با یک کلید جدید است:

git annex enableremote mys3 keyid-=revokedkey keyid+=newkey

همچنین توجه داشته باشید که در ریموت‌های ویژه رمزنگاری‌شده که از رمزنگاری ساده کلید عمومی (encryption=pubkey) استفاده می‌کنند، افزودن یا حذف یک کلید تاثیری بر فایل‌هایی که قبلاً به ریموت کپی شده‌اند نخواهد داشت. بنابراین استفاده از keyid+= و keyid-= با چنین ریموت‌هایی باید با احتیاط انجام شود، و به جز در مواردی مانند مثال کلید ابطال‌شده در بالا، کاربرد چندانی ندارد.

اگر از فعال‌سازی دستی یک ریموت ویژه در هر کلون جدید خسته شده‌اید، می‌توانید autoenable=true را ارسال کنید. در این صورت، هنگامی که git-annex-init(1) در یک کلون جدید اجرا شود، تلاش می‌کند ریموت ویژه را فعال کند. البته این حالت زمانی بهترین کارایی را دارد که فعال‌سازی ریموت ویژه نیاز به اقدام خاصی نداشته باشد.

(همچنین این دستور می‌تواند برای فعال‌سازی یک ریموت گیت استفاده شود که git-annex قبلاً متوجه کار نکردن آن شده و از استفاده از آن صرف‌نظر کرده بود و مقدار remote.<name>.annex-ignore را تنظیم کرده بود.)

این گزینه ریموت را با یک URL به‌صورت "annex::" پیکربندی می‌کند، که به گیت اجازه می‌دهد با استفاده از git-remote-annex به آن push و pull کند.
فعال‌سازی خروجی JSON. این گزینه برای پردازش ماشینی توسط برنامه‌هایی که از git-annex استفاده می‌کنند در نظر گرفته شده است.
--json-error-messages
پیام‌هایی که معمولاً در خروجی خطای استاندارد چاپ می‌شوند، در داخل JSON گنجانده می‌شوند.

همچنین می‌توانید از git-annex-common-options(1) استفاده کنید.

git-annex(1)

git-annex-initremote(1)

git-annex-configremote(1)

git-annex-renameremote(1)

Joey Hess <id@joeyh.name>