نام (NAME)

borg-create - ایجاد یک آرشیو جدید

خلاصه دستور (SYNOPSIS)

borg [گزینه‌های عمومی] create [گزینه‌ها] ARCHIVE [PATH...]

توضیحات (DESCRIPTION)

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

شگرد نقطه‌اسلش در مسیرها (ریشه‌های بازگشتی) با استفاده از /./ فعال می‌شود: /this/gets/stripped/./this/gets/archived به معنای پردازش آن شیء در سیستم‌فایل است، اما پیشوند سمت چپ ./ از موارد آرشیوشده حذف خواهد شد (در این حالت، this/gets/archived مسیر شیء در آرشیو خواهد بود).

هنگام مشخص کردن '-' به عنوان مسیر، Borg داده‌ها را از ورودی استاندارد می‌خواند و فایلی با نام 'stdin' در آرشیو ایجاد می‌کند. در برخی موارد استفاده از --content-from-command مناسب‌تر است. برای جزئیات به بخش "خواندن از stdin" در زیر مراجعه کنید.

آرشیو برای فایل‌ها یا بخش‌هایی از فایل‌ها که قبلاً در آرشیوهای دیگر ذخیره شده‌اند، تقریباً هیچ فضای دیسکی مصرف نمی‌کند.

نام آرشیو باید یکتا باشد. نباید به '.checkpoint' یا '.checkpoint.N' (که N عدد است) ختم شود، زیرا این نام‌ها برای نقاط بازرسی استفاده شده و رفتار ویژه‌ای با آن‌ها می‌شود.

در نام آرشیو می‌توانید از جانگهدارنده‌های زیر استفاده کنید: {now}، {utcnow}، {fqdn}، {hostname}، {user} و چند مورد دیگر.

سرعت پشتیبان‌گیری با پردازش نکردن مجدد فایل‌هایی که قبلاً در آرشیوهای موجود ذخیره شده‌اند و تغییر نکرده‌اند، افزایش می‌یابد. تشخیص فایل‌های تغییرنیافته با مقایسه فراداده‌های فایل با مقادیر قبلی موجود در حافظه پنهان فایل‌ها انجام می‌شود.

این مقایسه می‌تواند در حالت‌های مختلفی که با --files-cache مشخص می‌شود عمل کند:

شماره inode: ایمنی بیشتر، اما اغلب ناپایدار در سیستم‌فایل‌های شبکه‌ای

در حالت عادی، تشخیص تغییر فایل‌ها اطلاعات inode را در نظر می‌گیرد تا دقت تشخیص بهبود یابد. این مورد برای فایل‌های روی SSHFS و سیستم‌های فایل شبکه‌ای مشابه که شماره inode پایداری ارائه نمی‌دهند مشکل‌ساز است؛ چنین فایل‌هایی همیشه تغییریافته تلقی خواهند شد. در این موارد می‌توانید از حالت‌های بدون inode برای بهبود کارایی استفاده کنید، اما قابلیت اطمینان تشخیص ممکن است کاهش یابد.

مقایسه ctime در برابر mtime: ایمنی در برابر سرعت

گزینه --files-changed کنترل می‌کند که Borg چگونه تغییر فایل را در طول پشتیبان‌گیری تشخیص دهد:

نقاط اتصال سیستم‌های فایل یا عکس‌های لحظه‌ای (snapshots) باید برای هر بار ایجاد آرشیو جدید یکسان باشد تا عملیات سریع تضمین شود، زیرا حافظه پنهان فایل از نام‌های مطلق فایل استفاده می‌کند. اگر این امر امکان‌پذیر نیست، استفاده از bind mount در یک مکان پایدار را در نظر بگیرید.

گزینه --progress مقادیر داده اصلی، فشرده‌شده و یکتاشده (به ترتیب با حروف O، C و D)، سپس تعداد فایل‌های پردازش‌شده (N) و پس از آن مسیر فعلی در حال پردازش را نمایش می‌دهد.

هنگام استفاده از --stats آماری درباره میزان داده‌های اضافه‌شده دریافت خواهید کرد - اندازه یکتاشده در بخش "This Archive" مهم‌ترین است زیرا نشان می‌دهد مخزن چقدر رشد خواهد کرد. گزینه --quick-stats سریع‌تر است زیرا از آمار سرتاسری مخزن صرف‌نظر می‌کند. گزینه‌های --stats یا --quick-stats با --dry-run ناسازگار هستند زیرا در اجرای آزمایشی فشرده‌سازی و حذف داده‌های تکراری انجام نمی‌شود.

برای راهنمایی بیشتر درباره الگوها، خروجی دستور borg_patterns را ببینید.

برای راهنمایی بیشتر درباره جانگهدارنده‌ها، خروجی دستور borg_placeholders را ببینید.

گزینه‌ها (OPTIONS)

برای گزینه‌های عمومی دستورات Borg به borg-common(1) مراجعه کنید.

مثال‌ها (EXAMPLES)

# پشتیبان‌گیری از ~/Documents در آرشیوی به نام "my-documents"
$ borg create /path/to/repo::my-documents ~/Documents
# پشتیبان‌گیری به همراه فهرست کردن فایل‌ها در حین پردازش
$ borg create --list /path/to/repo::my-documents ~/Documents
# پشتیبان‌گیری و حذف پیشوند مسیر با شگرد نقطه‌اسلش
$ borg create /path/to/repo::docs /mnt/disk/./docs
# پشتیبان‌گیری و مستثنی کردن فایل‌های pyc
$ borg create /path/to/repo::my-files \
    ~/Documents                       \
    ~/src                             \
    --exclude '*.pyc'
# پشتیبان‌گیری از ریشه سیستم‌فایل و استفاده از فشرده‌سازی zlib
$ borg create -C zlib,6 --one-file-system /path/to/repo::root-{now:%Y-%m-%d} /
# پشتیبان‌گیری به سمت سرور دوردست از طریق SSH
$ borg create ssh://borg@backup.example.org:2222/path/to/repo::{fqdn}-root-{now} /
# پشتیبان‌گیری بدون فشرده‌سازی
$ borg create --compression none /path/to/repo::arch ~
# پشتیبان‌گیری با فشرده‌سازی پیش‌فرض و بسیار سریع (lz4)
$ borg create /path/to/repo::arch ~
# فشرده‌سازی قوی‌تر با lzma
$ borg create --compression lzma,9 /path/to/repo::arch ~
# استفاده از خروجی find برای انتخاب فایل‌ها
$ find ~ -size -1000k | borg create --paths-from-stdin /path/to/repo::small-files-only

یادداشت‌ها (NOTES)

الگوهای --exclude با دستور tar متفاوت است؛ برای نمونه باید از --exclude '*/.bundler/gems' برای تطبیق مسیرها استفاده کنید.

گزینه -x یا --one-file-system پوشه‌هایی را که نقاط اتصال سیستم‌فایل‌های دیگر هستند مستثنی می‌کند. این کار با مقایسه شماره دستگاه در خروجی دستور stat انجام می‌شود.

همچنین ببینید (SEE ALSO)

borg-common(1), borg-delete(1), borg-prune(1), borg-check(1), borg-patterns(1), borg-placeholders(1), borg-compression(1)

نویسندگان (Author)

The Borg Collective