نام (NAME)

puppet-report - پردازش و مدیریت گزارش‌های تراکنش در Puppet

خلاصه دستور (SYNOPSIS)

puppet report action [--terminus _TERMINUS]

گزینه‌ها (OPTIONS)

توجه داشته باشید هر تنظیمی که در فایل پیکربندی معتبر باشد، به عنوان یک آرگومان بلند نیز معتبر است، هرچند ممکن است به اقدام فعلی مربوط باشد یا نباشد. برای نمونه، server و run_mode تنظیمات معتبری هستند، بنابراین می‌توانید --server <servername> یا --run_mode <runmode> را به عنوان آرگومان مشخص کنید.

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

--render-as FORMAT: قالبی که خروجی در آن ارائه می‌شود. رایج‌ترین قالب‌ها عبارت‌اند از json، s (رشته)، yaml و console، اما گزینه‌های دیگری مانند dot نیز گاهی در دسترس هستند.
--verbose: آیا گزارش‌ها با جزئیات کامل ثبت شوند یا خیر.
--debug: آیا اطلاعات اشکال‌زدایی ثبت شوند یا خیر.
--terminus _TERMINUS: رابط‌های Indirector (یا indirector faces) زیرسیستم‌های هدایت‌شده (indirected) در Puppet را در دسترس قرار می‌دهند. هر یک از این زیرسیستم‌ها می‌توانند نوع خاصی از داده‌ها را (با اقدامات آشنای find، search، save و destroy) از تعداد دلخواهی از بک‌اند‌های (backends) قابل اتصال بازیابی کرده و تغییر دهند. در اصطلاح Puppet، این بک‌اندها ترمینوس (terminuses) نامیده می‌شوند.

: تقریباً تمام زیرسیستم‌های indirected دارای یک ترمینوس rest هستند که با داده‌های puppet master تعامل دارد. اکثر آن‌ها ترمینوس‌های دیگری نیز برای مدل‌های دادهٔ محلی گوناگون دارند که به نوبهٔ خود توسط زیرسیستم indirected در puppet master هنگام دریافت درخواست از راه دور استفاده می‌شوند.
: ترمینوس برای یک اقدام معمولاً توسط زمینه تعیین می‌شود، اما گاهی اوقات لازم است به‌طور صریح تنظیم گردد. برای جزئیات بیشتر، بخش «نکات (NOTES)» در صفحه راهنمای این face را ببینید.

اقدامات (ACTIONS)

info - چاپ کلاس ترمینوس پیش‌فرض برای این face.: خلاصه دستور (SYNOPSIS)

: puppet report info [--terminus _TERMINUS]
: توضیحات (DESCRIPTION)
: کلاس ترمینوس پیش‌فرض را برای این زیردستور چاپ می‌کند. توجه داشته باشید که حالت‌های مختلف اجرا ممکن است ترمینوس‌های پیش‌فرض متفاوتی داشته باشند؛ در صورت تردید، حالت اجرا را با گزینهٔ '--run_mode' مشخص کنید.

save - فقط برای API: ارسال یک گزارش.: خلاصه دستور (SYNOPSIS)

: puppet report save [--terminus _TERMINUS] report
: توضیحات (DESCRIPTION)
: فقط برای API: ایجاد یا بازنویسی یک شیء. از آنجا که چارچوب Faces در حال حاضر داده‌ها را از STDIN نمی‌پذیرد، اقدامات ذخیره‌سازی (save) را در حال حاضر نمی‌توان از خط فرمان فراخوانی کرد.
: مقادیر بازگشتی (RETURNS)
: هیچ (Nothing).

submit - فقط برای API: ارسال یک گزارش با مدیریت خطا.: خلاصه دستور (SYNOPSIS)

: puppet report submit [--terminus _TERMINUS] report
: توضیحات (DESCRIPTION)
: فقط برای API: یک گزارش را به سرور OpenVox ارسال می‌کند. این اقدام در اصل یک میان‌بر و لفاف (wrapper) برای اقدام save با ترمینوس rest است و در صورت بروز خطا جزئیات بیشتری را ارائه می‌دهد.

مثال‌ها (EXAMPLES)

save

از پیاده‌سازی puppet report submit (مثال API):

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

submit

مثال API:

report = Puppet::Face[:catalog, '0.0.1'].apply
Puppet::Face[:report, '0.0.1'].submit(report)
return report

نکات (NOTES)

این زیردستور یک indirector face است که اقدامات find، search، save و destroy را برای یک زیرسیستم هدایت‌شده (indirected) در Puppet ارائه می‌دهد. ترمینوس‌های معتبر برای این face عبارت‌اند از:

json
msgpack
processor
rest
yaml

حق نشر و مجوز (COPYRIGHT AND LICENSE)

حق نشر ۲۰۱۱ متعلق به Puppet Inc.، مجوز Vox Pupuli Apache 2؛ پروندهٔ COPYING را ببینید