PUPPET-FILEBUCKET(8) راهنمای OpenVox PUPPET-FILEBUCKET(8)

puppet-filebucket - ذخیره و بازیابی فایل‌ها در مخزن فایل (filebucket) سامانه OpenVox

کلاینت مستقل مخزن فایل (filebucket) در سامانه OpenVox.

puppet filebucket mode [-h|--help] [-V|--version] [-d|--debug] [-v|--verbose] [-l|--local] [-r|--remote] [-s|--server server] [-f|--fromdate date] [-t|--todate date] [-b|--bucket directory] file file ...

این کلاینت filebucket می‌تواند در سه حالت عملیاتی اجرا شود و در هر فراخوانی تنها یک حالت مجاز است:

backup: ارسال یک یا چند فایل به مخزن فایل مشخص‌شده. هر فایل ارسال‌شده همراه با مقدار sha256 حاصل از آن چاپ می‌شود.

get: بازگرداندن متن مرتبط با یک جمع کنترلی sha256. متن در خروجی استاندارد چاپ می‌شود و در هر بار تنها یک فایل قابل‌بازیابی است.

restore: با دریافت مسیر فایل و یک جمع کنترلی sha256، محتوای مرتبط با آن را در مسیر مشخص‌شده ذخیره می‌کند. می‌توانید یک مسیر کاملاً جدید تعیین کنید؛ محدودیتی در بازیابی به مکان اصلی وجود ندارد.

diff: چاپ تفاوت‌ها در قالب یکپارچه (unified diff) بین دو جمع کنترلی در filebucket یا بین یک جمع کنترلی و فایل متناظر محلی آن.

list: فهرست کردن تمام فایل‌های موجود در مخزن فایل محلی فعلی. فهرست کردن مخازن فایل راه دور مجاز نیست.

این یک کلاینت مستقل filebucket برای ارسال فایل‌ها به یک مخزن فایل محلی یا مرکزی است.

توجه داشته باشید که 'filebucket' به طور پیش‌فرض از یک مخزن فایل تحت شبکه موجود روی سروری به نام 'puppet' استفاده می‌کند. برای استفاده از این قابلیت، باید با کاربری اجرا شود که دارای گواهی‌های معتبر Puppet باشد. از طرف دیگر، می‌توانید با مشخص کردن '--local' از مخزن فایل محلی خود استفاده کنید، یا با گزینه '--bucket' یک مسیر محلی را تعیین نمایید.

مهم: هنگامی که گزینه backup و در نتیجه منبع filebucket را فعال و استفاده می‌کنید، باید اطمینان حاصل کنید که فضای دیسک کافی برای فایل‌های پشتیبان در دسترس است. به طور کلی، می‌توانید فضای دیسک را با استفاده از یکی از دو روش زیر تأمین کنید:

•
استفاده از یک دستور find و ورودی crontab برای نگهداری فایل‌های پشتیبان تنها مربوط به X روز گذشته. به عنوان مثال:
find /opt/puppetlabs/server/data/puppetserver/bucket -type f -mtime +45 -atime +45 -print0 | xargs -0 rm
•
محدود کردن دایرکتوری به حداکثر اندازه مشخص که پس از آن قدیمی‌ترین موارد حذف شوند.

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

برای مشاهده فهرست کامل پارامترهای قابل‌قبول، مستندات فایل پیکربندی را در https://puppet.com/docs/puppet/latest/configuration.html ببینید. همچنین فهرستی همراه با توضیحات از تمام گزینه‌های پیکربندی می‌تواند با اجرای puppet با گزینه '--genconfig' تولید شود.

مشخص کردن مسیر محلی مخزن فایل (filebucket). این گزینه مسیر پیش‌فرض تنظیم‌شده در '' را نادیده می‌گیرد.
فعال‌سازی اشکال‌زدایی کامل.
(فقط در حالت list) انتخاب فایل‌های مخزن از تاریخ 'fromdate'.
چاپ این پیام راهنما.
استفاده از مخزن فایل محلی. این گزینه به طور پیش‌فرض از اطلاعات پیکربندی پیش‌فرض و مخزن واقع در تنظیم '' استفاده می‌کند. اگر '--bucket' مشخص شده باشد، آن مسیر استفاده می‌شود.
استفاده از مخزن فایل راه دور. این گزینه به طور پیش‌فرض از اطلاعات پیکربندی پیش‌فرض و مخزن واقع در تنظیم '' استفاده می‌کند.
فهرستی از سرورهای جداشده با کاما؛ تنها ورودی اول برای ذخیره‌سازی فایل استفاده می‌شود. این تنظیم بر server اولویت دارد.
سرور مورد استفاده برای ذخیره‌سازی فایل. این تنظیم فقط در صورتی استفاده می‌شود که server_list تنظیم نشده باشد.
(فقط در حالت list) انتخاب فایل‌های مخزن تا تاریخ 'todate'.
چاپ اطلاعات بیشتر.
چاپ اطلاعات نسخه.

## پشتیبان‌گیری از یک فایل در 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

Luke Kanies

حق نشر (c) 2011 متعلق به Puppet Inc. حق نشر (c) 2024 متعلق به Vox Pupuli، منتشر شده تحت مجوز Apache 2.0

January 2025 Vox Pupuli