." generated with Ronn-NG/v0.10.1
." http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "PUPPET\-FILEBUCKET" "8" "January 2025" "Vox Pupuli" "راهنمای OpenVox"
.SH "نام (NAME)"
puppet\-filebucket \- ذخیره و بازیابی فایل‌ها در مخزن فایل (filebucket) سامانه OpenVox
.SH "خلاصه دستور (SYNOPSIS)"
کلاینت مستقل مخزن فایل (filebucket) در سامانه OpenVox.
.SH "نحوه استفاده (USAGE)"
puppet filebucket \fImode\fR [\-h|\-\-help] [\-V|\-\-version] [\-d|\-\-debug] [\-v|\-\-verbose] [\-l|\-\-local] [\-r|\-\-remote] [\-s|\-\-server \fIserver\fR] [\-f|\-\-fromdate \fIdate\fR] [\-t|\-\-todate \fIdate\fR] [\-b|\-\-bucket \fIdirectory\fR] \fIfile\fR \fIfile\fR \|\.\|\.\|\.
.P
این کلاینت filebucket می‌تواند در سه حالت عملیاتی اجرا شود و در هر فراخوانی تنها یک حالت مجاز است:
.P
backup: ارسال یک یا چند فایل به مخزن فایل مشخص‌شده. هر فایل ارسال‌شده همراه با مقدار sha256 حاصل از آن چاپ می‌شود.
.P
get: بازگرداندن متن مرتبط با یک جمع کنترلی sha256. متن در خروجی استاندارد چاپ می‌شود و در هر بار تنها یک فایل قابل‌بازیابی است.
.P
restore: با دریافت مسیر فایل و یک جمع کنترلی sha256، محتوای مرتبط با آن را در مسیر مشخص‌شده ذخیره می‌کند. می‌توانید یک مسیر کاملاً جدید تعیین کنید؛ محدودیتی در بازیابی به مکان اصلی وجود ندارد.
.P
diff: چاپ تفاوت‌ها در قالب یکپارچه (unified diff) بین دو جمع کنترلی در filebucket یا بین یک جمع کنترلی و فایل متناظر محلی آن.
.P
list: فهرست کردن تمام فایل‌های موجود در مخزن فایل محلی فعلی. فهرست کردن مخازن فایل راه دور مجاز نیست.
.SH "توضیحات (DESCRIPTION)"
این یک کلاینت مستقل filebucket برای ارسال فایل‌ها به یک مخزن فایل محلی یا مرکزی است.
.P
توجه داشته باشید که 'filebucket' به طور پیش‌فرض از یک مخزن فایل تحت شبکه موجود روی سروری به نام 'puppet' استفاده می‌کند. برای استفاده از این قابلیت، باید با کاربری اجرا شود که دارای گواهی‌های معتبر Puppet باشد. از طرف دیگر، می‌توانید با مشخص کردن '\-\-local' از مخزن فایل محلی خود استفاده کنید، یا با گزینه '\-\-bucket' یک مسیر محلی را تعیین نمایید.
.P
\fBمهم\fR: هنگامی که گزینه backup و در نتیجه منبع filebucket را فعال و استفاده می‌کنید، باید اطمینان حاصل کنید که فضای دیسک کافی برای فایل‌های پشتیبان در دسترس است. به طور کلی، می‌توانید فضای دیسک را با استفاده از یکی از دو روش زیر تأمین کنید:
.IP "\(bu" 4
استفاده از یک دستور \fBfind\fR و ورودی \fBcrontab\fR برای نگهداری فایل‌های پشتیبان تنها مربوط به X روز گذشته. به عنوان مثال:
.IP "" 0
.IP "" 4
.nf
  find /opt/puppetlabs/server/data/puppetserver/bucket \-type f \-mtime +45 \-atime +45 \-print0 | xargs \-0 rm
.fi
.IP "" 0
.IP "\(bu" 4
محدود کردن دایرکتوری به حداکثر اندازه مشخص که پس از آن قدیمی‌ترین موارد حذف شوند.
.IP "" 0
.SH "گزینه‌ها (OPTIONS)"
توجه داشته باشید هر تنظیمی که در فایل پیکربندی معتبر باشد، به عنوان یک آرگومان بلند خط فرمان نیز معتبر است. به عنوان مثال، 'ssldir' یک تنظیم معتبر است، بنابراین می‌توانید '\-\-ssldir \fIdirectory\fR' را به عنوان یک آرگومان مشخص کنید.
.P
برای مشاهده فهرست کامل پارامترهای قابل‌قبول، مستندات فایل پیکربندی را در https://puppet.com/docs/puppet/latest/configuration.html ببینید. همچنین فهرستی همراه با توضیحات از تمام گزینه‌های پیکربندی می‌تواند با اجرای puppet با گزینه '\-\-genconfig' تولید شود.
.TP
\-\-bucket
مشخص کردن مسیر محلی مخزن فایل (filebucket). این گزینه مسیر پیش‌فرض تنظیم‌شده در '' را نادیده می‌گیرد.
.TP
\-\-debug
فعال‌سازی اشکال‌زدایی کامل.
.TP
\-\-fromdate
(فقط در حالت list) انتخاب فایل‌های مخزن از تاریخ 'fromdate'.
.TP
\-\-help
چاپ این پیام راهنما.
.TP
\-\-local
استفاده از مخزن فایل محلی. این گزینه به طور پیش‌فرض از اطلاعات پیکربندی پیش‌فرض و مخزن واقع در تنظیم '' استفاده می‌کند. اگر '\-\-bucket' مشخص شده باشد، آن مسیر استفاده می‌شود.
.TP
\-\-remote
استفاده از مخزن فایل راه دور. این گزینه به طور پیش‌فرض از اطلاعات پیکربندی پیش‌فرض و مخزن واقع در تنظیم '' استفاده می‌کند.
.TP
\-\-server_list
فهرستی از سرورهای جداشده با کاما؛ تنها ورودی اول برای ذخیره‌سازی فایل استفاده می‌شود. این تنظیم بر \fBserver\fR اولویت دارد.
.TP
\-\-server
سرور مورد استفاده برای ذخیره‌سازی فایل. این تنظیم فقط در صورتی استفاده می‌شود که \fBserver_list\fR تنظیم نشده باشد.
.TP
\-\-todate
(فقط در حالت list) انتخاب فایل‌های مخزن تا تاریخ 'todate'.
.TP
\-\-verbose
چاپ اطلاعات بیشتر.
.TP
\-\-version
چاپ اطلاعات نسخه.
.SH "مثال‌ها (EXAMPLES)"
.nf
## پشتیبان‌گیری از یک فایل در filebucket، سپس بازگردانی آن به یک دایرکتوری موقت
$ puppet filebucket backup /etc/passwd
/etc/passwd: 429b225650b912a2ee067b0a4cf1e949
$ puppet filebucket restore /tmp/passwd 429b225650b912a2ee067b0a4cf1e949

## مقایسه تفاوت بین دو فایل در filebucket
$ puppet filebucket \-l diff d43a6ecaa892a1962398ac9170ea9bf2 7ae322f5791217e031dc60188f4521ef
1a2
> again

## مقایسه تفاوت بین فایل درون filebucket و یک فایل محلی
$ puppet filebucket \-l diff d43a6ecaa892a1962398ac9170ea9bf2 /tmp/testFile
1a2
> again

## پشتیبان‌گیری یک فایل در filebucket و نگهداری مستقل هر نسخه پشتیبان
$ puppet filebucket \-l list
d43a6ecaa892a1962398ac9170ea9bf2 2015\-05\-11 09:27:56 /tmp/TestFile

$ echo again >> /tmp/TestFile

$ puppet filebucket \-l backup /tmp/TestFile
/tmp/TestFile: 7ae322f5791217e031dc60188f4521ef

$ puppet filebucket \-l list
d43a6ecaa892a1962398ac9170ea9bf2 2015\-05\-11 09:27:56 /tmp/TestFile
7ae322f5791217e031dc60188f4521ef 2015\-05\-11 09:52:15 /tmp/TestFile

## فهرست کردن فایل‌ها در filebucket بر اساس بازه‌های زمانی
$ puppet filebucket \-l \-f 2015\-01\-01 \-t 2015\-01\-11 list
<Empty Output>

$ puppet filebucket \-l \-f 2015\-05\-10 list
d43a6ecaa892a1962398ac9170ea9bf2 2015\-05\-11 09:27:56 /tmp/TestFile
7ae322f5791217e031dc60188f4521ef 2015\-05\-11 09:52:15 /tmp/TestFile

$ puppet filebucket \-l \-f "2015\-05\-11 09:30:00" list
7ae322f5791217e031dc60188f4521ef 2015\-05\-11 09:52:15 /tmp/TestFile

$ puppet filebucket \-l \-t "2015\-05\-11 09:30:00" list
d43a6ecaa892a1962398ac9170ea9bf2 2015\-05\-11 09:27:56 /tmp/TestFile

## مدیریت فایل‌ها در یک filebucket محلی مشخص
$ puppet filebucket \-b /tmp/TestBucket backup /tmp/TestFile2
/tmp/TestFile2: d41d8cd98f00b204e9800998ecf8427e
$ puppet filebucket \-b /tmp/TestBucket list
d41d8cd98f00b204e9800998ecf8427e 2015\-05\-11 09:33:22 /tmp/TestFile2

## فهرست کردن فایل‌ها در bucketdir سرور از روی یک سرور Puppet
$ puppet filebucket \-b $(puppet config print bucketdir \-\-section server) list
d43a6ecaa892a1962398ac9170ea9bf2 2015\-05\-11 09:27:56 /tmp/TestFile
7ae322f5791217e031dc60188f4521ef 2015\-05\-11 09:52:15 /tmp/TestFile
.fi
.SH "نویسندگان (AUTHORS)"
Luke Kanies
.SH "حق نشر (COPYRIGHT)"
حق نشر (c) 2011 متعلق به Puppet Inc. حق نشر (c) 2024 متعلق به Vox Pupuli، منتشر شده تحت مجوز Apache 2.0