.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "PUPPETCONF" "5" "January 2025" "Vox Pupuli" "OpenVox manual"
.SH "نام (NAME)"
puppet.conf \- پرونده پیکربندی اصلی پاپت
.SH "تنظیمات پیکربندی (Configuration settings)"
.IP "\(bu" 4
هر یک از این تنظیمات را می‌توان در \fBpuppet\.conf\fR یا در خط فرمان مشخص کرد\.
.IP "\(bu" 4
نسخه سازمانی پاپت (PE) و پاپت متن‌باز در تنظیمات پیکربندی مستندشده در اینجا مشترک هستند\. با این حال، مقادیر پیش‌فرض PE برای برخی تنظیمات با مقادیر پیش‌فرض متن‌باز متفاوت است، مانند \fBnode_terminus\fR، \fBstoreconfigs\fR، \fBalways_retry_plugins\fR، \fBdisable18n\fR، \fBenvironment_timeout\fR (زمانی که مدیر کد فعال است)، و تنظیم \fBmax\-active\-instances\fR مربوط به JRuby سرور پاپت\. برای بررسی پیش‌فرض‌های پیکربندی PE، پرونده \fBpuppet\.conf\fR یا \fBpe\-puppet\-server\.conf\fR را پس از نصب بررسی کنید\.
.IP "\(bu" 4
هنگام استفاده از تنظیمات بولی در خط فرمان، به جای \fB\-\-setting (true|false)\fR از \fB\-\-setting\fR و \fB\-\-no\-setting\fR استفاده کنید\. (استفاده از \fB\-\-setting false\fR منجر به خطای "Error: Could not parse application options: needless argument" می‌شود\.)
.IP "\(bu" 4
تنظیمات را می‌توان به عنوان \fB$variables\fR در سایر تنظیمات درون‌یابی کرد؛ متغیر \fB$environment\fR ویژه است، زیرا سرور اصلی پاپت به جای محیط خود، محیط هر گره عامل را درون‌یابی می‌کند\.
.IP "\(bu" 4
مقادیر چندگانه باید به صورت فهرست‌های جداشده با کاما مشخص شوند؛ چندین دایرکتوری باید با جداکننده مسیر سیستم (معمولاً دونقطه) از هم جدا شوند\.
.IP "\(bu" 4
تنظیماتی که نشان‌دهنده بازه‌های زمانی هستند باید در قالب مدت‌زمان مشخص شوند: یک عدد صحیح که بلافاصله پس از آن یکی از واحدهای 'y' (سال‌های ۳۶۵ روزه)، 'd' (روز)، 'h' (ساعت)، 'm' (دقیقه)، یا 's' (ثانیه) می‌آید\. این واحد نمی‌تواند با واحدهای دیگر ترکیب شود و در صورت حذف، به طور پیش‌فرض ثانیه در نظر گرفته می‌شود\. نمونه‌ها عبارتند از '3600' که معادل '1h' (یک ساعت) است، و '1825d' که معادل '5y' (۵ سال) است\.
.IP "\(bu" 4
اگر از تنظیم \fBsplay\fR استفاده می‌کنید، توجه داشته باشید که مدت زمان انتظار با هر بار راه‌اندازی مجدد عامل پاپت تغییر می‌کند\.
.IP "\(bu" 4
تنظیماتی که یک پرونده یا دایرکتوری منفرد دریافت می‌کنند، می‌توانند به صورت اختیاری مالک، گروه و مجوز دسترسی را برای مقدار خود تنظیم کنند: \fBrundir = $vardir/run { owner = puppet, group = puppet, mode = 644 }\fR
.IP "\(bu" 4
برنامه‌های اجرایی پاپت هر تنظیمی را که به عملکرد آن‌ها مربوط نباشد نادیده می‌گیرند\.
.IP "" 0
.P
برای جزئیات بیشتر به راهنمای پیکربندی در نشانی \fIhttps://puppet\.com/docs/puppet/latest/config_about_settings\.html\fR مراجعه کنید\.
.SS "agent_catalog_run_lockfile"
یک پرونده قفل برای نشان دادن این‌که اجرای کاتالوگ عامل پاپت در حال حاضر در حال انجام است\. این پرونده حاوی شناسه فرآیند (PID) پردازشی است که قفل اجرای کاتالوگ را در اختیار دارد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$statedir/agent_catalog_run\.lock\fR
.IP "" 0
.SS "agent_disabled_lockfile"
یک پرونده قفل برای نشان دادن این‌که اجرای عامل پاپت توسط مدیر سیستم غیرفعال شده است\. پرونده حاوی یک شیء JSON با اطلاعات وضعیت است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$statedir/agent_disabled\.lock\fR
.IP "" 0
.SS "allow_duplicate_certs"
آیا درخواست گواهی جدید مجاز است درخواست گواهی موجود را بازنویسی کند یا خیر\. در صورت تنظیم بر روی true، گواهی قدیمی باید با استفاده از \fBpuppetserver ca clean\fR پاک شود و درخواست جدید با استفاده از \fBpuppetserver ca sign\fR امضا گردد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "allow_pson_serialization"
آیا سریال‌سازی PSON مجاز باشد یا خیر\. هنگامی که پاپت قادر به سریال‌سازی به JSON یا سایر قالب‌ها نباشد، به PSON بازمی‌گردد\. این گزینه بر پاسخ‌های سرویس مدیریت پیکربندی سرور پاپت و فرآیندی که عامل توسط آن کاتالوگ حافظه پنهان خود را ذخیره می‌کند، تأثیر می‌گذارد\. با مقدار پیش‌فرض \fBfalse\fR، این گزینه در جلوگیری از دست رفتن داده‌ها مفید است زیرا داده‌های غنی نمی‌توانند از طریق PSON سریال شوند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "always_retry_plugins"
بر نحوه ذخیره تلاش‌ها برای بارگیری انواع منابع و قابلیت‌های پاپت در حافظه پنهان تأثیر می‌گذارد\. در صورت تنظیم بر روی true، فراخوانی‌های \fBPuppet\.type\.<type>?\fR و \fBPuppet\.feature\.<feature>?\fR همیشه تلاش می‌کنند نوع یا قابلیت را بارگیری کنند (که می‌تواند عملیاتی سنگین باشد) مگر این‌که قبلاً با موفقیت بارگیری شده باشد\. این امر باعث می‌شود که یک اجرای منفرد عامل بتواند به عنوان مثال بسته‌ای را نصب کند که قابلیت‌های اساسی یک نوع یا ویژگی را فراهم می‌آورد و سپس در همان اجرا آن نوع یا ویژگی را بارگیری نماید\.
.P
اگر این تنظیم بر روی false قرار گیرد، انواع و قابلیت‌ها فقط یک بار بررسی می‌شوند و اگر در دسترس نباشند، نتیجه منفی در حافظه پنهان ذخیره شده و برای تمام تلاش‌های بعدی برگردانده می‌شود\. این رفتار تقریباً همیشه برای سرور مناسب است و می‌تواند عملکرد را برای انواعی که مکرراً بررسی می‌شوند بهبود بخشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBtrue\fR
.IP "" 0
.SS "autoflush"
آیا پرونده‌های ثبت وقایع (لاگ) همیشه بلافاصله در دیسک تخلیه شوند یا خیر\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBtrue\fR
.IP "" 0
.SS "autosign"
آیا درخواست‌های گواهی به صورت خودکار امضا شوند (و چگونه)\. این تنظیم فقط روی سرور پاپتی که به عنوان مرجع صدور گواهی (CA) عمل می‌کند کاربرد دارد\.
.P
مقادیر مجاز عبارتند از true (امضای خودکار تمام درخواست‌های گواهی؛ توصیه نمی‌شود)، false (غیرفعال کردن امضای خودکار)، یا مسیر مطلق به یک پرونده\.
.P
پرونده مشخص‌شده در این تنظیم می‌تواند یک \fBپرونده پیکربندی\fR یا یک \fBبرنامه اجرایی خط‌مشی سفارشی\fR باشد\. پاپت به طور خودکار نوع آن را تشخیص می‌دهد: اگر کاربر پاپت (تنظیم \fBuser\fR را ببینید) بتواند پرونده را اجرا کند، به عنوان یک برنامه خط‌مشی در نظر گرفته می‌شود؛ در غیر این صورت، به عنوان یک پرونده پیکربندی تلقی خواهد شد\.
.P
اگر یک برنامه اجرایی خط‌مشی سفارشی پیکربندی شود، سرور CA پاپت هر بار که CSR دریافت می‌کند آن را اجرا خواهد کرد\. شناسه موضوع (Subject CN) درخواست \fIبه عنوان آرگومان خط فرمان\fR و محتویات CSR در قالب PEM \fIاز طریق ورودی استاندارد (stdin)\fR به برنامه ارسال می‌شود\. اگر گواهی باید به طور خودکار امضا شود باید با وضعیت 0 و در غیر این صورت با مقدار غیرصفر خارج شود\.
.P
اگر درخواست گواهی به طور خودکار امضا نشود، برای بازبینی باقی می‌ماند\. کاربر مدیر می‌تواند از دستور \fBpuppetserver ca sign\fR برای امضای دستی آن استفاده کند، یا درخواست را حذف نماید\.
.P
برای اطلاعات درباره پرونده‌های پیکربندی امضای خودکار، به راهنمای پرونده‌های پیکربندی پاپت در نشانی \fIhttps://puppet\.com/docs/puppet/latest/config_file_autosign\.html\fR مراجعه کنید\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$confdir/autosign\.conf\fR
.IP "" 0
.SS "basemodulepath"
مسیر جستجو برای ماژول‌های \fBسراسری\fR\. باید به صورت فهرستی از دایرکتوری‌ها با جداکننده مسیر سیستم مشخص شود (جداکننده مسیر در POSIX علامت ':' و در ویندوز ';' است)\.
.P
این‌ها ماژول‌هایی هستند که توسط \fIتمام\fR محیط‌ها استفاده خواهند شد\. توجه داشته باشید که دایرکتوری \fBmodules\fR محیط فعال بر هر دایرکتوری سراسری اولویت خواهد داشت\. برای اطلاعات بیشتر به \fIhttps://puppet\.com/docs/puppet/latest/environments_about\.html\fR مراجعه کنید\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$codedir/modules:/opt/puppetlabs/puppet/modules\fR
.IP "" 0
.SS "binder_config"
پرونده پیکربندی پیونددهنده (binder)\. پاپت این پرونده را در هر درخواست برای پیکربندی سیستم پیوندها می‌خواند\. اگر روی nil (پیش‌فرض) تنظیم شود، یک پرونده اختیاری $confdir/binder_config\.yaml بارگیری می‌شود\. اگر وجود نداشته باشد، از پیکربندی پیش‌فرض استفاده می‌شود\. اگر تنظیم :binding_config مشخص شود، باید به یک پرونده معتبر و موجود yaml اشاره کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: ``
.IP "" 0
.SS "bucketdir"
محل ذخیره پرونده‌های FileBucket\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$vardir/bucket\fR
.IP "" 0
.SS "ca_fingerprint"
اثر انگشت (فینگرپرینت) مورد انتظار گواهی CA\. در صورت مشخص شدن، عامل اثر انگشت گواهی CA دانلودی را با این مقدار مقایسه کرده و در صورت عدم تطابق آن را رد می‌کند\. این فقط در طول اولین دانلود گواهی CA اعمال می‌شود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: ``
.IP "" 0
.SS "ca_name"
نام مورد استفاده برای گواهی مرجع صدور گواهی (CA)\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBPuppet CA: $certname\fR
.IP "" 0
.SS "ca_port"
درگاه (پورت) مورد استفاده برای مرجع صدور گواهی\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$serverport\fR
.IP "" 0
.SS "ca_refresh_interval"
فاصله زمانی تازه‌سازی گواهی‌های CA محلی توسط عامل پاپت\. به طور پیش‌فرض، گواهی‌های CA هر ۲۴ ساعت تازه‌سازی می‌شوند\. اگر فاصله دیگری مشخص شود، چنانچه زمان سپری‌شده از آخرین تازه‌سازی از مدت مشخص‌شده فراتر رود، عامل گواهی‌های CA خود را در اجرای بعدی تازه‌سازی می‌کند\.
.P
به طور کلی، این فاصله باید بیشتر از مقدار \fBruninterval\fR باشد\. تنظیم مقدار \fBca_refresh_interval\fR بر روی 0 یا مقداری برابر یا کمتر از \fBruninterval\fR باعث می‌شود گواهی‌های CA در هر اجرا تازه‌سازی شوند\.
.P
اگر عامل گواهی‌های جدید CA را دانلود کند، از آن‌ها برای درخواست‌های شبکه بعدی استفاده می‌کند\. اگر درخواست تازه‌سازی ناموفق باشد یا گواهی‌های CA روی سرور تغییری نکرده باشند، اجرای عامل با همان گواهی‌های CA محلی فعلی ادامه می‌یابد\. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB1d\fR
.IP "" 0
.SS "ca_server"
سرور مورد استفاده برای درخواست‌های مرجع صدور گواهی\. این یک سرور مجزا است زیرا نمی‌تواند و نیازی ندارد که به صورت افقی مقیاس‌پذیر شود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$server\fR
.IP "" 0
.SS "ca_ttl"
مدت زمان اعتبار پیش‌فرض (TTL) برای گواهی‌های جدید\. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB5y\fR
.IP "" 0
.SS "cacert"
گواهی مرجع صدور گواهی (CA)\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$cadir/ca_crt\.pem\fR
.IP "" 0
.SS "cacrl"
فهرست ابطال گواهی (CRL) برای مرجع صدور گواهی\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$cadir/ca_crl\.pem\fR
.IP "" 0
.SS "cadir"
دایرکتوری ریشه برای مرجع صدور گواهی\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB/etc/puppetlabs/puppetserver/ca\fR
.IP "" 0
.SS "cakey"
کلید خصوصی مرجع صدور گواهی (CA)\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$cadir/ca_key\.pem\fR
.IP "" 0
.SS "capub"
کلید عمومی مرجع صدور گواهی (CA)\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$cadir/ca_pub\.pem\fR
.IP "" 0
.SS "catalog_cache_terminus"
نحوه ذخیره‌سازی کاتالوگ‌های در حافظه پنهان\. مقادیر معتبر عبارتند از 'json'، 'msgpack' و 'yaml'\. برنامه عامل به طور پیش‌فرض از 'json' استفاده می‌کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: ``
.IP "" 0
.SS "catalog_terminus"
محل دریافت کاتالوگ‌های گره‌ها\. این تنظیم زمانی مفید است که برای نمونه بخواهید کاتالوگ‌ها را از پیش کامپایل کرده و در memcached یا مخزن دیگری با دسترسی سریع ذخیره کنید\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBcompiler\fR
.IP "" 0
.SS "cert_inventory"
پرونده سیاهه گواهی‌ها\. این یک پرونده متنی است که CA در آن فهرست کاملی از تمام گواهی‌ها را می‌نویسد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$cadir/inventory\.txt\fR
.IP "" 0
.SS "certdir"
دایرکتوری گواهی‌ها\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$ssldir/certs\fR
.IP "" 0
.SS "certificate_revocation"
آیا بررسی ابطال گواهی فعال باشد و چه سطحی از بررسی انجام گیرد\.
.P
هنگامی که بررسی ابطال گواهی فعال است، پاپت انتظار دارد محتوای CRL آن یک یا چند CRL با کدگذاری PEM باشد که به هم متصل شده‌اند\. هنگام استفاده از بسته گواهی، CRLهای تمام CAها در زنجیره اعتماد باید در پرونده crl گنجانده شوند\. زنجیره باید از کمترین تا معتبرترین مرتب شود، به طوری که اولین CRL برای ریشه زنجیره و آخرین برای CA برگ باشد\.
.P
هنگامی که certificate_revocation بر روی 'true' یا 'chain' تنظیم شود، پاپت اطمینان حاصل می‌کند که هیچ‌یک از CAها در زنجیره اعتماد توسط CA صادرکننده‌شان ابطال نشده باشند\.
.P
هنگامی که بر روی 'leaf' تنظیم شود، پاپت گواهی‌ها را در برابر فهرست ابطال CA صادرکننده بررسی می‌کند، اما وضعیت ابطال CA صادرکننده یا سطوح بالاتر در زنجیره اعتماد را بررسی نمی‌کند\.
.P
هنگامی که بر روی 'false' تنظیم شود، تمام بررسی‌های ابطال گواهی غیرفعال شده و تلاشی برای دانلود CRL انجام نمی‌شود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBchain\fR
.IP "" 0
.SS "certname"
نام مورد استفاده هنگام رسیدگی به گواهی‌ها\. هنگامی که گره‌ای از سرور CA پاپت درخواست گواهی می‌کند، از مقدار تنظیم \fBcertname\fR به عنوان Subject CN درخواستی خود استفاده می‌نماید\.
.P
این نامی است که هنگام مدیریت مجوزهای گره در auth\.conf سرور پاپت در نشانی \fIhttps://puppet\.com/docs/puppetserver/latest/config_file_auth\.html\fR استفاده می‌شود\. در بیشتر موارد، همچنین به عنوان نام گره هنگام تطبیق تعاریف گره در \fIhttps://puppet\.com/docs/puppet/latest/lang_node_definitions\.html\fR و درخواست داده از ENC به کار می‌رود\.
.P
نام گواهی گره در مانیفست‌های پاپت به صورت \fB$trusted['certname']\fR در دسترس است (برای جزئیات بیشتر به Facts and Built\-In Variables در \fIhttps://puppet\.com/docs/puppet/latest/lang_facts_and_builtin_vars\.html\fR مراجعه کنید)\.
.IP "\(bu" 4
برای بهترین سازگاری، مقدار \fBcertname\fR را فقط به حروف کوچک، اعداد، نقطه، زیرخط و خط تیره محدود کنید (یعنی با \fB/A[a\-z0\-9\._\-]+Z/\fR مطابقت داشته باشد)\.
.IP "\(bu" 4
مقدار ویژه \fBca\fR رزرو شده است و نمی‌تواند به عنوان certname برای یک گره معمولی استفاده شود\.
.IP
\fBنکته:\fR باید certname را در بخش main پرونده puppet\.conf تنظیم کنید\. تنظیم آن در بخش دیگر باعث بروز خطا می‌شود\.
.IP "" 0
.P
پیش‌فرض به نام دامنه کاملاً واجد شرایط (FQDN) گره تنظیم می‌شود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBthe Host's fully qualified domain name, as determined by Facter\fR
.IP "" 0
.SS "ciphers"
فهرست مجموعه‌های رمزنگاری (ciphersuites) برای اتصالات TLS برقرارشده توسط پاپت\. مقدار پیش‌فرض برای پشتیبانی از TLS 1\.0 به بالا انتخاب شده است، اما در صورت نیاز می‌توان آن را محدودتر کرد\. مجموعه‌های رمزنگاری باید در قالب OpenSSL مشخص شوند، نه IANA\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBECDHE\-ECDSA\-AES128\-GCM\-SHA256:ECDHE\-RSA\-AES128\-GCM\-SHA256:ECDHE\-ECDSA\-AES256\-GCM\-SHA384:ECDHE\-RSA\-AES256\-GCM\-SHA384:ECDHE\-ECDSA\-CHACHA20\-POLY1305:ECDHE\-RSA\-CHACHA20\-POLY1305:DHE\-RSA\-AES128\-GCM\-SHA256:DHE\-RSA\-AES256\-GCM\-SHA384:DHE\-RSA\-CHACHA20\-POLY1305:ECDHE\-ECDSA\-AES128\-SHA256:ECDHE\-RSA\-AES128\-SHA256:ECDHE\-ECDSA\-AES128\-SHA:ECDHE\-RSA\-AES128\-SHA:ECDHE\-ECDSA\-AES256\-SHA384:ECDHE\-RSA\-AES256\-SHA384:ECDHE\-ECDSA\-AES256\-SHA:ECDHE\-RSA\-AES256\-SHA:DHE\-RSA\-AES128\-SHA256:DHE\-RSA\-AES256\-SHA256:AES128\-GCM\-SHA256:AES256\-GCM\-SHA384:AES128\-SHA256:AES256\-SHA256\fR
.IP "" 0
.SS "classfile"
پرونده‌ای که عامل پاپت فهرستی از کلاس‌های مرتبط با پیکربندی دریافت‌شده را در آن ذخیره می‌کند\. می‌تواند در برنامه اجرایی مجزای \fBpuppet\fR با استفاده از گزینه \fB\-\-loadclasses\fR بارگیری شود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$statedir/classes\.txt\fR
.IP "" 0
.SS "client_datadir"
دایرکتوری‌ای که داده‌های سریال‌شده در آن بر روی کلاینت ذخیره می‌شوند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$vardir/client_data\fR
.IP "" 0
.SS "clientbucketdir"
محل ذخیره محلی پرونده‌های FileBucket\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$vardir/clientbucket\fR
.IP "" 0
.SS "clientyamldir"
دایرکتوری‌ای که داده‌های YAML سمت کلاینت در آن ذخیره می‌شوند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$vardir/client_yaml\fR
.IP "" 0
.SS "code"
کد برای تجزیه مستقیم\. این اساساً فقط توسط \fBpuppet\fR استفاده می‌شود و فقط در صورتی باید تنظیم شود که برنامه اجرایی پاپت اختصاصی خود را می‌نویسید\.
.SS "codedir"
دایرکتوری اصلی کد پاپت\. پیش‌فرض این تنظیم بر اساس کاربر محاسبه می‌شود\. اگر فرآیند به عنوان root یا کاربری که پاپت باید تحت آن اجرا شود در حال اجرا باشد، به یک دایرکتوری سیستمی پیش‌فرض می‌شود، اما اگر تحت هر کاربر دیگری اجرا شود، در دایرکتوری خانگی کاربر قرار می‌گیرد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBUnix/Linux: /etc/puppetlabs/code \-\- Windows: C:\eProgramData\ePuppetLabs\ecode \-\- Non\-root user: ~/\.puppetlabs/etc/code\fR
.IP "" 0
.SS "color"
آیا هنگام ثبت وقایع در کنسول از رنگ‌ها استفاده شود یا خیر\. مقادیر معتبر عبارتند از \fBansi\fR (معادل \fBtrue\fR)، \fBhtml\fR و \fBfalse\fR که هیچ رنگی تولید نمی‌کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBansi\fR
.IP "" 0
.SS "confdir"
دایرکتوری اصلی پیکربندی پاپت\. پیش‌فرض این تنظیم بر اساس کاربر محاسبه می‌شود\. اگر فرآیند به عنوان root یا کاربری که پاپت باید تحت آن اجرا شود اجرا شود، به دایرکتوری سیستمی پیش‌فرض می‌شود، اما اگر تحت هر کاربر دیگری اجرا شود، در دایرکتوری خانگی کاربر خواهد بود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBUnix/Linux: /etc/puppetlabs/puppet \-\- Windows: C:\eProgramData\ePuppetLabs\epuppet\eetc \-\- Non\-root user: ~/\.puppetlabs/etc/puppet\fR
.IP "" 0
.SS "config"
پرونده پیکربندی برای برنامه کاربردی جاری پاپت\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$confdir/${config_file_name}\fR
.IP "" 0
.SS "config_file_name"
نام پرونده پیکربندی پاپت\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBpuppet\.conf\fR
.IP "" 0
.SS "config_version"
نحوه تعیین نسخه پیکربندی\. به طور پیش‌فرض، زمانی خواهد بود که پیکربندی تجزیه می‌شود، اما می‌توانید یک اسکریپت شل ارائه دهید تا نحوه تعیین نسخه را بازنویسی کند\. خروجی این اسکریپت به هر پیام ثبت وقایع در گزارش‌ها افزوده می‌شود و به شما امکان می‌دهد تغییرات روی میزبان‌های خود را با نسخه مبدأ روی سرور مرتبط سازید\.
.P
تنظیم مقدار سراسری برای config_version در puppet\.conf مجاز نیست (اما می‌توان آن را از خط فرمان بازنویسی کرد)\. لطفاً به جای آن یک مقدار به ازای هر محیط در environment\.conf تنظیم کنید\. برای اطلاعات بیشتر به \fIhttps://puppet\.com/docs/puppet/latest/environments_about\.html\fR مراجعه کنید\.
.SS "configprint"
مقدار یک تنظیم پیکربندی خاص را چاپ می‌کند\. اگر نام یک تنظیم برای این گزینه ارائه شود، مقدار آن چاپ شده و پاپت خارج می‌شود\. برای مقادیر چندگانه از کاما استفاده کنید\. برای فهرستی از تمام مقادیر، 'all' را مشخص نمایید\. این تنظیم منسوخ شده است و دستور 'puppet config' جایگزین این قابلیت شده است\.
.SS "crl_refresh_interval"
فاصله زمانی تازه‌سازی فهرست ابطال گواهی (CRL) محلی توسط عامل پاپت\. به طور پیش‌فرض، CRL هر ۲۴ ساعت تازه‌سازی می‌شود\. اگر فاصله متفاوتی مشخص شود، چنانچه زمان سپری‌شده از آخرین تازه‌سازی از مقدار مشخص‌شده بیشتر باشد، عامل در اجرای بعدی پاپت CRL خود را تازه‌سازی می‌کند\.
.P
به طور کلی، این فاصله باید بیشتر از مقدار \fBruninterval\fR باشد\. تنظیم \fBcrl_refresh_interval\fR بر روی 0 یا مقداری برابر یا کمتر از \fBruninterval\fR باعث می‌شود CRL در هر بار اجرا تازه‌سازی شود\.
.P
اگر عامل CRL جدیدی دانلود کند، از آن برای درخواست‌های شبکه بعدی استفاده خواهد کرد\. اگر درخواست تازه‌سازی با شکست مواجه شود یا CRL روی سرور تغییری نکرده باشد، اجرای عامل با CRL محلی فعلی ادامه می‌یابد\. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB1d\fR
.IP "" 0
.SS "csr_attributes"
یک پرونده اختیاری حاوی ویژگی‌های سفارشی برای افزودن به درخواست‌های امضای گواهی (CSR)\. باید مطمئن شوید این پرونده روی سرور CA پاپت شما وجود نداشته باشد؛ در صورت وجود، ممکن است پسوندهای ناخواسته گواهی به گواهی‌های ایجادشده با دستور \fBpuppetserver ca generate\fR نفوذ کنند\.
.P
در صورت وجود، این پرونده باید یک درهم‌سازی YAML حاوی کلید \fBcustom_attributes\fR و/یا کلید \fBextension_requests\fR باشد\. مقدار هر کلید باید یک درهم‌سازی باشد که هر کلید آن یک OID معتبر و هر مقدار شیئی قابل تبدیل به رشته باشد\.
.P
ویژگی‌های سفارشی می‌توانند توسط CA هنگام تصمیم‌گیری برای امضای گواهی استفاده شوند، اما پس از آن کنار گذاشته می‌شوند\. OID ویژگی‌ها می‌تواند هر مقدار OID به جز ویژگی‌های استاندارد CSR (یعنی ویژگی‌های شرح‌داده‌شده در RFC 2985 بخش ۵\.۴) باشد\. این امر برای تعبیه کلید از پیش اشتراک‌گذاری‌شده برای برنامه‌های خط‌مشی امضای خودکار مفید است (تنظیم \fBautosign\fR را ببینید)، که اغلب با استفاده از OID با شناسه \fB1\.2\.840\.113549\.1\.9\.7\fR انجام می‌گیرد\.
.P
درخواست‌های پسوند به طور دائم در گواهی نهایی تعبیه خواهند شد\. OIDهای پسوند باید در شاخه‌های OID مربوط به "ppRegCertExt" (\fB1\.3\.6\.1\.4\.1\.34380\.1\.1\fR)، "ppPrivCertExt" (\fB1\.3\.6\.1\.4\.1\.34380\.1\.2\fR)، یا "ppAuthCertExt" (\fB1\.3\.6\.1\.4\.1\.34380\.1\.3\fR) باشند\. شاخه ppRegCertExt برای چهار مورد از رایج‌ترین داده‌ها برای تعبیه رزرو شده است: \fBpp_uuid\fR (\fB\.1\fR)، \fBpp_instance_id\fR (\fB\.2\fR)، \fBpp_image_name\fR (\fB\.3\fR)، و \fBpp_preshared_key\fR (\fB\.4\fR) \-\- در پرونده YAML می‌توان به جای OID کامل به این موارد با نام‌های توصیفی کوتاه اشاره کرد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$confdir/csr_attributes\.yaml\fR
.IP "" 0
.SS "csrdir"
محل ذخیره درخواست‌های گواهی توسط CA\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$cadir/requests\fR
.IP "" 0
.SS "daemonize"
آیا فرآیند به پس‌زمینه فرستاده شود (دیمن شود) یا خیر\. این گزینه در سیستم‌های POSIX به طور پیش‌فرض true و در ویندوز (که پاپت فعلاً نمی‌تواند دیمن شود) false است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBtrue\fR
.IP "" 0
.SS "data_binding_terminus"
این تنظیم منسوخ شده است\. هر مقداری به جز 'hiera' باید در hiera\.yaml نسخه ۵ پیکربندی شود\. تا زمان حذف این تنظیم، کنترل می‌کند که از کدام پایانه پیوند داده برای پیوند داده‌های خودکار سراسری (در تمام محیط‌ها) استفاده شود\. به طور پیش‌فرض این مقدار 'hiera' است\. مقدار 'none' پیوند سراسری را خاموش می‌کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBhiera\fR
.IP "" 0
.SS "default_file_terminus"
مبدأ پیش‌فرض برای پرونده‌ها در صورتی که سروری در URI مشخص نشده باشد، مانند puppet:///file\. پیش‌فرض \fBrest\fR باعث می‌شود پرونده با استفاده از تنظیم \fBserver\fR دریافت شود\. هنگام اجرای \fBapply\fR پیش‌فرض \fBfile_server\fR است که باعث می‌شود درخواست‌ها به صورت محلی برآورده شوند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBrest\fR
.IP "" 0
.SS "default_manifest"
مانیفست اصلی پیش‌فرض برای محیط‌های دایرکتوری\. هر محیطی که تنظیم \fBmanifest\fR را در پرونده \fBenvironment\.conf\fR خود مشخص نکرده باشد از این مانیفست استفاده خواهد کرد\.
.P
مقدار این تنظیم می‌تواند یک مسیر مطلق یا نسبی باشد\. یک مسیر مطلق باعث می‌شود همه محیط‌ها به طور پیش‌فرض از یک مانیفست اصلی استفاده کنند؛ یک مسیر نسبی به هر محیط اجازه می‌دهد از مانیفست خود استفاده کند و پاپت مسیر را نسبت به دایرکتوری اصلی هر محیط حل خواهد کرد\.
.P
در هر دو حالت، مسیر می‌تواند به یک پرونده منفرد یا دایرکتوری‌ای از مانیفست‌ها اشاره کند که به ترتیب الفبایی ارزیابی می‌شوند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB\./manifests\fR
.IP "" 0
.SS "default_schedules"
بولی؛ آیا منابع زمان‌بندی پیش‌فرض ایجاد شوند یا خیر\. تنظیم این مقدار بر روی false برای تمیز نگه داشتن پردازنده‌های گزارش خارجی از منابع زمان‌بندی نادیده گرفته شده مفید است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBtrue\fR
.IP "" 0
.SS "deviceconfdir"
دایرکتوری ریشه $confdir دستگاه‌ها\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$confdir/devices\fR
.IP "" 0
.SS "deviceconfig"
مسیر به پرونده پیکربندی دستگاه برای puppet device\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$confdir/device\.conf\fR
.IP "" 0
.SS "devicedir"
دایرکتوری ریشه $vardir دستگاه‌ها\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$vardir/devices\fR
.IP "" 0
.SS "diff"
دستور diff مورد استفاده هنگام چاپ تفاوت‌های بین پرونده‌ها\. این تنظیم در ویندوز مقدار پیش‌فرضی ندارد، زیرا \fBdiff\fR استاندارد در دسترس نیست، اما پاپت می‌تواند از ابزارهای diff متفرقه استفاده کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBdiff\fR
.IP "" 0
.SS "diff_args"
آرگومان‌هایی که هنگام چاپ تفاوت بین پرونده‌ها به دستور diff ارسال می‌شوند\. دستور مورد استفاده را می‌توان با تنظیم \fBdiff\fR انتخاب کرد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB\-u\fR
.IP "" 0
.SS "digest_algorithm"
الگوریتم خلاصه‌سازی (دایجِست) مورد استفاده برای منابع پرونده و filebucket\. مقادیر معتبر عبارتند از sha256، sha384، sha512، sha224 و md5\. پیش‌فرض sha256 است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBsha256\fR
.IP "" 0
.SS "disable_i18n"
اگر true باشد، تمام ترجمه‌های پیام‌های ثبت وقایع پاپت و ماژول‌ها خاموش می‌شود، که بر پیام‌های خطای لاگ، هشدار، اطلاعات، و هرگونه ترجمه در گزارش و خط فرمان تأثیر می‌گذارد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBtrue\fR
.IP "" 0
.SS "disable_per_environment_manifest"
آیا مانیفست اصلی مخصوص یک محیط ممنوع شود یا خیر\. هنگام تنظیم بر روی \fBtrue\fR، پاپت از مانیفست مشخص‌شده در تنظیم \fBdefault_manifest\fR برای تمام محیط‌ها استفاده می‌کند\. اگر محیطی مانیفست اصلی متفاوتی را در پرونده \fBenvironment\.conf\fR خود تعیین کند، درخواست‌های کاتالوگ برای آن محیط با خطا مواجه می‌شوند\.
.P
این تنظیم مستلزم این است که \fBdefault_manifest\fR روی یک مسیر مطلق تنظیم شده باشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "disable_warnings"
فهرستی از انواع هشدارهای جداشده با کاما برای سرکوب کردن\. اگر تعداد زیادی از هشدارها لاگ‌های پاپت را بیش از حد بزرگ یا غیرقابل استفاده می‌کند، می‌توانید موقتاً با این تنظیم آن‌ها را بی‌صدا کنید\.
.P
اگر در حال آماده شدن برای ارتقای پاپت به یک نسخه اصلی جدید هستید، باید مدتی همه هشدارها را مجدداً فعال کنید\.
.P
مقادیر معتبر برای این تنظیم عبارتند از:
.IP "\(bu" 4
\fBdeprecations\fR \-\- هشدارهای منسوخ شدن را غیرفعال می‌کند\.
.IP "\(bu" 4
\fBundefined_variables\fR \-\- هشدارهای مربوط به متغیرهای ناموجود را غیرفعال می‌کند\.
.IP "\(bu" 4
\fBundefined_resources\fR \-\- هشدارهای مربوط به منابع ناموجود را غیرفعال می‌کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB[]\fR
.IP "" 0
.SS "dns_alt_names"
فهرستی از نام‌های جایگزین DNS برای سرور پاپت که با کاما از هم جدا شده‌اند\. این‌ها نام‌های میزبان اضافی (علاوه بر \fBcertname\fR آن) هستند که سرور مجاز است هنگام سرویس‌دهی به عامل‌ها از آن‌ها استفاده کند\. پاپت هنگام ایجاد خودکار گواهی برای عامل یا سرور پاپت این تنظیم را بررسی می‌کند\. این مقادیر می‌توانند IP یا DNS باشند، و نوع باید مشخص شده و دونقطه به دنبال آن بیاید\. ورودی‌های بدون نوع به طور پیش‌فرض DNS در نظر گرفته می‌شوند\.
.P
به منظور پاسخگویی به درخواست‌های عامل در یک نام میزبان مشخص (مانند "puppet\.example\.com")، سرور پاپت به گواهی نیاز دارد که ثابت کند مجاز به استفاده از آن نام است؛ اگر سروری گواهی ارائه دهد که شامل نام میزبان آن نباشد، عامل‌های پاپت از اعتماد به آن خودداری می‌کنند\. اگر از یک نام میزبان برای ترافیک پاپت استفاده می‌کنید اما آن را روی چندین سرور پاپت متعادل‌سازی بار (load\-balance) می‌کنید، هر یک از آن سرورها باید نام میزبان رسمی را در فهرست نام‌های اضافی خود بگنجانند\.
.P
\fBنکته:\fR فهرست نام‌های جایگزین هنگام امضای گواهی سرور قفل می‌شود\. اگر بعداً نیاز به تغییر فهرست داشته باشید، نمی‌توانید فقط این تنظیم را تغییر دهید؛ همچنین باید گواهی را دوباره تولید کنید\. برای اطلاعات بیشتر به نشانی \fIhttps://puppet\.com/docs/puppet/latest/ssl_regenerate_certificates\.html\fR مراجعه کنید\.
.P
برای مشاهده تمام نام‌های جایگزینی که سرورهای شما استفاده می‌کنند، به سرور CA خود وارد شوید و دستور \fBpuppetserver ca list \-\-all\fR را اجرا کنید، سپس خروجی را برای \fB(alt names: \|\.\|\.\|\.)\fR بررسی نمایید\. بیشتر گره‌های عامل نباید نام‌های جایگزین داشته باشند؛ تنها گواهی‌هایی که باید آن‌ها را داشته باشند گره‌های سرور پاپت هستند که می‌خواهید سایر عامل‌ها به آن‌ها اعتماد کنند\.
.SS "document_all"
آیا هنگام استفاده از \fBpuppet doc\fR برای تولید مستندات مانیفست، تمام منابع مستندسازی شوند یا خیر\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "environment"
محیطی که پاپت در آن در حال اجرا است\. برای کلاینت‌ها، مانند \fBpuppet agent\fR، این خود محیط را تعیین می‌کند که پاپت برای یافتن ماژول‌ها و موارد دیگر از آن استفاده می‌نماید\. برای سرورها، مانند \fBpuppet server\fR، این محیط پیش‌فرض را برای گره‌هایی که پاپت چیزی درباره آن‌ها نمی‌داند فراهم می‌کند\.
.P
هنگام تعریف یک محیط در بخش \fB[agent]\fR، این به محیطی اشاره دارد که عامل از سرور اصلی درخواست می‌کند\. نیازی نیست که محیط در سیستم پرونده محلی وجود داشته باشد زیرا عامل آن را از سرور اصلی واکشی می‌کند\. این تعریف هنگام اجرای \fBpuppet agent\fR استفاده می‌شود\.
.P
هنگامی که در بخش \fB[user]\fR تعریف شود، محیط به مسیری اشاره دارد که پاپت برای جستجوی کد و ماژول‌های مربوط به اجرای خود از آن استفاده می‌کند\. این مستلزم آن است که محیط به صورت محلی در سیستم پرونده‌ای که پاپت در آن اجرا می‌شود وجود داشته باشد\. دستورات فرعی پاپت، از جمله \fBpuppet module\fR و \fBpuppet apply\fR، از این تعریف استفاده می‌کنند\.
.P
با توجه به این‌که زمینه و اثرات بسته به بخش پیکربندی \fIhttps://puppet\.com/docs/puppet/latest/config_file_main\.html#config\-sections\fR که تنظیم \fBenvironment\fR در آن تعریف شده متفاوت است، آن را به صورت سراسری تنظیم نکنید\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBproduction\fR
.IP "" 0
.SS "environment_data_provider"
نام ارائه‌دهنده داده‌های محیطی ثبت‌شده که هنگام به‌دست آوردن داده‌های خاص محیط استفاده می‌شود\. سه ارائه‌دهنده داخلی و ثبت‌شده عبارتند از 'none' (بدون داده)، 'function' (داده‌های به‌دست آمده از فراخوانی تابع 'environment::data()') و 'hiera' (داده‌های به‌دست آمده با استفاده از ارائه‌دهنده داده پیکربندی‌شده با پرونده hiera\.yaml در ریشه محیط)\. سایر ارائه‌دهندگان داده‌های محیط ممکن است در ماژول‌های موجود در مسیر ماژول ثبت شوند\. این تنظیم منسوخ شده است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: ``
.IP "" 0
.SS "environment_timeout"
چه مدت سرور پاپت باید داده‌هایی را که از یک محیط بارگیری می‌کند در حافظه پنهان نگه دارد\.
.P
مقدار \fB0\fR ذخیره‌سازی در حافظه پنهان را غیرفعال می‌کند\. این تنظیم همچنین می‌تواند روی \fBunlimited\fR تنظیم شود که محیط‌ها را تا زمان راه‌اندازی مجدد سرور یا دستور تازه‌سازی حافظه پنهان ذخیره می‌کند\. سایر مقادیر باعث می‌شوند سرور پاپت محیط‌هایی را که در طول \fBenvironment_timeout\fR ثانیه گذشته استفاده نشده‌اند، از حافظه پنهان خارج کند\.
.P
هنگامی که استقرار پاپت شما کارهای غیربدیهی انجام می‌دهد، باید این تنظیم را تغییر دهید\. مقدار پیش‌فرض \fB0\fR انتخاب شده است زیرا به کاربران جدید اجازه می‌دهد بدون مراحل اضافی کد خود را به‌روزرسانی کنند، اما عملکرد سرور پاپت شما را کاهش می‌دهد\. توصیه می‌کنیم یکی از این دو کار را انجام دهید:
.IP "\(bu" 4
این مقدار را روی \fBunlimited\fR قرار دهید و به عنوان بخشی از فرآیند استقرار کد، سرور پاپت خود را به صراحت تازه‌سازی کنید\.
.IP "\(bu" 4
این مقدار را روی عددی تنظیم کنید که فعال‌ترین محیط‌های مورد استفاده شما را در حافظه پنهان نگه دارد، اما به محیط‌های آزمایشی اجازه دهد از حافظه پنهان خارج شوند تا مصرف حافظه کاهش یابد\. مقدار ۳ دقیقه (3m) مقداری معقول است\.
.IP "" 0
.P
هنگامی که \fBenvironment_timeout\fR را روی یک مقدار غیرصفر تنظیم کردید، پس از استقرار کد جدید باید با استفاده از نقطه پایانی API به نام \fBenvironment\-cache\fR به سرور پاپت بگویید کد جدید را از دیسک بخواند\. به مستندات API مدیریتی سرور پاپت در نشانی \fIhttps://puppet\.com/docs/puppetserver/latest/admin\-api/v1/environment\-cache\.html\fR مراجعه کنید\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB0\fR
.IP "" 0
.SS "environmentpath"
مسیر جستجو برای محیط‌های دایرکتوری، به صورت فهرستی از دایرکتوری‌ها که با نویسه جداکننده مسیر سیستم از هم جدا شده‌اند (جداکننده POSIX علامت ':' و ویندوز ';' است)\.
.P
این تنظیم باید مقداری داشته باشد تا \fBمحیط‌های دایرکتوری\fR فعال شوند\. مقدار توصیه‌شده \fB$codedir/environments\fR است\. برای جزئیات بیشتر به \fIhttps://puppet\.com/docs/puppet/latest/environments_about\.html\fR مراجعه کنید\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$codedir/environments\fR
.IP "" 0
.SS "evaltrace"
آیا هر منبع هنگام ارزیابی شدن باید گزارش ثبت کند یا خیر\. این به شما امکان می‌دهد دقیقاً آنچه را که انجام می‌شود به صورت تعاملی مشاهده کنید\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "exclude_unchanged_resources"
نحوه فهرست شدن منابع تغییرنیافته در گزارش‌ها را مشخص می‌کند\. در صورت تنظیم بر روی \fBtrue\fR، منابعی که پس از اعمال کاتالوگ تغییری نداشته‌اند، به‌روزرسانی وضعیت منبع تغییرنیافته مربوطه در گزارش فهرست نخواهد شد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBtrue\fR
.IP "" 0
.SS "external_nodes"
اسکریپت دسته‌بندی‌کننده خارجی گره (ENC) برای استفاده از داده‌های گره\. پاپت این داده‌ها را با مانیفست اصلی ترکیب می‌کند تا کاتالوگ‌های گره را تولید کند\.
.P
برای فعال کردن این تنظیم، تنظیم \fBnode_terminus\fR را روی \fBexec\fR قرار دهید\.
.P
مقدار این تنظیم باید مسیر یک دستور اجرایی باشد که بتواند اطلاعات گره را تولید کند\. این دستور باید:
.IP "\(bu" 4
نام یک گره را به عنوان آرگومان خط فرمان دریافت کند\.
.IP "\(bu" 4
یک درهم‌سازی YAML با حداکثر سه کلید برگرداند:
.IP "\(bu" 4
\fBclasses\fR \-\- فهرستی از کلاس‌ها، به صورت آرایه یا درهم‌سازی\.
.IP "\(bu" 4
\fBenvironment\fR \-\- یک رشته\.
.IP "\(bu" 4
\fBparameters\fR \-\- فهرستی از متغیرهای دامنه سطح بالا برای تنظیم، به صورت درهم‌سازی\.
.IP "" 0
.IP "\(bu" 4
برای گره‌های ناشناخته، با کد خروج غیرصفر خارج شود\.
.IP "" 0
.P
به طور کلی، یک اسکریپت ENC درخواست‌هایی را به یک منبع داده خارجی ارسال می‌کند\.
.P
برای اطلاعات بیشتر، به مستندات ENC در \fIhttps://puppet\.com/docs/puppet/latest/nodes_external\.html\fR مراجعه کنید\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBnone\fR
.IP "" 0
.SS "fact_name_length_soft_limit"
حد نرم برای طول نام یک واقعیت (فکت)\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB2560\fR
.IP "" 0
.SS "fact_value_length_soft_limit"
حد نرم برای طول مقدار یک واقعیت (فکت)\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB4096\fR
.IP "" 0
.SS "factpath"
محل جستجوی واقعیت‌ها (فکت‌ها) توسط پاپت\. چندین دایرکتوری باید با نویسه جداکننده مسیر سیستم از هم جدا شوند (جداکننده POSIX علامت ':' و ویندوز ';' است)\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$vardir/lib/facter:$vardir/facts\fR
.IP "" 0
.SS "facts_terminus"
پایانه واقعیت‌های گره\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfacter\fR
.IP "" 0
.SS "fileserverconfig"
محل ذخیره پیکربندی پرونده‌سرور (fileserver)\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$confdir/fileserver\.conf\fR
.IP "" 0
.SS "filetimeout"
حداقل زمان انتظار بین بررسی به‌روزرسانی‌ها در پرونده‌های پیکربندی\. این مهلت زمانی تعیین می‌کند که پاپت با چه سرعتی تغییر پرونده‌ها (مانند مانیفست‌ها یا puppet\.conf) روی دیسک را بررسی کند\. برای بازخوانی پرونده‌ها در یک محیط در سرور پاپت، لطفاً از نقطه پایانی environment_cache استفاده کنید\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB15s\fR
.IP "" 0
.SS "forge_authorization"
کلید مجوز برای اتصال به Puppet Forge\. برای اتصالات غیرمجاز یا مبتنی بر مجوز خالی بگذارید\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: ``
.IP "" 0
.SS "freeze_main"
کلاس 'main' را مسدود می‌کند و اجازه نمی‌دهد هیچ کدی به آن اضافه شود\. این اساساً به این معنی است که شما نمی‌توانید کدی خارج از گره، کلاس یا تعریفی به جز در مانیفست سایت داشته باشید\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "genconfig"
در صورت true بودن، باعث می‌شود برنامه‌های پاپت یک پرونده پیکربندی نمونه را در خروجی استاندارد چاپ کرده و خارج شوند\. این نمونه شامل توضیحات هر تنظیم و مقدار فعلی (یا پیش‌فرض) آن با اعمال تنظیمات بازنویسی‌شده در CLI خواهد بود\. این تنظیم فقط زمانی معنا دارد که در خط فرمان به عنوان \fB\-\-genconfig\fR مشخص شود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "genmanifest"
آیا فقط یک مانیفست در خروجی استاندارد چاپ شود و خارج گردد یا خیر\. فقط زمانی معنا دارد که در خط فرمان به عنوان \fB\-\-genmanifest\fR مشخص شود\. آرگومان‌های مشخص‌شده در CLI را لحاظ می‌کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "graph"
آیا پرونده‌های نمودار \.dot ایجاد شوند یا خیر، که به شما امکان می‌دهد روابط وابستگی و مهار را در کاتالوگ پاپت تجسم کنید\. می‌توانید این پرونده‌ها را با ابزارهایی مانند OmniGraffle در نشانی \fIhttp://www\.omnigroup\.com/applications/omnigraffle\fR یا graphviz در \fIhttp://www\.graphviz\.org\fR مشاهده کنید\.
.P
پرونده‌های نمودار هنگام \fIاعمال\fR کاتالوگ ایجاد می‌شوند، بنابراین این تنظیم باید در گره‌هایی که \fBpuppet agent\fR یا \fBpuppet apply\fR را اجرا می‌کنند استفاده شود\.
.P
تنظیم \fBgraphdir\fR تعیین می‌کند که پاپت نمودارها را در کجا ذخیره کند\. توجه داشته باشید که نمودارها برای اجراهای گذشته ذخیره نمی‌شوند؛ پاپت هر بار که کاتالوگی را اعمال می‌کند، پرونده‌های \.dot قبلی را با پرونده‌های جدید جایگزین خواهد کرد\.
.P
اگر از دستور \fBdot\fR در GraphViz استفاده می‌کنید، می‌توانید با \fBdot \-Tpng <DOT FILE> \-o <OUTPUT FILE>\fR یک رندر سریع PNG بگیرید\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "graphdir"
محل ذخیره نمودارهای قالب \.dot (هنگامی که تنظیم \fBgraph\fR فعال باشد)\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$statedir/graphs\fR
.IP "" 0
.SS "group"
گروهی که سرور پاپت تحت آن اجرا خواهد شد\. برای اطمینان از این‌که فرآیندهای سمت عامل (agent، apply و غیره) در صورت لزوم پرونده‌ها و دایرکتوری‌های قابل خواندن توسط سرور پاپت را ایجاد می‌کنند، استفاده می‌شود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBpuppet\fR
.IP "" 0
.SS "hiera_config"
پرونده پیکربندی hiera\. پاپت این پرونده را فقط در زمان راه‌اندازی می‌خواند، بنابراین هر بار که آن را ویرایش می‌کنید باید سرور پاپت را مجدداً راه‌اندازی کنید\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$confdir/hiera\.yaml\. However, for backwards compatibility, if a file exists at $codedir/hiera\.yaml, Puppet uses that instead\.\fR
.IP "" 0
.SS "hostcert"
جایی که میزبان‌های منفرد گواهی‌های خود را ذخیره کرده و به دنبال آن می‌گردند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$certdir/$certname\.pem\fR
.IP "" 0
.SS "hostcert_renewal_interval"
عامل پاپت هر چند وقت یک‌بار گواهی کلاینت خود را تمدید کند\. به طور پیش‌فرض، گواهی کلاینت ۳۰ روز قبل از انقضای گواهی تمدید می‌شود\. اگر بازه دیگری مشخص شود، عامل گواهی کلاینت خود را در طول اجرای بعدی عامل تمدید می‌کند، با این فرض که گواهی کلاینت در مدت زمان مشخص‌شده منقضی شده باشد\.
.P
به طور کلی، مقدار \fBhostcert_renewal_interval\fR باید بیشتر از مقدار \fBruninterval\fR باشد\. تنظیم مقدار \fBhostcert_renewal_interval\fR بر روی 0 تمدید خودکار را غیرفعال می‌کند\.
.P
این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB30d\fR
.IP "" 0
.SS "hostcrl"
محل یافتن فهرست ابطال گواهی (CRL) میزبان\. این مورد متمایز از CRL مرجع صدور گواهی است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$ssldir/crl\.pem\fR
.IP "" 0
.SS "hostcsr"
جایی که میزبان‌های منفرد درخواست گواهی (CSR) خود را در حین انتظار برای صدور گواهی توسط CA ذخیره می‌کنند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$requestdir/$certname\.pem\fR
.IP "" 0
.SS "hostprivkey"
محل ذخیره و جستجوی کلید خصوصی میزبان‌های منفرد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$privatekeydir/$certname\.pem\fR
.IP "" 0
.SS "hostpubkey"
محل ذخیره و جستجوی کلید عمومی میزبان‌های منفرد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$publickeydir/$certname\.pem\fR
.IP "" 0
.SS "http_connect_timeout"
حداکثر زمان انتظار هنگام برقراری اتصال HTTP\. مقدار پیش‌فرض ۲ دقیقه است\. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB2m\fR
.IP "" 0
.SS "http_debug"
آیا درخواست‌ها و پاسخ‌های HTTP در خروجی خطای استاندارد (stderr) نوشته شوند یا خیر\. این هرگز نباید در یک محیط عملیاتی استفاده شود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "http_extra_headers"
فهرست سرایندهای اضافی که همراه با درخواست‌های http به سرور اصلی ارسال می‌شوند\. تعریف سرایند شامل یک نام و یک مقدار است که با دونقطه از هم جدا شده‌اند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB[]\fR
.IP "" 0
.SS "http_keepalive_timeout"
حداکثر زمانی که یک اتصال پایدار HTTP می‌تواند در استخر اتصالات بیکار بماند قبل از این‌که بسته شود\. این زمان باید کوتاه‌تر از زمان نگه‌داری اتصال سرور HTTP باشد (مانند دستور KeepAliveTimeout در آپاچی)\. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB4s\fR
.IP "" 0
.SS "http_proxy_host"
میزبان پروکسی HTTP مورد استفاده برای اتصالات خروجی\. اگر نام میزبان سرور با متغیر محیطی NO_PROXY یا تنظیم \fBno_proxy\fR مطابقت داشته باشد، پروکسی نادیده گرفته می‌شود\. متغیر محیطی http_proxy یا HTTP_PROXY این مقدار را بازنویسی خواهد کرد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBnone\fR
.IP "" 0
.SS "http_proxy_password"
گذرواژه کاربر یک پروکسی احراز هویت‌شده HTTP\. به تنظیم \fBhttp_proxy_user\fR نیاز دارد\.
.P
توجه داشته باشید که گذرواژه‌ها هنگام استفاده به عنوان بخشی از URL باید معتبر باشند\. اگر گذرواژه‌ای حاوی نویسه‌های با معانی ویژه در URL باشد، باید به صورت درصد کدگذاری (URL\-encode) شود (برای نمونه \fB#\fR به \fB%23\fR تبدیل می‌شود)\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBnone\fR
.IP "" 0
.SS "http_proxy_port"
درگاه (پورت) پروکسی HTTP مورد استفاده برای اتصالات خروجی\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB3128\fR
.IP "" 0
.SS "http_proxy_user"
نام کاربری برای یک پروکسی احراز هویت‌شده HTTP\. به تنظیم \fBhttp_proxy_host\fR نیاز دارد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBnone\fR
.IP "" 0
.SS "http_read_timeout"
زمان انتظار برای خواندن داده‌ها از یک اتصال HTTP\. اگر پس از گذشت این بازه چیزی خوانده نشود، اتصال بسته خواهد شد\. مقدار پیش‌فرض ۱۰ دقیقه است\. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB10m\fR
.IP "" 0
.SS "http_user_agent"
رشته User\-Agent پروتکل HTTP که هنگام برقراری درخواست‌های شبکه ارسال می‌شود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBPuppet/<version> Ruby/<version> (<architecture>)\fR
.IP "" 0
.SS "ignore_plugin_errors"
آیا اجرای پاپت باید خطاها را در طول pluginsync نادیده بگیرد یا خیر\. اگر تنظیم false باشد و خطاهایی رخ دهد، عامل اجرا را لغو کرده و گزارشی حاوی اطلاعات درباره اجرای ناموفق ارسال می‌کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "ignoremissingtypes"
صرف‌نظر کردن از جستجوی کلاس‌ها و تعاریفی که در کامپایل قبلی مفقود بوده‌اند\. فهرست اشیاء مفقود به ازای هر محیط نگه‌داری می‌شود و تا زمانی که محیط پاک نشود یا سرور اصلی مجدداً راه‌اندازی نگردد باقی می‌ماند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "ignoreschedules"
بولی؛ آیا عامل پاپت باید زمان‌بندی‌ها را نادیده بگیرد یا خیر\. این گزینه برای اجراهای اولیه عامل پاپت مفید است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "include_legacy_facts"
آیا هنگام درخواست کاتالوگ، واقعیت‌های (فکت‌های) سنتی گنجانده شوند یا خیر\. اگر تمام مانیفست‌های پاپت، hiera\.yaml، و لایه‌های پیکربندی hiera دیگر به واقعیت‌های سنتی مانند \fB$osfamily\fR دسترسی ندارند و در عوض به واقعیت‌های ساختاریافته مانند \fB$facts['os']['family']\fR دسترسی دارند، می‌توان این گزینه را روی \fBfalse\fR تنظیم کرد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "key_type"
نوع کلید خصوصی\. مقادیر معتبر \fBrsa\fR و \fBec\fR هستند\. پیش‌فرض \fBrsa\fR است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBrsa\fR
.IP "" 0
.SS "keylength"
طول بیت کلیدها\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB4096\fR
.IP "" 0
.SS "lastrunfile"
محل ذخیره خلاصه گزارش آخرین اجرا توسط عامل پاپت در قالب yaml\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$publicdir/last_run_summary\.yaml\fR
.IP "" 0
.SS "lastrunreport"
محل ذخیره گزارش آخرین اجرا توسط عامل پاپت، به طور پیش‌فرض در قالب yaml\. قالب گزارش را می‌توان با تنظیم کلید \fBcache\fR پایانه \fBreport\fR در پرونده routes\.yaml در نشانی \fIhttps://puppet\.com/docs/puppet/latest/config_file_routes\.html\fR تغییر داد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$statedir/last_run_report\.yaml\fR
.IP "" 0
.SS "ldapattrs"
ویژگی‌های LDAP برای گنجاندن هنگام پرس‌وجوی LDAP برای گره‌ها\. تمام ویژگی‌های بازگردانده‌شده به عنوان متغیر در دامنه سطح بالا تنظیم می‌شوند\. مقادیر چندگانه باید با کاما از هم جدا شوند\. مقدار 'all' تمام ویژگی‌ها را برمی‌گرداند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBall\fR
.IP "" 0
.SS "ldapbase"
پایه جستجو برای جستجوهای LDAP\. ارائه یک مقدار پیش‌فرض معنادار در اینجا غیرممکن است، اگرچه ممکن است کتابخانه‌های LDAP از قبل مقداری تنظیم کرده باشند\. به طور کلی باید شاخه 'ou=Hosts' زیر دایرکتوری اصلی شما باشد\.
.SS "ldapclassattrs"
ویژگی‌های LDAP برای استفاده در تعریف کلاس‌های پاپت\. مقادیر باید با کاما از هم جدا شوند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBpuppetclass\fR
.IP "" 0
.SS "ldapparentattr"
ویژگی مورد استفاده برای تعریف گره والد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBparentnode\fR
.IP "" 0
.SS "ldappassword"
گذرواژه مورد استفاده برای اتصال به LDAP\.
.SS "ldapport"
درگاه LDAP\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB389\fR
.IP "" 0
.SS "ldapserver"
سرور LDAP\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBldap\fR
.IP "" 0
.SS "ldapssl"
آیا هنگام جستجوی گره‌ها از SSL استفاده شود یا خیر\. پیش‌فرض false است زیرا SSL معمولاً نیاز به تنظیم گواهی‌ها در سمت کلاینت دارد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "ldapstackedattrs"
ویژگی‌های LDAP که باید با افزودن مقادیر در تمام عناصر سلسله‌مراتبی درخت به صورت آرایه پشته شوند\. مقادیر باید با کاما جدا شوند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBpuppetvar\fR
.IP "" 0
.SS "ldapstring"
رشته جستجوی مورد استفاده برای یافتن یک گره LDAP\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB(&(objectclass=puppetClient)(cn=%s))\fR
.IP "" 0
.SS "ldaptls"
آیا هنگام جستجوی گره‌ها از TLS استفاده شود یا خیر\. پیش‌فرض false است زیرا TLS معمولاً نیاز به تنظیم گواهی‌ها در سمت کلاینت دارد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "ldapuser"
کاربر مورد استفاده برای اتصال به LDAP\. باید به صورت یک DN کامل مشخص شود\.
.SS "libdir"
یک مسیر جستجوی اضافی برای پاپت\. این فقط برای پرونده‌هایی مفید است که پاپت بر حسب تقاضا بارگیری می‌کند و فقط تضمین می‌شود که برای آن موارد کار کند\. در واقع، سازوکار بارگیری خودکار مسئول اطمینان از قرار داشتن این دایرکتوری در مسیر جستجوی روبی است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$vardir/lib\fR
.IP "" 0
.SS "localcacert"
محل ذخیره گواهی CA در هر کلاینت\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$certdir/ca\.pem\fR
.IP "" 0
.SS "localedest"
جایی که پاپت باید پرونده‌های ترجمه دریافتی از سرور مرکزی را ذخیره کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$vardir/locales\fR
.IP "" 0
.SS "localesource"
مبدأ بازیابی پرونده‌های ترجمه\. از نوع پرونده استاندارد پاپت (\fBfile\fR) برای بازیابی استفاده می‌شود، بنابراین هر چیزی که یک مبدأ پرونده معتبر باشد می‌تواند در اینجا استفاده شود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBpuppet:///locales\fR
.IP "" 0
.SS "location_trusted"
این گزینه امکان ارسال نام + گذرواژه و سرایند کوکی را به تمام میزبان‌هایی که ممکن است پاپت به آن‌ها تغییر مسیر (redirect) دهد، فراهم می‌کند\. اگر پاپت شما را به سایتی هدایت کند که اطلاعات احراز هویت و کوکی‌های خود را به آن ارسال می‌کنید، این ممکن است رخنه امنیتی ایجاد کند یا نکند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "log_level"
سطح پیش‌فرض ثبت وقایع برای پیام‌های پاپت\. مقادیر مجاز عبارتند از:
.IP "\(bu" 4
debug
.IP "\(bu" 4
info
.IP "\(bu" 4
notice
.IP "\(bu" 4
warning
.IP "\(bu" 4
err
.IP "\(bu" 4
alert
.IP "\(bu" 4
emerg
.IP "\(bu" 4
crit
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBnotice\fR
.IP "" 0
.SS "logdest"
محل ارسال پیام‌های ثبت وقایع\. از بین 'syslog' (سرویس لاگ سیستم POSIX)، 'eventlog' (لاگ رویدادهای ویندوز)، 'console' یا مسیر یک پرونده لاگ انتخاب کنید\. مقاصد چندگانه را می‌توان با استفاده از یک فهرست جداشده با کاما تنظیم کرد (برای نمونه: \fB/path/file1,console,/path/file2\fR)\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: ``
.IP "" 0
.SS "logdir"
دایرکتوری‌ای که پرونده‌های ثبت وقایع در آن ذخیره می‌شوند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBUnix/Linux: /var/log/puppetlabs/puppet \-\- Windows: C:\eProgramData\ePuppetLabs\epuppet\evar\elog \-\- Non\-root user: ~/\.puppetlabs/var/log\fR
.IP "" 0
.SS "manage_internal_file_permissions"
آیا پاپت باید مالک، گروه و مجوز دسترسی پرونده‌هایی را که در داخل استفاده می‌کند مدیریت کند یا خیر\. \fBنکته\fR: برای عامل‌های ویندوز، پیش‌فرض برای نسخه‌های ۴\.۱۰\.۱۳ و بالاتر، نسخه‌های ۵\.۵\.۶ و بالاتر و نسخه‌های ۶\.۰ و بالاتر برابر با \fBfalse\fR است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBtrue\fR
.IP "" 0
.SS "manifest"
مانیفست نقطه ورود برای سرور اصلی\. این می‌تواند یک پرونده یا دایرکتوری از مانیفست‌ها باشد که به ترتیب الفبایی ارزیابی می‌شوند\. پاپت این مسیر را در صورت وجود یا اگر با / یا \ به پایان برسد، به عنوان دایرکتوری مدیریت می‌کند\.
.P
تنظیم مقدار سراسری برای \fBmanifest\fR در puppet\.conf مجاز نیست (اما می‌توان آن را از خط فرمان بازنویسی کرد)\. لطفاً به جای آن از محیط‌های دایرکتوری استفاده کنید\. اگر نیاز دارید از چیزی غیر از دایرکتوری \fBmanifests\fR محیط به عنوان مانیفست اصلی استفاده کنید، می‌توانید \fBmanifest\fR را در environment\.conf تنظیم کنید\. برای اطلاعات بیشتر به نشانی \fIhttps://puppet\.com/docs/puppet/latest/environments_about\.html\fR مراجعه کنید\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: ``
.IP "" 0
.SS "masterport"
درگاه پیش‌فرضی که دستورات فرعی پاپت برای برقراری ارتباط با سرور پاپت استفاده می‌کنند (مانند \fBpuppet facts upload\fR، \fBpuppet agent\fR)\. ممکن است توسط تنظیمات خاص‌تر بازنویسی شود (\fBca_port\fR، \fBreport_port\fR را ببینید)\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB8140\fR
.IP "" 0
.SS "max_deprecations"
حداکثر تعداد هشدارهای منسوخ شدن اعتبارسنجی تجزیه‌کننده را که در صورت شناسایی هشدارهای متعدد ثبت یا نمایش داده می‌شوند، تنظیم می‌کند\. مقدار 0 مانع از ثبت هشدارهای منسوخ شدن می‌شود\. شمارش به ازای هر مانیفست است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB10\fR
.IP "" 0
.SS "max_errors"
حداکثر تعداد خطاهای اعتبارسنجی تجزیه‌کننده را که در صورت شناسایی خطاهای متعدد ثبت یا نمایش داده می‌شوند، تنظیم می‌کند\. مقدار 0 همانند مقدار 1 است؛ همیشه حداقل یک خطا ایجاد می‌شود\. شمارش به ازای هر مانیفست است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB10\fR
.IP "" 0
.SS "max_warnings"
حداکثر تعداد هشدارهای اعتبارسنجی تجزیه‌کننده را که در صورت شناسایی هشدارهای متعدد ثبت یا نمایش داده می‌شوند، تنظیم می‌کند\. مقدار 0 مانع از ثبت هشدارها می‌شود\. شمارش به ازای هر مانیفست است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB10\fR
.IP "" 0
.SS "maximum_uid"
حداکثر UID مجاز\. برخی پلتفرم‌ها از UIDهای منفی استفاده می‌کنند اما با ابزارهایی عرضه می‌شوند که نحوه رسیدگی به اعداد صحیح علامت‌دار را نمی‌دانند، بنابراین UIDها به صورت اعداد بسیار بزرگی نشان داده می‌شوند که نمی‌توان آن‌ها را مجدداً به سیستم برگرداند\. این یک روش برای ایجاد خطای معنادارتر هنگام وقوع چنین وضعیتی است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB4294967290\fR
.IP "" 0
.SS "maxwaitforcert"
حداکثر مدت زمانی که عامل پاپت باید برای امضای درخواست گواهی خود منتظر بماند\. مقدار \fBunlimited\fR باعث می‌شود عامل پاپت به طور نامحدود درخواست گواهی امضاشده کند\. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBunlimited\fR
.IP "" 0
.SS "maxwaitforlock"
حداکثر مدت زمانی که عامل پاپت باید قبل از شروع یک اجرای جدید، منتظر اتمام اجرای عامل پاپت در حال اجرا بماند\. این مقدار به طور پیش‌فرض روی ۱ دقیقه تنظیم شده است\. مقدار \fBunlimited\fR باعث انتظار نامحدود عامل پاپت می‌شود\. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB1m\fR
.IP "" 0
.SS "merge_dependency_warnings"
آیا هشدارهای شکست وابستگی در سطح کلاس ادغام شوند یا خیر\.
.P
هنگامی که یک کلاس با شکست در وابستگی مواجه می‌شود، هر منبع در کلاس یک پیام در سطح notice درباره شکست وابستگی و یک پیام در سطح warning درباره نادیده گرفتن منبع ایجاد می‌کند\.
.P
در صورت true بودن، تمام پیام‌های ناشی از شکست وابستگی کلاس در یک پیام مرتبط با آن کلاس ادغام می‌شوند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "mkusers"
آیا کاربر و گروه لازم که عامل پاپت تحت آن اجرا می‌شود ایجاد شوند یا خیر\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "module_groups"
گروه‌های ماژول اضافی برای درخواست از Puppet Forge\. این یک تنظیم داخلی است و کاربران هرگز نباید آن را تغییر دهند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: ``
.IP "" 0
.SS "module_repository"
مخزن ماژول\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBhttps://forgeapi\.puppet\.com\fR
.IP "" 0
.SS "module_working_dir"
دایرکتوری‌ای که داده‌های ابزار ماژول در آن ذخیره می‌شوند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$vardir/puppet\-module\fR
.IP "" 0
.SS "modulepath"
مسیر جستجو برای ماژول‌ها، به صورت فهرستی از دایرکتوری‌ها که با نویسه جداکننده مسیر سیستم از هم جدا شده‌اند (جداکننده POSIX علامت ':' و ویندوز ';' است)\.
.P
تنظیم مقدار سراسری برای \fBmodulepath\fR در puppet\.conf مجاز نیست (اما می‌توان آن را از خط فرمان بازنویسی کرد)\. لطفاً به جای آن از محیط‌های دایرکتوری استفاده کنید\. اگر نیاز به استفاده از مقداری غیر از مسیر پیش‌فرض \fB<ACTIVE ENVIRONMENT'S MODULES DIR>:$basemodulepath\fR دارید، می‌توانید \fBmodulepath\fR را در environment\.conf تنظیم کنید\. برای اطلاعات بیشتر به نشانی \fIhttps://puppet\.com/docs/puppet/latest/environments_about\.html\fR مراجعه نمایید\.
.SS "name"
نام برنامه کاربردی، در صورتی که به عنوان یک برنامه در حال اجرا باشیم\. پیش‌فرض اساساً 0$ بدون مسیر یا \fB\.rb\fR است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: ``
.IP "" 0
.SS "named_curve"
نام کوتاه برای منحنی EC مورد استفاده جهت تولید کلید خصوصی EC\. مقادیر معتبر باید یکی از منحنی‌های موجود در \fBOpenSSL::PKey::EC\.builtin_curves\fR باشد\. پیش‌فرض \fBprime256v1\fR است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBprime256v1\fR
.IP "" 0
.SS "no_proxy"
فهرستی از نام‌های میزبان یا دامنه که نباید از طریق \fBhttp_proxy_host\fR عبور کنند\. متغیر محیطی no_proxy یا NO_PROXY این مقدار را بازنویسی خواهد کرد\. نام‌ها را می‌توان به صورت FQDN مانند \fBhost\.example\.com\fR، عمومی مانند \fB*\.example\.com\fR، دامنه نقطه‌دار \fB\.example\.com\fR یا پسوند \fBexample\.com\fR مشخص کرد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBlocalhost, 127\.0\.0\.1\fR
.IP "" 0
.SS "node_cache_terminus"
نحوه ذخیره گره‌های در حافظه پنهان\. مقادیر معتبر عبارتند از (none)، 'json'، 'msgpack' یا 'yaml'\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: ``
.IP "" 0
.SS "node_name_fact"
نام واقعیتی (فکتی) که برای تعیین نام گره در تمام درخواست‌های ارسالی عامل به سرور اصلی استفاده می‌شود\. هشدار: این تنظیم با node_name_value ناسازگار است\. تغییر این تنظیم همچنین نیازمند تغییر در auth\.conf پیش‌فرض سرور پاپت در نشانی \fIhttps://puppet\.com/docs/puppetserver/latest/config_file_auth\.html\fR است\.
.SS "node_name_value"
مقدار صریحی که برای نام گره در تمام درخواست‌های ارسالی عامل به سرور اصلی استفاده می‌شود\. هشدار: این تنظیم با node_name_fact ناسازگار است\. تغییر این تنظیم همچنین نیازمند تغییر در auth\.conf پیش‌فرض سرور پاپت است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$certname\fR
.IP "" 0
.SS "node_terminus"
کدام پلاگین داده‌های گره هنگام کامپایل کاتالوگ‌های گره استفاده شود\.
.P
هنگامی که پاپت کاتالوگی را کامپایل می‌کند، دو منبع اصلی اطلاعات را ترکیب می‌کند: مانیفست اصلی و یک پلاگین داده‌های گره (که به دلایل تاریخی معمولاً "پایانه گره" نامیده می‌شود)\. پلاگین‌های داده‌های گره سه مورد را برای نام گره داده‌شده ارائه می‌دهند:
.IP "1." 4
فهرستی از کلاس‌ها برای افزودن به کاتالوگ آن گره (و به صورت اختیاری، مقادیر پارامترهای آن‌ها)\.
.IP "2." 4
محیط پاپتی که گره باید استفاده کند\.
.IP "3." 4
فهرستی از متغیرهای دامنه سطح بالای اضافی برای تنظیم\.
.IP "" 0
.P
سه پلاگین اصلی داده‌های گره عبارتند از:
.IP "\(bu" 4
\fBplain\fR \-\- داده‌ای برنمی‌گرداند، بنابراین مانیفست اصلی تمام پیکربندی گره را کنترل می‌کند\.
.IP "\(bu" 4
\fBexec\fR \-\- از یک دسته‌بندی‌کننده خارجی گره (ENC) در نشانی \fIhttps://puppet\.com/docs/puppet/latest/nodes_external\.html\fR که با تنظیم \fBexternal_nodes\fR پیکربندی شده است استفاده می‌کند\.
.IP "\(bu" 4
\fBclassifier\fR (که پیش‌تر \fBconsole\fR نامیده می‌شد) \-\- مخصوص Puppet Enterprise است و از کنسول PE برای داده‌های گره استفاده می‌کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBplain\fR
.IP "" 0
.SS "noop"
آیا کاتالوگ‌ها در حالت noop اعمال شوند یا خیر، که به پاپت امکان می‌دهد یک اجرای عادی را تا حدی شبیه‌سازی کند\. این تنظیم بر puppet agent و puppet apply تأثیر می‌گذارد\.
.P
هنگام اجرا در حالت noop، پاپت همانند اجرای عادی هماهنگ بودن هر منبع را بررسی می‌کند\. با این حال، اگر صفت یک منبع در وضعیت مطلوب نباشد، پاپت اقدامی انجام نمی‌دهد و در عوض تغییراتی را که اعمال \fIمی‌کرد\fR گزارش می‌دهد\. این تغییرات شبیه‌سازی‌شده در گزارش ارسال‌شده به سرور پاپت نمایش داده خواهند شد\.
.P
\fBنکته مهم:\fR فراپارامتر \fBnoop\fR در \fIhttps://puppet\.com/docs/puppet/latest/metaparameter\.html#noop\fR به شما اجازه می‌دهد منابع منفرد را در حالت noop اعمال کنید و بر مقدار سراسری تنظیم \fBnoop\fR اولویت خواهد داشت\. این بدان معناست که منبعی با \fBnoop => false\fR در صورت نیاز تغییر داده \fIخواهد شد\fR، حتی زمانی که عامل با \fBnoop = true\fR یا \fB\-\-noop\fR اجرا شود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "number_of_facts_soft_limit"
حد نرم برای تعداد کل مقادیر واقعیت‌ها (فکت‌ها)\. این شامل عناصر فرزند تمام واقعیت‌ها می‌شود (مانند تمام عناصر یک آرایه یا یک درهم‌سازی)، نه فقط واقعیت‌های سطح بالا\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB10240\fR
.IP "" 0
.SS "onetime"
یک اجرای پیکربندی را انجام داده و خارج می‌شود، به جای اجرای یک دیمن با اجرای طولانی‌مدت\. این گزینه برای اجرای تعاملی عامل پاپت یا اجرای عامل پاپت از طریق cron مفید است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "passfile"
جایی که عامل پاپت گذرواژه کلید خصوصی خود را ذخیره می‌کند\. عموماً بدون استفاده است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$privatedir/password\fR
.IP "" 0
.SS "path"
مسیر جستجوی شل\. پیش‌فرض به آنچه از فرآیند والد به ارث رسیده است تنظیم می‌شود\.
.P
این تنظیم فقط در بخش \fB[main]\fR پرونده puppet\.conf قابل تنظیم است؛ نمی‌توان آن را در \fB[server]\fR، \fB[agent]\fR یا بخش پیکربندی محیط تنظیم کرد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBnone\fR
.IP "" 0
.SS "payload_soft_limit"
حد نرم برای اندازه بار داده (payload)\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB16777216\fR
.IP "" 0
.SS "pidfile"
پرونده حاوی PID فرآیند در حال اجرا\. این پرونده برای استفاده توسط چارچوب‌های مدیریت سرویس و سیستم‌های مانیتورینگ در نظر گرفته شده تا مشخص شود آیا فرآیند پاپت هنوز در جدول فرآیندها حضور دارد یا خیر\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$rundir/${run_mode}\.pid\fR
.IP "" 0
.SS "plugindest"
جایی که پاپت باید پلاگین‌های واکشی‌شده از سرور مرکزی را ذخیره کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$libdir\fR
.IP "" 0
.SS "pluginfactdest"
جایی که پاپت باید واقعیت‌های خارجی مدیریت‌شده توسط pluginsync را ذخیره کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$vardir/facts\.d\fR
.IP "" 0
.SS "pluginfactsource"
مبدأ بازیابی واقعیت‌های خارجی برای pluginsync\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBpuppet:///pluginfacts\fR
.IP "" 0
.SS "pluginsignore"
پرونده‌هایی که باید هنگام بارگیری پلاگین‌ها نادیده گرفته شوند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB\.svn CVS \.git \.hg\fR
.IP "" 0
.SS "pluginsource"
مبدأ بازیابی پلاگین‌ها\. از نوع پرونده استاندارد پاپت (\fBfile\fR) برای بازیابی استفاده می‌شود، بنابراین هر چیزی که یک مبدأ پرونده معتبر باشد می‌تواند در اینجا استفاده شود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBpuppet:///plugins\fR
.IP "" 0
.SS "pluginsync"
آیا پلاگین‌ها باید با سرور مرکزی همگام‌سازی شوند یا خیر\. این تنظیم منسوخ شده است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBtrue\fR
.IP "" 0
.SS "postrun_command"
دستوری که پس از هر بار اجرای عامل اجرا می‌شود\. اگر این دستور یک کد بازگشتی غیرصفر برگرداند، کل اجرای پاپت ناموفق تلقی خواهد شد، حتی اگر در طول اجرای عادی کارهایی را انجام داده باشد\.
.SS "preferred_serialization_format"
روش ترجیحی برای سریال‌سازی نمونه‌های روبی جهت انتقال روی شبکه\. تضمین نمی‌شود که همه نمونه‌ها با این روش سریال شوند، اما برای تمام کلاس‌هایی که از آن پشتیبانی می‌کنند استفاده خواهد شد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBjson\fR
.IP "" 0
.SS "preprocess_deferred"
آیا پاپت باید توابع به تعویق افتاده (deferred) را قبل از اعمال کاتالوگ فراخوانی کند یا خیر\. در صورت تنظیم بر روی \fBtrue\fR، تمام پیش‌نیازهای مورد نیاز برای تابع به تعویق افتاده باید قبل از اجرای پاپت برآورده شوند\. در صورت تنظیم بر روی \fBfalse\fR، توابع به تعویق افتاده از روابط و ترتیب‌بندی پاپت پیروی می‌کنند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "prerun_command"
دستوری که قبل از هر بار اجرای عامل اجرا می‌شود\. اگر این دستور یک کد بازگشتی غیرصفر برگرداند، کل اجرای پاپت با شکست مواجه خواهد شد\.
.SS "preview_outputdir"
دایرکتوری‌ای که پیش‌نمایش کاتالوگ‌ها به ازای هر گره در آن تولید می‌شوند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$vardir/preview\fR
.IP "" 0
.SS "priority"
اولویت زمان‌بندی فرآیند\. مقادیر معتبر عبارتند از 'high'، 'normal'، 'low' یا 'idle'\. اولویت را می‌توان به عنوان یک مقدار عددی صحیح نیز مشخص کرد، مانند \-5\. پاپت برای افزایش اولویت زمان‌بندی باید به عنوان یک کاربر دارای دسترسی ریشه (کاربر ارشد) اجرا شود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: ``
.IP "" 0
.SS "privatedir"
جایی که کلاینت اطلاعات گواهی خصوصی را ذخیره می‌کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$ssldir/private\fR
.IP "" 0
.SS "privatekeydir"
دایرکتوری کلید خصوصی\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$ssldir/private_keys\fR
.IP "" 0
.SS "profile"
آیا تحلیل کارایی (profiling) تجربی فعال باشد یا خیر\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "publicdir"
جایی که پاپت پرونده‌های عمومی را ذخیره می‌کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBUnix/Linux: /opt/puppetlabs/puppet/public \-\- Windows: C:\eProgramData\ePuppetLabs\epuppet\epublic \-\- Non\-root user: ~/\.puppetlabs/opt/puppet/public\fR
.IP "" 0
.SS "publickeydir"
دایرکتوری کلید عمومی\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$ssldir/public_keys\fR
.IP "" 0
.SS "puppet_trace"
آیا ردپای پشته (stack trace) پاپت در برخی خطاها چاپ شود یا خیر\. در صورتی که \fBtrace\fR نیز تنظیم شده باشد، این گزینه بی اثر است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "puppetdlog"
پرونده ثبت وقایع جایگزین (fallback)\. این فقط زمانی استفاده می‌شود که گزینه \fB\-\-logdest\fR مشخص نشده باشد و پاپت روی سیستم‌عاملی اجرا شود که در آن هر دو سرویس syslog در POSIX و Event Log ویندوز در دسترس نباشند\.
.P
علیرغم این نام، هر دو عامل پاپت و سرور پاپت از این پرونده به عنوان مقصد لاگ جایگزین استفاده خواهند کرد\.
.P
برای کنترل مقاصد ثبت وقایع، به گزینه خط فرمان \fB\-\-logdest\fR در صفحات راهنمای puppet server، puppet agent و puppet apply مراجعه کنید\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$logdir/puppetd\.log\fR
.IP "" 0
.SS "report"
آیا پس از هر تراکنش گزارش ارسال شود یا خیر\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBtrue\fR
.IP "" 0
.SS "report_configured_environmentpath"
نحوه گزارش مسیرهای محیط را مشخص می‌کند\. هنگامی که مقدار \fBversioned_environment_dirs\fR برابر با \fBtrue\fR باشد، پاپت تابع readlink را هنگام ساختن modulepath محیط روی تنظیم \fBenvironmentpath\fR اعمال می‌کند\. مسیر کامل حل‌شده به عنوان "مسیر حل‌شده" و مسیر پیکربندی‌شده که احتمالاً شامل پیوندهای نمادین است به عنوان "مسیر پیکربندی‌شده" نامیده می‌شود\.
.P
در صورت تنظیم بر روی \fBfalse\fR، مسیرهای حل‌شده به جای مسیرهای پیکربندی‌شده گزارش می‌شوند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBtrue\fR
.IP "" 0
.SS "report_include_system_store"
آیا پردازشگر گزارش 'http' هنگام ارسال گزارش‌ها به نشانی‌های HTTPS باید مخزن گواهی سیستم را لحاظ کند یا خیر\. در صورت false بودن، پردازشگر 'http' فقط به سرورهای گزارشی اعتماد می‌کند که گواهی‌های آن‌ها توسط CA پاپت یا یکی از CAهای میانی آن صادر شده باشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "report_port"
درگاه ارتباط با report_server\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$serverport\fR
.IP "" 0
.SS "report_server"
سروری که گزارش‌های تراکنش به آن ارسال می‌شوند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$server\fR
.IP "" 0
.SS "reportdir"
دایرکتوری ذخیره گزارش‌ها\. هر گره یک زیردایرکتوری مجزا در این دایرکتوری دریافت می‌کند\. این تنظیم فقط زمانی استفاده می‌شود که پردازشگر گزارش \fBstore\fR فعال باشد (تنظیم \fBreports\fR را ببینید)\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$vardir/reports\fR
.IP "" 0
.SS "reports"
فهرست گرداننده‌های گزارش مورد استفاده\. هنگام استفاده از چندین گرداننده گزارش، نام‌های آن‌ها باید با کاما جدا شده و فاصله‌های خالی مجاز هستند (برای نمونه، \fBreports = http, store\fR)\.
.P
این تنظیم به puppet server و puppet apply مربوط می‌شود\. سرور اصلی پاپت این گرداننده‌های گزارش را با گزارش‌هایی که از گره‌های عامل دریافت می‌کند فراخوانی می‌نماید، و puppet apply آن‌ها را با گزارش خود فراخوانی خواهد کرد (در تمام موارد، گره اعمال‌کننده کاتالوگ باید \fBreport = true\fR داشته باشد)\.
.P
برای اطلاعات درباره گرداننده‌های گزارش داخلی به مرجع گزارش مراجعه کنید؛ گرداننده‌های سفارشی را نیز می‌توان از ماژول‌ها بارگیری کرد\.
.P
برای خاموش کردن کامل گزارش‌ها، این مقدار را روی \fBnone\fR قرار دهید\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBstore\fR
.IP "" 0
.SS "reporturl"
نشانی URL که گزارش‌ها باید به آن بازارسال (فوروارد) شوند\. این تنظیم فقط زمانی استفاده می‌شود که پردازشگر گزارش \fBhttp\fR فعال باشد (تنظیم \fBreports\fR را ببینید)\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBhttp://localhost:3000/reports/upload\fR
.IP "" 0
.SS "requestdir"
محل ذخیره درخواست‌های گواهی میزبان\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$ssldir/certificate_requests\fR
.IP "" 0
.SS "resourcefile"
پرونده‌ای که عامل پاپت فهرستی از منابع مرتبط با پیکربندی دریافت‌شده را در آن ذخیره می‌کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$statedir/resources\.txt\fR
.IP "" 0
.SS "resubmit_facts"
آیا پس از هر تراکنش، واقعیت‌های (فکت‌های) به‌روزرسانی‌شده مجدداً ارسال شوند یا خیر\. به طور پیش‌فرض پاپت فقط در ابتدای تراکنش قبل از اعمال کاتالوگ واقعیت‌ها را ارسال می‌کند\. از آن‌جا که پاپت می‌تواند وضعیت سیستم را تغییر دهد، مقدار واقعیت‌ها ممکن است پس از پایان پاپت تغییر کند\. بنابراین، هر واقعیتی که در puppetdb ذخیره شده ممکن است تا اجرای بعدی عامل (معمولاً در ۳۰ دقیقه آینده) سازگار نباشد\. اگر این ویژگی فعال باشد، پاپت پس از اعمال کاتالوگ، فکت‌ها را مجدداً ارسال می‌کند و اطمینان حاصل می‌کند که فکت‌های ذخیره‌شده در puppetdb به‌روز هستند\. با این حال، این کار بار ارسال فکت بر روی puppetdb را دو برابر می‌کند، بنابراین به طور پیش‌فرض غیرفعال است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "rich_data"
فعال کردن وجود داده‌های گسترش‌یافته در کاتالوگ با ذخیره آن‌ها به عنوان یک درهم‌سازی با کلید ویژه \fB__ptype\fR\. در صورت فعال بودن، منابع حاوی مقادیر انواع داده‌های \fBBinary\fR، \fBRegexp\fR، \fBSemVer\fR، \fBSemVerRange\fR، \fBTimespan\fR و \fBTimestamp\fR و همچنین نمونه‌هایی از انواع مشتق‌شده از \fBObject\fR نوع داده خود را حفظ می‌کنند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBtrue\fR
.IP "" 0
.SS "route_file"
پرونده YAML حاوی پیکربندی مسیر indirector\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$confdir/routes\.yaml\fR
.IP "" 0
.SS "rundir"
محل نگه‌داری پرونده‌های PID پاپت\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBUnix/Linux: /var/run/puppetlabs \-\- Windows: C:\eProgramData\ePuppetLabs\epuppet\evar\erun \-\- Non\-root user: ~/\.puppetlabs/var/run\fR
.IP "" 0
.SS "runinterval"
عامل پاپت هر چند وقت یک‌بار کاتالوگ را اعمال کند\. توجه داشته باشید که runinterval برابر با 0 به معنای "اجرای پیوسته" است نه "هرگز اجرا نشدن"\. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB30m\fR
.IP "" 0
.SS "runtimeout"
حداکثر مدت زمانی که یک اجرای عامل مجاز است طول بکشد\. اجرای عاملی که از این مهلت فراتر رود لغو خواهد شد\. مقدار 0 مهلت زمانی را غیرفعال می‌کند\. پیش‌فرض ۱ ساعت است\. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB1h\fR
.IP "" 0
.SS "serial"
محل ذخیره شماره سریال گواهی‌ها\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$cadir/serial\fR
.IP "" 0
.SS "server"
سرور اصلی پاپت که عامل پاپت باید به آن متصل شود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBpuppet\fR
.IP "" 0
.SS "server_datadir"
دایرکتوری‌ای که داده‌های سریال‌شده در آن ذخیره می‌شوند، معمولاً در یک زیردایرکتوری\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$vardir/server_data\fR
.IP "" 0
.SS "server_list"
فهرست سرورهای اصلی پاپت که عامل پاپت باید به آن‌ها متصل شود، به ترتیبی که مورد آزمایش قرار می‌گیرند\. هر مقدار باید یک نام دامنه کاملاً واجد شرایط (FQDN) باشد که به دنبال آن یک ':' اختیاری و شماره درگاه می‌آید\. اگر درگاه حذف شود، پاپت از masterport برای آن میزبان استفاده می‌کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB[]\fR
.IP "" 0
.SS "serverport"
درگاه پیش‌فرضی که دستورات فرعی پاپت برای برقراری ارتباط با سرور پاپت استفاده می‌کنند (مانند \fBpuppet facts upload\fR، \fBpuppet agent\fR)\. ممکن است توسط تنظیمات خاص‌تر بازنویسی شود (\fBca_port\fR، \fBreport_port\fR را ببینید)\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB8140\fR
.IP "" 0
.SS "settings_catalog"
آیا کاتالوگ تنظیمات کامپایل و اعمال شود یا خیر\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBtrue\fR
.IP "" 0
.SS "show_diff"
آیا هنگام جایگزینی پرونده‌ها، تفاوت متنی ثبت و گزارش شود یا خیر\. این امر باعث می‌شود محتوای جزئی پرونده از سیستم ثبت و گزارش‌دهی عادی پاپت عبور کند، بنابراین در صورتی که گزارش‌های پاپت را به مقصدی ناامن ارسال می‌کنید باید با احتیاط استفاده شود\. این قابلیت در حال حاضر نیازمند کتابخانه روبی \fBdiff/lcs\fR است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "signeddir"
محل ذخیره گواهی‌های امضاشده توسط CA\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$cadir/signed\fR
.IP "" 0
.SS "skip_logging_catalog_request_destination"
مشخص می‌کند که آیا اعلان مربوط به این‌که کدام کامپایلر کاتالوگ را ارائه داده سرکوب شود یا خیر\. مقدار \fBtrue\fR اعلان را سرکوب می‌کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "skip_tags"
برچسب‌های مورد استفاده برای پالایش منابع\. در صورت تنظیم این گزینه، فقط منابعی که با این برچسب‌ها برچسب‌گذاری نشده‌اند اعمال خواهند شد\. مقادیر باید با کاما جدا شوند\.
.SS "sourceaddress"
نشانی‌ای که عامل باید برای شروع درخواست‌ها استفاده کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: ``
.IP "" 0
.SS "splay"
آیا قبل از انجام اولین اجرای عامل پس از راه‌اندازی مجدد سرویس، به مدت زمان تصادفی (از بلافاصله تا مقدار \fB$splaylimit\fR) به خواب برود یا خیر\. پس از این دوره، عامل به صورت دوره‌ای بر اساس \fB$runinterval\fR خود اجرا می‌شود\.
.P
برای نمونه، با فرض یک \fB$runinterval\fR پیش‌فرض ۳۰ دقیقه‌ای، تنظیم \fBsplay\fR روی مقدار پیش‌فرض \fBfalse\fR، و عاملی که در دقیقه 00: هر ساعت شروع به کار می‌کند، عامل هر ۳۰ دقیقه در دقایق 01: و 31: بررسی انجام می‌دهد\.
.P
با فعال بودن \fBsplay\fR، قبل از اولین اجرای خود تا مقدار \fB$splaylimit\fR به هر میزانی منتظر می‌ماند\. برای نمونه ممکن است ۸ دقیقه منتظر بماند و اولین اجرای خود را در دقیقه 08: آغاز کند\. با فرض مقدار پیش‌فرض ۳۰ دقیقه، اجرای بعدی در دقیقه 38: خواهد بود\.
.P
اگر سرویس پاپت یک عامل را با فعال بودن \fBsplay\fR مجدداً راه‌اندازی کنید، دوره splay را مجدداً محاسبه کرده و اولین اجرای پس از راه‌اندازی مجدد را به این دوره جدید موکول می‌کند\. اگر گروهی از عامل‌های پاپت را همزمان با فعال بودن \fBsplay\fR راه‌اندازی مجدد کنید، مراجعه آن‌ها به سرورهای اصلی به طور یکنواخت‌تری توزیع می‌شود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "splaylimit"
حداکثر زمان تاخیر قبل از اولین اجرای عامل هنگامی که \fBsplay\fR فعال است\. پیش‌فرض به \fB$runinterval\fR عامل تنظیم می‌شود\. بازه \fBsplay\fR تصادفی است و با هر بار شروع یا راه‌اندازی مجدد عامل دوباره محاسبه می‌شود\. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$runinterval\fR
.IP "" 0
.SS "srv_domain"
دامنه‌ای که برای یافتن رکوردهای SRV سرورهای مورد استفاده پرس‌وجو خواهد شد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBexample\.com\fR
.IP "" 0
.SS "ssl_client_header"
سرایند حاوی SSL DN کلاینت احراز هویت‌شده\. این سرایند باید توسط پروکسی روی SSL DN کلاینت احراز هویت‌شده تنظیم شود (مانند \fB/CN=puppet\.puppetlabs\.com\fR)\. پاپت نام عمومی (CN) را از نام متمایز (DN) استخراج کرده و از مقدار فیلد CN برای مجوزدهی استفاده می‌کند\.
.P
توجه داشته باشید که نام سرایند HTTP توسط واسط دروازه مشترک (CGI) وب‌سرور تغییر داده می‌شود: یک پیشوند \fBHTTP_\fR اضافه می‌شود، خط تيره‌ها به زیرخط تبدیل می‌شوند و تمام حروف بزرگ می‌شوند\. بنابراین برای استفاده از سرایند \fBX\-Client\-DN\fR، این تنظیم باید \fBHTTP_X_CLIENT_DN\fR باشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBHTTP_X_CLIENT_DN\fR
.IP "" 0
.SS "ssl_client_verify_header"
سرایند حاوی پیام وضعیت اعتبارسنجی کلاینت\. اگر کلاینت با موفقیت احراز هویت شد این سرایند باید توسط پروکسی روی 'SUCCESS' تنظیم شود و در غیر این صورت هر مقدار دیگری\.
.P
توجه داشته باشید که نام سرایند HTTP توسط واسط دروازه مشترک (CGI) وب‌سرور تغییر داده می‌شود: یک پیشوند \fBHTTP_\fR افزوده می‌شود، خط تیره‌ها به زیرخط تبدیل شده و تمام حروف بزرگ می‌شوند\. بنابراین برای استفاده از سرایند \fBX\-Client\-Verify\fR، این تنظیم باید \fBHTTP_X_CLIENT_VERIFY\fR باشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBHTTP_X_CLIENT_VERIFY\fR
.IP "" 0
.SS "ssl_lockfile"
پرونده قفلی برای نشان دادن این‌که فرآیند راه‌اندازی اولیه ssl در حال حاضر در حال انجام است\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$ssldir/ssl\.lock\fR
.IP "" 0
.SS "ssl_trust_store"
پرونده‌ای حاوی گواهی‌های CA در قالب PEM که پاپت باید هنگام برقراری درخواست‌های HTTPS به آن‌ها اعتماد کند\. این \fBفقط\fR برای درخواست‌های https به زیرساخت‌های غیر پاپت اعمال می‌شود، مانند بازیابی متاداده و محتوای پرونده از منابع پرونده https، ابزار ماژول پاپت و پردازشگر گزارش 'http'\. این تنظیم هنگام برقراری درخواست‌ها به نشانی‌های //:puppet مانند کاتالوگ و درخواست‌های گزارش نادیده گرفته می‌شود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: ``
.IP "" 0
.SS "ssldir"
محل نگه‌داری گواهی‌های SSL\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$confdir/ssl\fR
.IP "" 0
.SS "statedir"
دایرکتوری‌ای که وضعیت پاپت در آن ذخیره می‌شود\. به طور کلی این دایرکتوری را می‌توان بدون آسیب رساندن حذف کرد (اگرچه ممکن است منجر به راه‌اندازی‌های مجدد غیرضروری سرویس شود)\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$vardir/state\fR
.IP "" 0
.SS "statefile"
جایی که عامل پاپت و سرور پاپت وضعیت مرتبط با پیکربندی در حال اجرا را ذخیره می‌کنند\. در مورد سرور پاپت، این پرونده وضعیت کشف‌شده از طریق تعامل با کلاینت‌ها را منعکس می‌کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$statedir/state\.yaml\fR
.IP "" 0
.SS "statettl"
عامل پاپت چه مدت باید آخرین باری را که یک منبع بررسی یا همگام‌سازی شده در حافظه پنهان نگه دارد\. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد\. مقدار \fB0\fR یا \fBunlimited\fR هرس حافظه پنهان را غیرفعال می‌کند\.
.P
این تنظیم بر استفاده از منابع \fBschedule\fR تأثیر می‌گذارد، زیرا اطلاعات مربوط به آخرین زمان بررسی یک منبع در \fBstatefile\fR ذخیره می‌شود\. مقدار \fBstatettl\fR باید به اندازه کافی بزرگ باشد تا اطمینان حاصل شود که یک منبع به دلیل منقضی شدن مدخل آن از حافظه پنهان، چندین بار در طول یک زمان‌بندی اجرا نشود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB32d\fR
.IP "" 0
.SS "static_catalogs"
آیا یک کاتالوگ ایستا در نشانی \fIhttps://puppet\.com/docs/puppet/latest/static_catalogs\.html#enabling\-or\-disabling\-static\-catalogs\fR کامپایل شود یا خیر، که فقط در سرور پاپت زمانی رخ می‌دهد که تنظیمات \fBcode\-id\-command\fR و \fBcode\-content\-command\fR در پرونده \fBpuppetserver\.conf\fR آن پیکربندی شده باشند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBtrue\fR
.IP "" 0
.SS "storeconfigs"
آیا پیکربندی هر کلاینت، از جمله کاتالوگ‌ها، واقعیت‌ها و داده‌های مرتبط ذخیره شود یا خیر\. این همچنین وارد کردن و صادر کردن منابع در زبان پاپت را فعال می‌کند \- سازوکاری برای تبادل منابع بین گره‌ها\.
.P
به طور پیش‌فرض از پشتیبان 'puppetdb' استفاده می‌شود\.
.P
می‌توانید با استفاده از تنظیم storeconfigs_backend این پشتیبان را تنظیم کنید\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "storeconfigs_backend"
پایانه پشتیبان مورد استفاده برای StoreConfigs را پیکربندی می‌کند\. به طور پیش‌فرض از مخزن PuppetDB استفاده می‌شود که باید قبل از روشن کردن StoreConfigs نصب و پیکربندی شده باشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBpuppetdb\fR
.IP "" 0
.SS "strict"
سطح سخت‌گیری پاپت\. مقادیر مجاز عبارتند از:
.IP "\(bu" 4
off \- اعتبارسنجی اضافی انجام ندهد، گزارش نکند
.IP "\(bu" 4
warning \- اعتبارسنجی اضافی انجام دهد، به عنوان هشدار گزارش کند
.IP "\(bu" 4
error \- اعتبارسنجی اضافی انجام دهد، با خطا متوقف شود (پیش‌فرض)
.IP "" 0
.P
سطح سخت‌گیری هم برای معناشناسی زبان و هم برای اعتبارسنجی ارزیابی زمان اجرا است\. علاوه بر کنترل رفتار با این کلید سرور اصلی، برخی از هشدارهای جداگانه ممکن است توسط تنظیم disable_warnings نیز کنترل شوند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBerror\fR
.IP "" 0
.SS "strict_environment_mode"
آیا محیط مشخص‌شده توسط عامل باید معتبر و قطعی تلقی شود، به طوری که اگر کاتالوگ دریافت‌شده با آن مطابقت نداشت اجرا با شکست مواجه شود یا خیر\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "strict_variables"
باعث بروز خطای ارزیابی هنگام ارجاع به متغیرهای ناشناخته می‌شود (این گزینه بر ارجاع به متغیرهایی که صریحاً روی undef تنظیم شده‌اند تأثیری ندارد)\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBtrue\fR
.IP "" 0
.SS "summarize"
آیا خلاصه تراکنش چاپ شود یا خیر\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "supported_checksum_types"
انواع جمع‌آزمایی (checksum) پشتیبانی‌شده توسط این عامل برای استفاده در منابع پرونده یک کاتالوگ ایستا\. مقادیر باید با کاما جدا شوند\. انواع معتبر عبارتند از sha256، sha256lite، sha384، sha512، sha224، sha1، sha1lite، md5، md5lite، mtime و ctime\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB["sha256", "sha384", "sha512", "sha224", "md5"]\fR
.IP "" 0
.SS "syslogfacility"
کدام تسهیلات syslog هنگام ثبت وقایع در syslog استفاده شود\. Syslog فهرست ثابتی از تسهیلات معتبر دارد و شما باید یکی از آن‌ها را انتخاب کنید؛ نمی‌توانید مقدار دلخواهی بسازید\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBdaemon\fR
.IP "" 0
.SS "tags"
برچسب‌های مورد استفاده برای یافتن منابع\. در صورت تنظیم این گزینه، فقط منابعی که با برچسب‌های مشخص‌شده برچسب‌گذاری شده‌اند اعمال خواهند شد\. مقادیر باید با کاما جدا شوند\.
.SS "tasks"
پشتیبانی تجربی از وظایف و برنامه‌ها را در زبان پاپت روشن می‌کند\. این فقط برای استفاده از API داخلی است\. این تنظیم را تغییر ندهید\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "top_level_facts_soft_limit"
حد نرم برای تعداد واقعیت‌های (فکت‌های) سطح بالا\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB512\fR
.IP "" 0
.SS "trace"
آیا در برخی خطاها ردپای پشته (stack trace) چاپ شود یا خیر\. ردپای پشته داخلی روبی را همراه با فریم‌های تابع پاپت چاپ خواهد کرد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "transactionstorefile"
پرونده ذخیره‌سازی تراکنشی برای تداوم داده‌ها بین تراکنش‌ها به منظور استنتاج اطلاعات (مانند corrective_change) روی داده‌های جدید دریافت شده\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$statedir/transactionstore\.yaml\fR
.IP "" 0
.SS "trusted_external_command"
اسکریپت یا دایرکتوری واقعیت‌های مورد اعتماد خارجی برای استفاده\. مقدار این تنظیم می‌تواند به مسیر یک دستور اجرایی تنظیم شود که می‌تواند فکت‌های مورد اعتماد خارجی را تولید کند یا به دایرکتوری حاوی آن دستورات اجرایی\. دستور(ها) باید:
.IP "\(bu" 4
نام یک گره را به عنوان آرگومان خط فرمان دریافت کنند\.
.IP "\(bu" 4
یک درهم‌سازی JSON با واقعیت‌های مورد اعتماد خارجی برای این گره برگردانند\.
.IP "\(bu" 4
برای گره‌های ناشناخته یا نامعتبر، با کد خروج غیرصفر خارج شوند\.
.IP "" 0
.P
اگر تنظیم به یک دستور اجرایی اشاره کند، واقعیت‌های مورد اعتماد خارجی در کلید 'external' درهم‌سازی فکت‌های مورد اعتماد ذخیره می‌شوند\. در غیر این صورت برای هر پرونده اجرایی در دایرکتوری، فکت‌های مورد اعتماد خارجی در کلید \fB<basename>\fR درهم‌سازی \fBtrusted['external']\fR ذخیره خواهند شد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: ``
.IP "" 0
.SS "trusted_oid_mapping_file"
پرونده‌ای که نگاشت بین OIDهای سفارشی SSL و نام‌های کاربرپسند را فراهم می‌کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$confdir/custom_trusted_oid_mapping\.yaml\fR
.IP "" 0
.SS "use_cached_catalog"
آیا فقط از کاتالوگ در حافظه پنهان استفاده شود به جای این‌که در هر اجرا کاتالوگ جدیدی کامپایل گردد\. پاپت می‌تواند با فعال بودن پیش‌فرض این گزینه اجرا شود و سپس در صورت تمایل به کامپایل مجدد، به صورت گزینشی غیرفعال گردد\. از آن‌جا که عامل پاپتی که از کاتالوگ‌های ذخیره‌شده استفاده می‌کند با سرور اصلی تماس نمی‌گیرد، در ابتدای اجرای پاپت فکت‌ها را نیز بارگذاری نمی‌کند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "use_last_environment"
پاپت هر دو محیط اولیه و همگراشده را در پرونده last_run_summary ذخیره می‌کند\. اگر آن‌ها متفاوت باشند و این تنظیم روی true باشد، ما از آخرین محیط همگراشده استفاده کرده و از درخواست گره صرف‌نظر می‌کنیم\.
.P
هنگامی که روی false تنظیم شود، درخواست گره را انجام داده و داده‌های محیط را از پرونده last_run_summary نادیده می‌گیریم\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBtrue\fR
.IP "" 0
.SS "use_srv_records"
آیا سرور رکوردهای SRV را در DNS برای دامنه فعلی جستجو کند یا خیر\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "usecacheonfailure"
آیا هنگامی که پیکربندی راه دور کامپایل نمی‌شود، از پیکربندی ذخیره‌شده در حافظه پنهان استفاده شود یا خیر\. این گزینه برای آزمایش پیکربندی‌های جدید مفید است، در مواردی که می‌خواهید پیکربندی خراب را اصلاح کنید به جای بازگشت به یک پیکربندی سالم شناخته‌شده\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBtrue\fR
.IP "" 0
.SS "user"
کاربری که سرور پاپت تحت آن اجرا خواهد شد\. برای اطمینان از این‌که فرآیندهای سمت عامل (agent، apply و غیره) در صورت لزوم پرونده‌ها و دایرکتوری‌های قابل خواندن توسط سرور پاپت را ایجاد می‌کنند، استفاده می‌شود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBpuppet\fR
.IP "" 0
.SS "vardir"
محل ذخیره داده‌های پویا و در حال رشد توسط پاپت\. مقدار پیش‌فرض این تنظیم به طور ویژه مانند \fBconfdir\fR محاسبه می‌شود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBUnix/Linux: /opt/puppetlabs/puppet/cache \-\- Windows: C:\eProgramData\ePuppetLabs\epuppet\ecache \-\- Non\-root user: ~/\.puppetlabs/opt/puppet/cache\fR
.IP "" 0
.SS "vendormoduledir"
دایرکتوری حاوی ماژول‌های ارائه‌شده توسط فروشنده (\fBvendored\fR)\. این ماژول‌ها توسط \fIتمام\fR محیط‌ها مانند ماژول‌های موجود در \fBbasemodulepath\fR استفاده خواهند شد\. تنها تفاوت این است که ماژول‌های موجود در \fBbasemodulepath\fR با pluginsync همگام می‌شوند، در حالی که ماژول‌های تأمین‌کننده این‌گونه نیستند\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB/opt/puppetlabs/puppet/vendor_modules\fR
.IP "" 0
.SS "versioned_environment_dirs"
آیا به دنبال دایرکتوری‌های نسخه‌بندی‌شده محیط که از \fB$environmentpath/<environment>\fR پیوند نمادین دارند بگردد یا خیر\. این یک ویژگی تجربی است و باید با احتیاط استفاده شود\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBfalse\fR
.IP "" 0
.SS "waitforcert"
عامل پاپت هر چند وقت یک‌بار باید درخواست گواهی امضاشده کند\.
.P
هنگام شروع برای اولین بار، عامل پاپت یک درخواست امضای گواهی (CSR) به سرور مشخص‌شده در تنظیم \fBca_server\fR ارسال می‌کند؛ این ممکن است به طور خودکار امضا شود یا بسته به پیکربندی سرور CA نیاز به تأیید توسط یک انسان داشته باشد\.
.P
عامل پاپت نمی‌تواند پیکربندی‌ها را تا زمانی که گواهی تأییدشده آن در دسترس نباشد اعمال کند\. از آن‌جا که گواهی ممکن است بلافاصله در دسترس نباشد، عامل پاپت مکرراً تلاش می‌کند آن را در این بازه واکشی کند\. می‌توانید انتظار برای گواهی‌ها را با تعیین زمان 0 یا حداکثر زمان انتظار در تنظیم \fBmaxwaitforcert\fR غیرفعال کنید، که در این صورت اگر عامل نتواند گواهی بگیرد خارج می‌شود\. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB2m\fR
.IP "" 0
.SS "waitforlock"
عامل پاپت در صورت وجود نمونه در حال اجرای دیگری از عامل پاپت، هر چند وقت یک‌بار باید برای اجرا تلاش کند\.
.P
این آرگومان به طور پیش‌فرض غیرفعال است (مقدار 0)\. در این حالت عامل پاپت اگر در آن لحظه نتواند اجرا شود بلافاصله خارج خواهد شد\. وقتی مقداری غیر از 0 تنظیم شود، می‌توان از این مورد در ترکیب با آرگومان \fBmaxwaitforlock\fR نیز استفاده کرد\. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB0\fR
.IP "" 0
.SS "write_catalog_summary"
آیا پس از اعمال کاتالوگ، \fBclassfile\fR و \fBresourcefile\fR نوشته شوند یا خیر\. به طور پیش‌فرض فعال است، به جز هنگام اجرای \fBpuppet apply\fR\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fBtrue\fR
.IP "" 0
.SS "yamldir"
دایرکتوری‌ای که داده‌های YAML در آن ذخیره می‌شوند، معمولاً در یک زیردایرکتوری\.
.IP "\(bu" 4
\fIپیش‌فرض\fR: \fB$vardir/yaml\fR
.IP "" 0