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

git-annex-import - وارد کردن فایل‌ها از یک مخزن ویژه دوردست

git annex import --from remote branch[:subdir] | [path ...]

این دستور روشی برای وارد کردن یک درخت از فایل‌ها از مکانی دیگر به مخزن git-annex شما است. این دستور می‌تواند فایل‌ها را از یک مخزن ویژه دوردست git-annex یا از یک دایرکتوری وارد کند.

وارد کردن از یک مخزن ویژه دوردست، ابتدا تمام محتوای جدید را از آن دانلود کرده یا درهم‌سازی (هش) می‌کند، و سپس یک کامیت git می‌سازد که بازتاب‌دهنده فایل‌های تغییریافته در مخزن ویژه دوردست از زمان آخرین بررسی git-annex است. ادغام (merge) آن کامیت در مخزن شما، آن را به‌روزرسانی می‌کند تا تغییرات اعمال‌شده در مخزن ویژه دوردست را منعکس کند.

به این ترتیب، یک برنامه یا سرویس می‌تواند از مخزن ویژه دوردست برای ذخیره‌سازی، افزودن، تغییر و حذف فایل‌ها استفاده کند و شما می‌توانید آن تغییرات را با استفاده از git-annex ردیابی کنید.

می‌توانید استفاده از git annex import برای واکشی تغییرات از یک مخزن ویژه دوردست را با git annex export برای ارسال تغییرات محلی خود به مخزن ویژه دوردست ترکیب کنید.

تنها می‌توانید از مخازن ویژه دوردستی فایل وارد کنید که هنگام راه‌اندازی با git-annex-initremote(1) با گزینه importtree=yes پیکربندی شده باشند. تنها برخی از انواع مخازن ویژه دوردست اجازه این نوع پیکربندی را می‌دهند؛ فهرستی احتمالاً غیرجامع شامل مخازن ویژه directory، s3 و adb است.

برای وارد کردن از یک مخزن ویژه دوردست، باید نام یک شاخه را مشخص کنید. یک شاخه ردیابی دوردست (remote tracking branch) متناظر توسط git annex import به‌روزرسانی خواهد شد. پس از آن، وضعیت مشابه زمانی است که یک git fetch را از یک ریموت معمولی git اجرا کرده باشید؛ می‌توانید تغییرات را در شاخه جاری که تحویل گرفته‌اید (checked out) ادغام کنید.

برای مثال:

git annex import master --from myremote
git annex merge --allow-unrelated-histories myremote/master

می‌توانید برای مرحله دوم به همان اندازه از git merge --allow-unrelated-histories myremote/master استفاده کنید، اما استفاده از git-annex merge از چند مشکل غیرمنتظره جلوگیری می‌کند. هنگام استفاده از شاخه‌های تنظیم‌شده (adjusted branches)، شاخه را پیش از ادغام کردن از آن تنظیم می‌کند.

گزینه --allow-unrelated-histories دست‌کم برای نخستین ادغامِ شاخه ردیابی دوردست واردشده لازم است، زیرا تاریخچه شاخه متصل نیست. این را مانند این در نظر بگیرید که ریموت یک مخزن جداگانه git با فایل‌های اختصاصی خود است. اگر ابتدا فایل‌ها را با git annex export به یک ریموت صادر کنید و سپس با git annex import از آن وارد کنید، نیازی به این گزینه نخواهید داشت.

می‌توانید با استفاده از نحو "branch:subdir" فایل‌ها را در یک زیردایرکتوری وارد کنید. برای مثال، اگر "camera" یک مخزن ویژه دوردست باشد که به یک دوربین دسترسی دارد، و بخواهید آن فایل‌ها را به جای ریشه مخزن، در دایرکتوری photos وارد کنید:

git annex import master:photos --from camera
git merge camera/master

دستور git annex sync --content (و دستیار git-annex) نیز می‌تواند برای وارد کردن از یک مخزن ویژه دوردست استفاده شود. برای انجام این کار، باید "remote.<name>.annex-tracking-branch" را پیکربندی کنید تا مشخص شود چه شاخه‌ای باید ردیابی شود. برای مثال:

git config remote.myremote.annex-tracking-branch master
git annex sync --content

هر فایلی که در gitignore نادیده گرفته شده باشد در وارد کردن گنجانده نخواهد شد، اما روی ریموت باقی می‌ماند.

هنگامی که برای مخزن ویژه دوردست عبارت محتوای ترجیحی توسط git-annex-wanted(1) تنظیم شده باشد، از آن برای انتخاب فایل‌هایی که باید وارد شوند استفاده می‌شود. فایل‌هایی که جزو محتوای ترجیحی ریموت نیستند از آن وارد نخواهند شد، بلکه روی ریموت باقی خواهند ماند.

بنابراین برای مثال، یک عبارت محتوای ترجیحی مانند "include=*.jpeg or largerthan=100mb" باعث می‌شود تنها فایل‌های jpeg و فایل‌های بزرگ وارد شوند.

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

مواردی مانند "include=" در عبارت، نسبت به بالاترین سطح درخت فایل‌ها در ریموت مطابقت داده می‌شوند، حتی هنگام وارد کردن به یک زیردایرکتوری.

کنترل می‌کند که آیا محتوای ضمیمه‌شده از مخزن ویژه دوردست دانلود شود یا خیر.
حالت پیش‌فرض، دانلود محتوا به مخزن git-annex است.
با --no-content، کلیدهای git-annex بر اساس اطلاعات ارائه‌شده توسط مخزن ویژه دوردست بدون دانلود آن تولید می‌شوند. دستوراتی مانند git-annex get بعداً می‌توانند در صورت تمایل برای دانلود فایل‌ها استفاده شوند. گزینه --no-content توسط تمام مخازن ویژه دوردست پشتیبانی نمی‌شود.
از این گزینه برای مشخص کردن پیام کامیت برای تغییراتی که از زمان آخرین وارد کردن در مخزن ویژه دوردست ایجاد شده است استفاده کنید.
اگر چندین گزینه -m مشخص شود، مقادیر آن‌ها به عنوان پاراگراف‌های جداگانه به هم متصل می‌شوند.

هنگامی که این دستور با یک مسیر اجرا شود، git annex import فایل‌ها را از مکانی خارج از نسخه کاری git **منتقل** می‌کند و آن‌ها را به ضمیمه می‌افزاید. بر خلاف وارد کردن از یک مخزن ویژه دوردست از نوع دایرکتوری، فایل‌های واردشده **از مسیر داده‌شده حذف می‌شوند**.

این یک رابط قدیمی است. این رابط همچنان پشتیبانی می‌شود، اما لطفاً تغییر به وارد کردن از یک مخزن ویژه دوردست دایرکتوری را با استفاده از رابط مستندشده در بالا مد نظر قرار دهید.

فایل‌های مجزا برای وارد کردن می‌توانند مشخص شوند. اگر یک دایرکتوری مشخص شود، کل دایرکتوری وارد می‌شود. لطفاً توجه داشته باشید که دستور زیر **تمام فایل‌ها را از دایرکتوری مبدأ حذف خواهد کرد**.

git annex import /media/camera/DCIM/*

هنگام وارد کردن فایل‌ها، این احتمال وجود دارد که نسخه‌ای تکراری از فایلی وارد شود که از قبل برای git-annex شناخته شده است -- محتوای آن یا از قبل در مخزن محلی وجود دارد، یا git-annex از مخزن دیگری که حاوی آن است مطلع است، یا پیش‌تر در ضمیمه وجود داشته اما اکنون حذف شده است.

به‌طور پیش‌فرض، وارد کردن یک فایل تکراری شناخته‌شده منجر به افزودن نام فایل جدیدی به مخزن می‌شود، بنابراین فایل تکراری دو بار در مخزن حضور خواهد داشت. (با تمام backendهای مبتنی بر چکسام، از جمله SHA256E پیش‌فرض، تنها یک نسخه از داده ذخیره خواهد شد.)

چندین گزینه می‌توانند برای تنظیم نحوه مدیریت فایل‌های تکراری استفاده شوند؛ مستندات --duplicate، --deduplicate، --skip-duplicates، --clean-duplicates و --reinject-duplicates را در زیر ببینید.

پیوندهای نمادین (symbolic links) درون دایرکتوری در حال واردسازی نادیده گرفته می‌شوند تا از وارد کردن تصادفی مواردی خارج از دایرکتوری که import روی آن اجرا شده است جلوگیری شود. با این حال، خود دایرکتوری که import روی آن اجرا می‌شود می‌تواند یک پیوند نمادین باشد و آن پیوند نمادین دنبال خواهد شد.

فایل‌ها را از مکان واردسازی حذف نمی‌کند.
اجرای مکرر با این گزینه می‌تواند همان فایل‌ها را به مخازن، شاخه‌ها یا مکان‌های مختلفی در یک مخزن git وارد کند.
فقط فایل‌هایی را که تکراری نیستند وارد می‌کند؛ فایل‌های تکراری از مکان واردسازی حذف خواهند شد.
فقط فایل‌هایی را که تکراری نیستند وارد می‌کند. از حذف هرگونه فایل از مکان واردسازی جلوگیری می‌کند.
هیچ فایلی را وارد نمی‌کند، اما هر فایلی که در مکان واردسازی یافت شود و تکراری باشد حذف می‌شود.
فایل‌هایی را که تکراری نیستند وارد می‌کند. فایل‌هایی که تکراری هستند، محتوای آن‌ها مجدداً به ضمیمه تزریق می‌شود (مشابه git-annex-reinject(1)).
اجازه می‌دهد فایل‌های موجود توسط فایل‌های تازه‌واردشده بازنویسی شوند.
همچنین باعث می‌شود هنگام افزودن فایل‌ها، فایل .gitignore اعمال نشود.
گزینه‌های تطبیق فایل (file matching options)
بسیاری از گزینه‌های git-annex-matching-options(1) می‌توانند برای مشخص کردن فایل‌های واردشونده استفاده شوند.
git annex import /dir --include='*.png'

فایل‌ها را به‌صورت موازی وارد می‌کند. این کار ممکن است سریع‌تر باشد. برای مثال: -J4
تنظیم این مقدار به "cpus" به ازای هر هسته پردازنده یک کار اجرا خواهد کرد.
مشخص می‌کند که از کدام backend کلید-مقدار برای فایل‌های واردشده استفاده شود.
فایل‌های نادیده‌گرفته‌شده در gitignore را اضافه می‌کند.
خروجی JSON را فعال می‌کند. این قابلیت برای پردازش توسط برنامه‌هایی که از git-annex استفاده می‌کنند در نظر گرفته شده است. هر خط از خروجی یک شیء JSON است.
اشیاء پیشرفت را در خروجی JSON می‌گنجاند.
پیام‌هایی که معمولاً در خروجی خطای استاندارد نمایش داده می‌شدند، در عوض در داخل JSON گنجانده می‌شوند.
همچنین می‌توان از گزینه‌های git-annex-common-options(1) نیز استفاده کرد.

توجه داشته باشید که استفاده از --deduplicate یا --clean-duplicates با backend از نوع WORM، محتوای فایل را بررسی نمی‌کند، بلکه نام فایل و mtime را در نظر می‌گیرد.

اگر annex.largefiles پیکربندی شده باشد و با فایلی مطابقت نداشته باشد، git annex import فایل غیربزرگ (non-large) را به جای ضمیمه، مستقیماً به مخزن git اضافه خواهد کرد.

git-annex(1)

git-annex-add(1)

git-annex-export(1)

git-annex-preferred-content(1)

Joey Hess <id@joeyh.name>