.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "PUPPET\-PLUGIN" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
.SH "نام (NAME)"
\fBpuppet\-plugin\fR \- تعامل با سامانهٔ افزونه‌های OpenVox\.
.SH "خلاصه دستور (SYNOPSIS)"
puppet plugin \fIaction\fR
.SH "توضیحات (DESCRIPTION)"
این زیردستور دسترسی شبکه‌ای به مخزن افزونه‌های سرور OpenVox را فراهم می‌کند\.
.P
سرور OpenVox کدهای Ruby جمع‌آوری‌شده از پوشه‌های \fBlib\fR ماژول‌های خود را ارائه می‌دهد\. این افزونه‌ها را می‌توان در گره‌های عامل (agent nodes) برای گسترش Facter و پیاده‌سازی انواع (types) و ارائه‌دهندگان (providers) سفارشی استفاده کرد\. افزونه‌ها معمولاً توسط عامل OpenVox در طول اجرای یک فرآیند بارگیری می‌شوند\.
.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
ثبت اطلاعات اشکال‌زدایی\.
.SH "اقدامات (ACTIONS)"
.TP
\fBdownload\fR \- بارگیری افزونه‌ها از puppet master\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet plugin download
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
افزونه‌ها را از سرور پیکربندی‌شدهٔ OpenVox بارگیری می‌کند\. هر افزونه‌ای که به این شیوه بارگیری شود، در تمامی فعالیت‌های بعدی OpenVox استفاده خواهد شد\. این اقدام فایل‌های روی دیسک را تغییر می‌دهد\.
.IP
\fBمقادیر بازگشتی (RETURNS)\fR
.IP
فهرستی از فایل‌های بارگیری‌شده، یا تأییدیه‌ای مبنی بر اینکه هیچ فایلی بارگیری نشده است\. هنگام استفاده از رابط برنامه‌نویسی (API) زبان Ruby، این اقدام آرایه‌ای از فایل‌های بارگیری‌شده را بازمی‌گرداند که در صورت دریافت نشدن هیچ فایلی، خالی خواهد بود\.
.SH "مثال‌ها (EXAMPLES)"
\fBdownload\fR
.P
دریافت افزونه‌ها از puppet master:
.P
$ puppet plugin download
.P
دریافت افزونه‌ها از puppet master (نمونهٔ API):
.P
$ Puppet::Face[:plugin, '0\.0\.1']\.download
.SH "حق نشر و مجوز (COPYRIGHT AND LICENSE)"
حق نشر ۲۰۱۱ متعلق به Puppet Inc\.، Vox Pupuli با مجوز Apache 2؛ پروندهٔ COPYING را ببینید