PUPPET-REPORT(8) OpenVox manual PUPPET-REPORT(8) نام (NAME) puppet-report - پردازش و مدیریت گزارش‌های تراکنش در Puppet خلاصه دستور (SYNOPSIS) puppet report action [--terminus _TERMINUS] گزینه‌ها (OPTIONS) توجه داشته باشید هر تنظیمی که در فایل پیکربندی معتبر باشد، به عنوان یک آرگومان بلند نیز معتبر است، هرچند ممکن است به اقدام فعلی مربوط باشد یا نباشد. برای نمونه، server و run_mode تنظیمات معتبری هستند، بنابراین می‌توانید --server یا --run_mode را به عنوان آرگومان مشخص کنید. برای مشاهدهٔ فهرست کامل پارامترهای پذیرفتنی، مستندات فایل پیکربندی را در نشانی 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 را ببینید Vox Pupuli January 2025 PUPPET-REPORT(8)