.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "PUPPET\-CATALOG" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
.SH "نام (NAME)"
puppet-catalog \- کامپایل، ذخیره، مشاهده و تبدیل کاتالوگ‌ها
.SH "خلاصه دستور (SYNOPSIS)"
puppet catalog \fIaction\fR [\-\-terminus _TERMINUS]
.SH "توضیحات (DESCRIPTION)"
این زیردستور با کاتالوگ‌ها (catalogs) سروکار دارد؛ کاتالوگ‌ها مصنوعات کامپایل‌شده به ازای هر گره هستند که از مجموعه‌ای از مانیفست‌های Puppet ایجاد می‌شوند\. به‌طور پیش‌فرض، این زیردستور با زیرسیستم کامپایل تعامل کرده و یک کاتالوگ را با استفاده از مانیفست پیش‌فرض و \fBcertname\fR کامپایل می‌کند، اما می‌توانید منبع کاتالوگ را با گزینهٔ \fB\-\-terminus\fR تغییر دهید\. همچنین می‌توانید با استفاده از '\-\-render\-as dot'، هر کاتالوگی را در قالب 'dot' چاپ کنید (برای مشاهده آسان گراف با OmniGraffle یا Graphviz)\.
.SH "گزینه‌ها (OPTIONS)"
توجه داشته باشید هر تنظیمی که در فایل پیکربندی معتبر باشد، به عنوان یک آرگومان طولانی نیز معتبر است، هرچند ممکن است به عمل فعلی مرتبط باشد یا نباشد\. برای نمونه، \fBserver\fR و \fBrun_mode\fR تنظیمات معتبری هستند، بنابراین می‌توانید \fB\-\-server <servername>\fR یا \fB\-\-run_mode <runmode>\fR را به عنوان آرگومان مشخص کنید\.
.P
برای فهرست کامل پارامترهای قابل قبول، مستندات فایل پیکربندی را در \fIhttps://puppet\.com/docs/puppet/latest/configuration\.html\fR ببینید\. همچنین می‌توان با اجرای puppet به همراه \fB\-\-genconfig\fR فهرستی حاوی توضیحات از تمام گزینه‌های پیکربندی تولید کرد\.
.TP
\-\-render\-as FORMAT
قالبی که خروجی در آن ارائه (رندر) می‌شود\. رایج‌ترین قالب‌ها \fBjson\fR، \fBs\fR (رشته)، \fByaml\fR و \fBconsole\fR هستند، اما گزینه‌های دیگری مانند \fBdot\fR نیز گاهی در دسترس هستند\.
.TP
\-\-verbose
ثبت گزارش‌ها با جزئیات کامل\.
.TP
\-\-debug
ثبت اطلاعات اشکال‌زدایی (debug)\.
.TP
\-\-terminus _TERMINUS
رابط‌های Indirector (یا indirector faces) زیرسیستم‌های هدایت‌شده (indirected) در Puppet را در دسترس قرار می‌دهند\. هر یک از این زیرسیستم‌ها می‌توانند نوع خاصی از داده‌ها را (با عمل‌های آشنای \fBfind\fR، \fBsearch\fR، \fBsave\fR و \fBdestroy\fR) از تعداد دلخواهی از backendهای قابل اتصال بازیابی کرده و تغییر دهند\. در اصطلاح Puppet، این backendها ترمینوس (terminuses) نامیده می‌شوند\.
.IP
تقریباً تمام زیرسیستم‌های indirected دارای یک ترمینوس \fBrest\fR هستند که با داده‌های puppet master تعامل دارد\. اکثر آن‌ها ترمینوس‌های دیگری نیز برای مدل‌های دادهٔ محلی مختلف دارند که به نوبهٔ خود توسط زیرسیستم indirected در puppet master هنگام دریافت درخواست از راه دور استفاده می‌شوند\.
.IP
ترمینوس برای یک عمل معمولاً توسط زمینه تعیین می‌شود، اما گاهی اوقات لازم است به‌طور صریح تنظیم گردد\. برای جزئیات بیشتر، بخش "نکات" در صفحه راهنمای این face را ببینید\.
.SH "عمل‌ها (ACTIONS)"
.TP
\fBapply\fR \- یافتن و اعمال یک کاتالوگ\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet catalog apply [\-\-terminus _TERMINUS]
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
یک کاتالوگ را یافته و اعمال می‌کند\. این عمل هیچ آرگومانی نمی‌پذیرد، اما منبع کاتالوگ را می‌توان با گزینهٔ \fB\-\-terminus\fR مدیریت کرد\.
.IP
\fBمقادیر بازگشتی (RETURNS)\fR
.IP
هیچ چیز\. در صورت استفاده از Ruby API، یک شیء Puppet::Transaction::Report بازمی‌گرداند\.
.TP
\fBcompile\fR \- کامپایل یک کاتالوگ\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet catalog compile [\-\-terminus _TERMINUS]
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
یک کاتالوگ را به‌صورت محلی برای یک گره کامپایل می‌کند، که نیازمند دسترسی به ماژول‌ها، رده‌بندی‌کننده گره (node classifier) و غیره است\.
.IP
\fBمقادیر بازگشتی (RETURNS)\fR
.IP
یک کاتالوگ سریال‌شده\.
.TP
\fBdownload\fR \- بارگیری کاتالوگ این گره از کارساز puppet master\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet catalog download [\-\-terminus _TERMINUS]
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
یک کاتالوگ را از puppet master بازیابی کرده و آن را در حافظهٔ موقت (cache) محلی yaml ذخیره می‌کند\. این عمل همواره با puppet master ارتباط برقرار کرده و ترمینوس‌های جایگزین را نادیده می‌گیرد\.
.IP
کاتالوگ ذخیره‌شده را می‌توان در هر عمل کاتالوگ بعدی با تعیین '\-\-terminus yaml' برای آن عمل استفاده کرد\.
.IP
\fBمقادیر بازگشتی (RETURNS)\fR
.IP
هیچ چیز\.
.IP
\fBنکات (NOTES)\fR
.IP
هنگام استفاده از Ruby API، این عمل اثر جانبی دارد و Puppet::Resource::Catalog\.indirection\.terminus_class را روی yaml تنظیم‌شده باقی می‌گذارد\. برای اعمال بعدی کاتالوگ، ترمینوس باید به‌طور صریح دوباره تنظیم شود\.
.TP
\fBfind\fR \- بازیابی کاتالوگ برای گره‌ای که دستور از آن اجرا می‌شود\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet catalog find [\-\-terminus _TERMINUS] [\-\-facts_for_catalog] \fIcertname\fR, \fIfacts\fR
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
بازیابی کاتالوگ برای گره‌ای که دستور از آن اجرا می‌شود\.
.IP
\fBگزینه‌ها (OPTIONS)\fR \fI\-\-facts_for_catalog\fR \- برای CLI پیاده‌سازی نشده است؛ facts به‌طور داخلی جمع‌آوری می‌شوند\.
.IP
\fBمقادیر بازگشتی (RETURNS)\fR
.IP
یک کاتالوگ سریال‌شده\. در صورت استفاده از Ruby API، یک شیء Puppet::Resource::Catalog بازمی‌گرداند\.
.TP
\fBinfo\fR \- چاپ کلاس ترمینوس پیش‌فرض برای این face\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet catalog info [\-\-terminus _TERMINUS]
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
کلاس ترمینوس پیش‌فرض را برای این زیردستور چاپ می‌کند\. توجه داشته باشید که حالت‌های مختلف اجرا ممکن است ترمینوس‌های پیش‌فرض متفاوتی داشته باشند؛ در صورت تردید، حالت اجرا را با گزینهٔ '\-\-run_mode' مشخص کنید\.
.TP
\fBsave\fR \- فقط برای API: ایجاد یا بازنویسی یک شیء\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet catalog save [\-\-terminus _TERMINUS] \fIkey\fR
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
فقط برای API: ایجاد یا بازنویسی یک شیء\. از آنجا که چارچوب Faces در حال حاضر داده‌ها را از STDIN نمی‌پذیرد، در حال حاضر نمی‌توان عمل‌های save را از خط فرمان فراخوانی کرد\.
.TP
\fBselect\fR \- بازیابی یک کاتالوگ و فیلتر کردن آن برای منابعی از یک نوع معین\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet catalog select [\-\-terminus _TERMINUS] \fIhost\fR \fIresource_type\fR
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
یک کاتالوگ را برای میزبان مشخص‌شده بازیابی کرده، سپس در آن به دنبال تمام منابع از نوع درخواست‌شده جستجو می‌کند\.
.IP
\fBمقادیر بازگشتی (RETURNS)\fR
.IP
فهرستی از ارجاعات منبع ("Type[title]")\. در صورت استفاده از API، آرایه‌ای از اشیاء Puppet::Resource استخراج‌شده از یک کاتالوگ را بازمی‌گرداند\.
.IP
\fBنکات (NOTES)\fR
.IP
به‌طور پیش‌فرض، این عمل یک کاتالوگ را از زیرسیستم کامپایلر Puppet بازیابی می‌کند؛ اگر می‌خواهید کاتالوگی را از puppet master بازیابی کنید، باید این عمل را با \fB\-\-terminus rest\fR فراخوانی کنید\.
.IP
مشکلات قالب‌بندی: این عمل در حال حاضر نمی‌تواند yaml کاربردی ارائه دهد؛ در عوض، کل یک کاتالوگ را بازمی‌گرداند\. به‌جای آن از json استفاده کنید\.
.SH "مثال‌ها (EXAMPLES)"
\fBapply\fR
.P
اعمال کاتالوگ ذخیره‌شده در حافظهٔ موقت محلی:
.P
$ puppet catalog apply \-\-terminus yaml
.P
بازیابی یک کاتالوگ از master و اعمال آن در یک مرحله:
.P
$ puppet catalog apply \-\-terminus rest
.P
مثال API:
.IP "" 4
.nf
# \|\.\|\.\|\.
Puppet::Face[:catalog, '0\.0\.1']\.download
# (Termini are singletons; catalog\.download has a side effect of
# setting the catalog terminus to yaml)
report  = Puppet::Face[:catalog, '0\.0\.1']\.apply
# \|\.\|\.\|\.
.fi
.IP "" 0
.P
\fBcompile\fR
.P
کامپایل کاتالوگ برای گره 'mynode':
.P
$ puppet catalog compile mynode \-\-codedir \|\.\|\.\|\.
.P
\fBdownload\fR
.P
بازیابی و ذخیره یک کاتالوگ:
.P
$ puppet catalog download
.P
مثال API:
.IP "" 4
.nf
Puppet::Face[:plugin, '0\.0\.1']\.download
Puppet::Face[:facts, '0\.0\.1']\.upload
Puppet::Face[:catalog, '0\.0\.1']\.download
# \|\.\|\.\|\.
.fi
.IP "" 0
.P
\fBselect\fR
.P
درخواست فهرستی از منابع پرونده‌های مدیریت‌شده برای یک گره از puppet master:
.P
$ puppet catalog select \-\-terminus rest somenode\.magpie\.lan file
.SH "نکات (NOTES)"
این زیردستور یک indirector face است که عمل‌های \fBfind\fR، \fBsearch\fR، \fBsave\fR و \fBdestroy\fR را برای یک زیرسیستم هدایت‌شده (indirected) در Puppet ارائه می‌دهد\. ترمینوس‌های معتبر برای این face عبارتند از:
.IP "\(bu" 4
\fBcompiler\fR
.IP "\(bu" 4
\fBjson\fR
.IP "\(bu" 4
\fBmsgpack\fR
.IP "\(bu" 4
\fBrest\fR
.IP "\(bu" 4
\fBstore_configs\fR
.IP "\(bu" 4
\fByaml\fR
.IP "" 0
.SH "حق نشر و مجوز (COPYRIGHT AND LICENSE)"
حق نشر ۲۰۱۱ متعلق به Puppet Inc\.، مجوز Vox Pupuli Apache 2؛ پروندهٔ COPYING را ببینید