.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "PUPPET\-REPORT" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
.SH "نام (NAME)"
puppet-report \- پردازش و مدیریت گزارش‌های تراکنش در Puppet
.SH "خلاصه دستور (SYNOPSIS)"
puppet report \fIaction\fR [\-\-terminus _TERMINUS]
.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
\fBinfo\fR \- چاپ کلاس ترمینوس پیش‌فرض برای این face\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet report info [\-\-terminus _TERMINUS]
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
کلاس ترمینوس پیش‌فرض را برای این زیردستور چاپ می‌کند\. توجه داشته باشید که حالت‌های مختلف اجرا ممکن است ترمینوس‌های پیش‌فرض متفاوتی داشته باشند؛ در صورت تردید، حالت اجرا را با گزینهٔ '\-\-run_mode' مشخص کنید\.
.TP
\fBsave\fR \- فقط برای API: ارسال یک گزارش\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet report save [\-\-terminus _TERMINUS] \fIreport\fR
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
فقط برای API: ایجاد یا بازنویسی یک شیء\. از آنجا که چارچوب Faces در حال حاضر داده‌ها را از STDIN نمی‌پذیرد، اقدامات ذخیره‌سازی (save) را در حال حاضر نمی‌توان از خط فرمان فراخوانی کرد\.
.IP
\fBمقادیر بازگشتی (RETURNS)\fR
.IP
هیچ (Nothing)\.
.TP
\fBsubmit\fR \- فقط برای API: ارسال یک گزارش با مدیریت خطا\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet report submit [\-\-terminus _TERMINUS] \fIreport\fR
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
فقط برای API: یک گزارش را به سرور OpenVox ارسال می‌کند\. این اقدام در اصل یک میان‌بر و لفاف (wrapper) برای اقدام \fBsave\fR با ترمینوس \fBrest\fR است و در صورت بروز خطا جزئیات بیشتری را ارائه می‌دهد\.
.SH "مثال‌ها (EXAMPLES)"
\fBsave\fR
.P
از پیاده‌سازی \fBpuppet report submit\fR (مثال API):
.P
.nf
begin
  Puppet::Transaction::Report.indirection.terminus_class = :rest
  Puppet::Face[:report, "0.0.1"].save(report)
  Puppet.notice "Uploaded report for #{report.name}"
rescue => detail
  Puppet.log_exception(detail, "Could not send report: #{detail}")
end
.fi
.P
\fBsubmit\fR
.P
مثال API:
.P
.nf
report = Puppet::Face[:catalog, '0.0.1'].apply
Puppet::Face[:report, '0.0.1'].submit(report)
return report
.fi
.SH "نکات (NOTES)"
این زیردستور یک indirector face است که اقدامات \fBfind\fR، \fBsearch\fR، \fBsave\fR و \fBdestroy\fR را برای یک زیرسیستم هدایت‌شده (indirected) در Puppet ارائه می‌دهد\. ترمینوس‌های معتبر برای این face عبارت‌اند از:
.IP "\(bu" 4
\fBjson\fR
.IP "\(bu" 4
\fBmsgpack\fR
.IP "\(bu" 4
\fBprocessor\fR
.IP "\(bu" 4
\fBrest\fR
.IP "\(bu" 4
\fByaml\fR
.IP "" 0
.SH "حق نشر و مجوز (COPYRIGHT AND LICENSE)"
حق نشر ۲۰۱۱ متعلق به Puppet Inc\.، مجوز Vox Pupuli Apache 2؛ پروندهٔ COPYING را ببینید