.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "PUPPET\-FACTS" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
.SH "نام (NAME)"
puppet-facts \- بازیابی و نمایش حقایق و اطلاعات سیستم در Puppet
.SH "خلاصه دستور (SYNOPSIS)"
puppet facts \fIaction\fR [\-\-terminus _TERMINUS]
.SH "توضیحات (DESCRIPTION)"
این زیردستور فکت‌ها (حقایق) را مدیریت می‌کند؛ فکت‌ها مجموعه‌ای از اطلاعات استانداردشدهٔ سیستم هستند که توسط OpenVox مورد استفاده قرار می‌گیرند\. این زیردستور می‌تواند حقایق را مستقیماً از سیستم محلی بخواند (با ترمینوس پیش‌فرض \fBfacter\fR)\.
.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
آیا اطلاعات اشکال‌زدایی ثبت شوند یا خیر\.
.TP
\-\-terminus _TERMINUS
رابط‌های Indirector (یا indirector faces) زیرسیستم‌های هدایت‌شده (indirected) در Puppet را در دسترس قرار می‌دهند\. هر یک از این زیرسیستم‌ها می‌توانند نوع خاصی از داده‌ها را (با اقدامات آشنای \fBfind\fR، \fBsearch\fR، \fBsave\fR و \fBdestroy\fR) از تعداد دلخواهی از بک‌اند‌های (backends) قابل اتصال بازیابی کرده و تغییر دهند\. در اصطلاح Puppet، این بک‌اندها ترمینوس (terminuses) نامیده می‌شوند\.
.IP
تقریباً تمام زیرسیستم‌های indirected دارای یک ترمینوس \fBrest\fR هستند که با داده‌های puppet master تعامل دارد\. اکثر آن‌ها ترمینوس‌های دیگری نیز برای مدل‌های دادهٔ محلی گوناگون دارند که به نوبهٔ خود توسط زیرسیستم indirected در puppet master هنگام دریافت درخواست از راه دور استفاده می‌شوند\.
.IP
ترمینوس برای یک اقدام معمولاً توسط زمینه تعیین می‌شود، اما گاهی اوقات لازم است به‌طور صریح تنظیم گردد\. برای جزئیات بیشتر، بخش «نکات (NOTES)» در صفحه راهنمای این face را ببینید\.
.SH "اقدامات (ACTIONS)"
.TP
\fBfind\fR \- بازیابی فکت‌های یک گره\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet facts find [\-\-terminus _TERMINUS] [\fInode_certname\fR]
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
بازیابی فکت‌های یک گره\.
.IP
\fBمقادیر بازگشتی (RETURNS)\fR
.IP
یک درهم‌سازی (هش) حاوی برخی فراداده‌ها و (زیر کلید "values") مجموعه‌ای از فکت‌ها برای گره درخواست‌شده\. در صورت استفاده از API روبی: یک شیء Puppet::Node::Facts\.
.IP
مشکلات رندرینگ: فکت‌ها در حال حاضر نمی‌توانند به عنوان یک رشته نمایش داده شوند؛ از yaml یا json استفاده کنید\.
.IP
\fBنکات (NOTES)\fR
.IP
هنگام استفاده از ترمینوس \fBfacter\fR، آرگومان میزبان (host) نادیده گرفته می‌شود\.
.TP
\fBinfo\fR \- چاپ کلاس ترمینوس پیش‌فرض برای این face\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet facts info [\-\-terminus _TERMINUS]
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
کلاس ترمینوس پیش‌فرض را برای این زیردستور چاپ می‌کند\. توجه داشته باشید که حالت‌های مختلف اجرا ممکن است ترمینوس‌های پیش‌فرض متفاوتی داشته باشند؛ در صورت تردید، حالت اجرا را با گزینهٔ '\-\-run_mode' مشخص کنید\.
.TP
\fBsave\fR \- فقط برای API: ایجاد یا بازنویسی یک شیء\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet facts save [\-\-terminus _TERMINUS] \fIkey\fR
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
فقط برای API: ایجاد یا بازنویسی یک شیء\. از آنجا که چارچوب Faces در حال حاضر داده‌ها را از STDIN نمی‌پذیرد، در حال حاضر نمی‌توان اقدامات save را از خط فرمان فراخوانی کرد\.
.TP
\fBshow\fR \- بازیابی فکت‌های گره جاری\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet facts [\-\-terminus _TERMINUS] [\-\-config\-file \fIpath\fR] [\-\-custom\-dir \fIpath\fR] [\-\-external\-dir \fIpath\fR] [\-\-no\-block] [\-\-no\-cache] [\-\-show\-legacy] [\-\-value\-only] [\-\-timing] [\fIfacts\fR]
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
فکت‌ها را با استفاده از ترمینوس \fBfacter\fR از سیستم محلی می‌خواند\. می‌توان یک پرسمان (query) ارائه داد تا فقط یک فکت خاص یا مجموعه‌ای از فکت‌ها بازیابی شوند\.
.IP
\fBگزینه‌ها (OPTIONS)\fR \fI\-\-config\-file <path\fR> \- مکان فایل پیکربندی برای Facter\.
.IP
\fI\-\-custom\-dir <path\fR> \- مسیر دایرکتوری حاوی فکت‌های سفارشی\.
.IP
\fI\-\-external\-dir <path\fR> \- مسیر دایرکتوری حاوی فکت‌های خارجی\.
.IP
\fI\-\-no\-block\fR \- غیرفعال کردن سازوکار مسدودسازی فکت‌ها (fact blocking)\.
.IP
\fI\-\-no\-cache\fR \- غیرفعال کردن سازوکار کش فکت‌ها (fact caching)\.
.IP
\fI\-\-show\-legacy\fR \- نمایش فکت‌های قدیمی (legacy) هنگام پرسمان همه فکت‌ها\.
.IP
\fI\-\-timing\fR \- نمایش مدت زمان صرف‌شده برای حل و تعیین هر فکت\.
.IP
\fI\-\-value\-only\fR \- تنها نمایش مقدار هنگامی که اقدام با یک پرسمان منفرد فراخوانی می‌شود\.
.IP
\fBمقادیر بازگشتی (RETURNS)\fR
.IP
خروجی facter به همراه فکت‌های خاص اضافه شدهٔ Puppet\.
.IP
\fBنکات (NOTES)\fR
.TP
\fBupload\fR \- بارگذاری فکت‌های محلی در puppet master\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet facts upload [\-\-terminus _TERMINUS]
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
فکت‌ها را با استفاده از ترمینوس \fBfacter\fR از سیستم محلی می‌خواند، سپس فکت‌های بازگردانده‌شده را با استفاده از ترمینوس rest ذخیره می‌کند\.
.IP
\fBمقادیر بازگشتی (RETURNS)\fR
.IP
هیچ چیز\.
.IP
\fBنکات (NOTES)\fR
.IP
این اقدام مستلزم آن است که فایل \fBauth\.conf\fR در Puppet Server، دسترسی \fBPUT\fR یا \fBsave\fR را به نقطه پایانی API یعنی \fB/puppet/v3/facts\fR مجاز بداند\.
.IP
برای جزئیات بیشتر در مورد پیکربندی \fBauth\.conf\fR در Puppet Server، نشانی زیر را ببینید:
.IP
\fIhttps://puppet\.com/docs/puppetserver/latest/config_file_auth\.html\fR
.SH "مثال‌ها (EXAMPLES)"
\fBfind\fR
.P
دریافت فکت‌ها از سیستم محلی:
.P
$ puppet facts find
.P
\fBshow\fR
.P
بازیابی فکت‌ها:
.P
$ puppet facts show os
.P
\fBupload\fR
.P
بارگذاری فکت‌ها:
.P
$ puppet facts upload
.SH "نکات (NOTES)"
این زیردستور یک indirector face است که اقدامات \fBfind\fR، \fBsearch\fR، \fBsave\fR و \fBdestroy\fR را برای یک زیرسیستم هدایت‌شده (indirected) در Puppet ارائه می‌دهد\. ترمینوس‌های معتبر برای این face عبارت‌اند از:
.IP "\(bu" 4
\fBfacter\fR
.IP "\(bu" 4
\fBjson\fR
.IP "\(bu" 4
\fBmemory\fR
.IP "\(bu" 4
\fBnetwork_device\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 را ببینید