.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "PUPPET\-CONFIG" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
.SH "نام (NAME)"
\fBpuppet\-config\fR \- تعامل با تنظیمات OpenVox\.
.SH "خلاصه دستور (SYNOPSIS)"
puppet config \fIaction\fR [\-\-section SECTION_NAME]
.SH "توضیحات (DESCRIPTION)"
این زیردستور می‌تواند تنظیمات موجود در فایل پیکربندی «puppet\.conf» اوپن‌واکس (OpenVox) را بررسی و اصلاح کند\. برای مشاهده مستندات مربوط به هر یک از تنظیمات، نشانی https://puppet\.com/docs/puppet/latest/configuration\.html را ببینید\.
.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 ببینید\. همچنین می‌توان با اجرای پاپت به همراه گزینه \fB\-\-genconfig\fR فهرستی حاوی توضیحات از تمام گزینه‌های پیکربندی تولید کرد\.
.TP
\-\-render\-as FORMAT
قالبی که خروجی در آن ارائه می‌شود\. رایج‌ترین قالب‌ها عبارتند از \fBjson\fR، \fBs\fR (رشته)، \fByaml\fR و \fBconsole\fR، اما گزینه‌های دیگری مانند \fBdot\fR نیز گاهی در دسترس هستند\.
.TP
\-\-verbose
ثبت گزارش‌ها با جزئیات کامل\.
.TP
\-\-debug
ثبت اطلاعات اشکال‌زدایی (دیباگ)\.
.TP
\-\-section SECTION_NAME
بخشی از فایل پیکربندی puppet\.conf که باید با آن تعامل شود\.
.IP
سه بخش پرکاربرد عبارتند از 'main'، 'server' و 'agent'\. بخش 'main' پیش‌فرض است و توسط تمام برنامه‌های OpenVox استفاده می‌شود\. سایر بخش‌ها می‌توانند مقادیر 'main' را برای برنامه‌های خاص بازنویسی کنند \-\- بخش 'server' بر Puppet Server تأثیر می‌گذارد و بخش 'agent' بر puppet agent اثرگذار است\.
.IP
بخش 'user' کاربرد کمتری دارد و بر puppet apply اثر می‌گذارد\. هر بخش دیگری به عنوان نام یک محیط قدیمی (یک ویژگی منسوخ‌شده) در نظر گرفته خواهد شد و تنها می‌تواند شامل تنظیمات 'manifest' و 'modulepath' باشد\.
.SH "عملیات‌ها (ACTIONS)"
.TP
\fBdelete\fR \- حذف یکی از تنظیمات OpenVox\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet config delete [\-\-section SECTION_NAME] \fIsetting\fR
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
تنظیمی را از بخش مشخص‌شده حذف می‌کند\. (پیش‌فرض بخش 'main' است)\.
.IP
\fBنکات (NOTES)\fR
.IP
به‌طور پیش‌فرض، این عملیات تنظیم پیکربندی را از دامنه پیکربندی 'main' حذف می‌کند\. از فلگ '\-\-section' برای حذف تنظیمات از سایر دامنه‌های پیکربندی استفاده کنید\.
.TP
\fBprint\fR \- بررسی تنظیمات فعلی OpenVox\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet config print [\-\-section SECTION_NAME] all | \fIsetting\fR [\fIsetting\fR \|\.\|\.\|\.]
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
مقدار یک تنظیم یا فهرستی از تنظیمات را چاپ می‌کند\.
.IP
این عملیات رابط جایگزینی برای اطلاعات در دسترس با \fBpuppet <subcommand> \-\-configprint\fR است\.
.IP
\fBنکات (NOTES)\fR
.IP
به‌طور پیش‌فرض، این عملیات پیکربندی عمومی را در بخش 'main' می‌خواند\. از فلگ‌های '\-\-section' و '\-\-environment' برای بررسی سایر دامنه‌های پیکربندی استفاده کنید\.
.TP
\fBset\fR \- مقداردهی تنظیمات OpenVox\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet config set [\-\-section SECTION_NAME] [setting_name] [setting_value]
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
مقادیر را در فایل پیکربندی \fBpuppet\.conf\fR به‌روزرسانی می‌کند\.
.IP
\fBنکات (NOTES)\fR
.IP
به‌طور پیش‌فرض، این عملیات پیکربندی را در بخش 'main' دستکاری می‌کند\. از فلگ '\-\-section' برای دستکاری سایر دامنه‌های پیکربندی استفاده کنید\.
.SH "مثال‌ها (EXAMPLES)"
\fBdelete\fR
.P
حذف تنظیم 'setting_name' از دامنه پیکربندی 'main':
.P
$ puppet config delete setting_name
.P
حذف تنظیم 'setting_name' از دامنه پیکربندی 'server':
.P
$ puppet config delete setting_name \-\-section server
.P
\fBprint\fR
.P
دریافت دایرکتوری runfile پاپت:
.P
$ puppet config print rundir
.P
دریافت فهرستی از دایرکتوری‌های مهم از پیکربندی سرور:
.P
$ puppet config print all \-\-section server | grep \-E "(path|dir)"
.P
\fBset\fR
.P
تنظیم دایرکتوری runfile پاپت:
.P
$ puppet config set rundir /var/run/puppetlabs
.P
تنظیم vardir تنها برای agent:
.P
$ puppet config set vardir /opt/puppetlabs/puppet/cache \-\-section agent
.SH "حق نشر و مجوز (COPYRIGHT AND LICENSE)"
حق نشر ۲۰۱۱ متعلق به Puppet Inc\.، Vox Pupuli با مجوز Apache 2؛ فایل COPYING را ببینید\.