PUPPETCONF(5) OpenVox manual PUPPETCONF(5)

puppet.conf - پرونده پیکربندی اصلی پاپت

  • هر یک از این تنظیمات را می‌توان در puppet.conf یا در خط فرمان مشخص کرد.
  • نسخه سازمانی پاپت (PE) و پاپت متن‌باز در تنظیمات پیکربندی مستندشده در اینجا مشترک هستند. با این حال، مقادیر پیش‌فرض PE برای برخی تنظیمات با مقادیر پیش‌فرض متن‌باز متفاوت است، مانند node_terminus، storeconfigs، always_retry_plugins، disable18n، environment_timeout (زمانی که مدیر کد فعال است)، و تنظیم max-active-instances مربوط به JRuby سرور پاپت. برای بررسی پیش‌فرض‌های پیکربندی PE، پرونده puppet.conf یا pe-puppet-server.conf را پس از نصب بررسی کنید.
  • هنگام استفاده از تنظیمات بولی در خط فرمان، به جای --setting (true|false) از --setting و --no-setting استفاده کنید. (استفاده از --setting false منجر به خطای "Error: Could not parse application options: needless argument" می‌شود.)
  • تنظیمات را می‌توان به عنوان $variables در سایر تنظیمات درون‌یابی کرد؛ متغیر $environment ویژه است، زیرا سرور اصلی پاپت به جای محیط خود، محیط هر گره عامل را درون‌یابی می‌کند.
  • مقادیر چندگانه باید به صورت فهرست‌های جداشده با کاما مشخص شوند؛ چندین دایرکتوری باید با جداکننده مسیر سیستم (معمولاً دونقطه) از هم جدا شوند.
  • تنظیماتی که نشان‌دهنده بازه‌های زمانی هستند باید در قالب مدت‌زمان مشخص شوند: یک عدد صحیح که بلافاصله پس از آن یکی از واحدهای 'y' (سال‌های ۳۶۵ روزه)، 'd' (روز)، 'h' (ساعت)، 'm' (دقیقه)، یا 's' (ثانیه) می‌آید. این واحد نمی‌تواند با واحدهای دیگر ترکیب شود و در صورت حذف، به طور پیش‌فرض ثانیه در نظر گرفته می‌شود. نمونه‌ها عبارتند از '3600' که معادل '1h' (یک ساعت) است، و '1825d' که معادل '5y' (۵ سال) است.
  • اگر از تنظیم splay استفاده می‌کنید، توجه داشته باشید که مدت زمان انتظار با هر بار راه‌اندازی مجدد عامل پاپت تغییر می‌کند.
  • تنظیماتی که یک پرونده یا دایرکتوری منفرد دریافت می‌کنند، می‌توانند به صورت اختیاری مالک، گروه و مجوز دسترسی را برای مقدار خود تنظیم کنند: rundir = $vardir/run { owner = puppet, group = puppet, mode = 644 }
  • برنامه‌های اجرایی پاپت هر تنظیمی را که به عملکرد آن‌ها مربوط نباشد نادیده می‌گیرند.

برای جزئیات بیشتر به راهنمای پیکربندی در نشانی https://puppet.com/docs/puppet/latest/config_about_settings.html مراجعه کنید.

یک پرونده قفل برای نشان دادن این‌که اجرای کاتالوگ عامل پاپت در حال حاضر در حال انجام است. این پرونده حاوی شناسه فرآیند (PID) پردازشی است که قفل اجرای کاتالوگ را در اختیار دارد.

•
پیش‌فرض: $statedir/agent_catalog_run.lock

یک پرونده قفل برای نشان دادن این‌که اجرای عامل پاپت توسط مدیر سیستم غیرفعال شده است. پرونده حاوی یک شیء JSON با اطلاعات وضعیت است.

•
پیش‌فرض: $statedir/agent_disabled.lock

آیا درخواست گواهی جدید مجاز است درخواست گواهی موجود را بازنویسی کند یا خیر. در صورت تنظیم بر روی true، گواهی قدیمی باید با استفاده از puppetserver ca clean پاک شود و درخواست جدید با استفاده از puppetserver ca sign امضا گردد.

•
پیش‌فرض: false

آیا سریال‌سازی PSON مجاز باشد یا خیر. هنگامی که پاپت قادر به سریال‌سازی به JSON یا سایر قالب‌ها نباشد، به PSON بازمی‌گردد. این گزینه بر پاسخ‌های سرویس مدیریت پیکربندی سرور پاپت و فرآیندی که عامل توسط آن کاتالوگ حافظه پنهان خود را ذخیره می‌کند، تأثیر می‌گذارد. با مقدار پیش‌فرض false، این گزینه در جلوگیری از دست رفتن داده‌ها مفید است زیرا داده‌های غنی نمی‌توانند از طریق PSON سریال شوند.

•
پیش‌فرض: false

بر نحوه ذخیره تلاش‌ها برای بارگیری انواع منابع و قابلیت‌های پاپت در حافظه پنهان تأثیر می‌گذارد. در صورت تنظیم بر روی true، فراخوانی‌های Puppet.type.<type>? و Puppet.feature.<feature>? همیشه تلاش می‌کنند نوع یا قابلیت را بارگیری کنند (که می‌تواند عملیاتی سنگین باشد) مگر این‌که قبلاً با موفقیت بارگیری شده باشد. این امر باعث می‌شود که یک اجرای منفرد عامل بتواند به عنوان مثال بسته‌ای را نصب کند که قابلیت‌های اساسی یک نوع یا ویژگی را فراهم می‌آورد و سپس در همان اجرا آن نوع یا ویژگی را بارگیری نماید.

اگر این تنظیم بر روی false قرار گیرد، انواع و قابلیت‌ها فقط یک بار بررسی می‌شوند و اگر در دسترس نباشند، نتیجه منفی در حافظه پنهان ذخیره شده و برای تمام تلاش‌های بعدی برگردانده می‌شود. این رفتار تقریباً همیشه برای سرور مناسب است و می‌تواند عملکرد را برای انواعی که مکرراً بررسی می‌شوند بهبود بخشد.

•
پیش‌فرض: true

آیا پرونده‌های ثبت وقایع (لاگ) همیشه بلافاصله در دیسک تخلیه شوند یا خیر.

•
پیش‌فرض: true

آیا درخواست‌های گواهی به صورت خودکار امضا شوند (و چگونه). این تنظیم فقط روی سرور پاپتی که به عنوان مرجع صدور گواهی (CA) عمل می‌کند کاربرد دارد.

مقادیر مجاز عبارتند از true (امضای خودکار تمام درخواست‌های گواهی؛ توصیه نمی‌شود)، false (غیرفعال کردن امضای خودکار)، یا مسیر مطلق به یک پرونده.

پرونده مشخص‌شده در این تنظیم می‌تواند یک پرونده پیکربندی یا یک برنامه اجرایی خط‌مشی سفارشی باشد. پاپت به طور خودکار نوع آن را تشخیص می‌دهد: اگر کاربر پاپت (تنظیم user را ببینید) بتواند پرونده را اجرا کند، به عنوان یک برنامه خط‌مشی در نظر گرفته می‌شود؛ در غیر این صورت، به عنوان یک پرونده پیکربندی تلقی خواهد شد.

اگر یک برنامه اجرایی خط‌مشی سفارشی پیکربندی شود، سرور CA پاپت هر بار که CSR دریافت می‌کند آن را اجرا خواهد کرد. شناسه موضوع (Subject CN) درخواست به عنوان آرگومان خط فرمان و محتویات CSR در قالب PEM از طریق ورودی استاندارد (stdin) به برنامه ارسال می‌شود. اگر گواهی باید به طور خودکار امضا شود باید با وضعیت 0 و در غیر این صورت با مقدار غیرصفر خارج شود.

اگر درخواست گواهی به طور خودکار امضا نشود، برای بازبینی باقی می‌ماند. کاربر مدیر می‌تواند از دستور puppetserver ca sign برای امضای دستی آن استفاده کند، یا درخواست را حذف نماید.

برای اطلاعات درباره پرونده‌های پیکربندی امضای خودکار، به راهنمای پرونده‌های پیکربندی پاپت در نشانی https://puppet.com/docs/puppet/latest/config_file_autosign.html مراجعه کنید.

•
پیش‌فرض: $confdir/autosign.conf

مسیر جستجو برای ماژول‌های سراسری. باید به صورت فهرستی از دایرکتوری‌ها با جداکننده مسیر سیستم مشخص شود (جداکننده مسیر در POSIX علامت ':' و در ویندوز ';' است).

این‌ها ماژول‌هایی هستند که توسط تمام محیط‌ها استفاده خواهند شد. توجه داشته باشید که دایرکتوری modules محیط فعال بر هر دایرکتوری سراسری اولویت خواهد داشت. برای اطلاعات بیشتر به https://puppet.com/docs/puppet/latest/environments_about.html مراجعه کنید.

•
پیش‌فرض: $codedir/modules:/opt/puppetlabs/puppet/modules

پرونده پیکربندی پیونددهنده (binder). پاپت این پرونده را در هر درخواست برای پیکربندی سیستم پیوندها می‌خواند. اگر روی nil (پیش‌فرض) تنظیم شود، یک پرونده اختیاری $confdir/binder_config.yaml بارگیری می‌شود. اگر وجود نداشته باشد، از پیکربندی پیش‌فرض استفاده می‌شود. اگر تنظیم :binding_config مشخص شود، باید به یک پرونده معتبر و موجود yaml اشاره کند.

•
پیش‌فرض: ``

محل ذخیره پرونده‌های FileBucket.

•
پیش‌فرض: $vardir/bucket

اثر انگشت (فینگرپرینت) مورد انتظار گواهی CA. در صورت مشخص شدن، عامل اثر انگشت گواهی CA دانلودی را با این مقدار مقایسه کرده و در صورت عدم تطابق آن را رد می‌کند. این فقط در طول اولین دانلود گواهی CA اعمال می‌شود.

•
پیش‌فرض: ``

نام مورد استفاده برای گواهی مرجع صدور گواهی (CA).

•
پیش‌فرض: Puppet CA: $certname

درگاه (پورت) مورد استفاده برای مرجع صدور گواهی.

•
پیش‌فرض: $serverport

فاصله زمانی تازه‌سازی گواهی‌های CA محلی توسط عامل پاپت. به طور پیش‌فرض، گواهی‌های CA هر ۲۴ ساعت تازه‌سازی می‌شوند. اگر فاصله دیگری مشخص شود، چنانچه زمان سپری‌شده از آخرین تازه‌سازی از مدت مشخص‌شده فراتر رود، عامل گواهی‌های CA خود را در اجرای بعدی تازه‌سازی می‌کند.

به طور کلی، این فاصله باید بیشتر از مقدار runinterval باشد. تنظیم مقدار ca_refresh_interval بر روی 0 یا مقداری برابر یا کمتر از runinterval باعث می‌شود گواهی‌های CA در هر اجرا تازه‌سازی شوند.

اگر عامل گواهی‌های جدید CA را دانلود کند، از آن‌ها برای درخواست‌های شبکه بعدی استفاده می‌کند. اگر درخواست تازه‌سازی ناموفق باشد یا گواهی‌های CA روی سرور تغییری نکرده باشند، اجرای عامل با همان گواهی‌های CA محلی فعلی ادامه می‌یابد. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد.

•
پیش‌فرض: 1d

سرور مورد استفاده برای درخواست‌های مرجع صدور گواهی. این یک سرور مجزا است زیرا نمی‌تواند و نیازی ندارد که به صورت افقی مقیاس‌پذیر شود.

•
پیش‌فرض: $server

مدت زمان اعتبار پیش‌فرض (TTL) برای گواهی‌های جدید. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد.

•
پیش‌فرض: 5y

گواهی مرجع صدور گواهی (CA).

•
پیش‌فرض: $cadir/ca_crt.pem

فهرست ابطال گواهی (CRL) برای مرجع صدور گواهی.

•
پیش‌فرض: $cadir/ca_crl.pem

دایرکتوری ریشه برای مرجع صدور گواهی.

•
پیش‌فرض: /etc/puppetlabs/puppetserver/ca

کلید خصوصی مرجع صدور گواهی (CA).

•
پیش‌فرض: $cadir/ca_key.pem

کلید عمومی مرجع صدور گواهی (CA).

•
پیش‌فرض: $cadir/ca_pub.pem

نحوه ذخیره‌سازی کاتالوگ‌های در حافظه پنهان. مقادیر معتبر عبارتند از 'json'، 'msgpack' و 'yaml'. برنامه عامل به طور پیش‌فرض از 'json' استفاده می‌کند.

•
پیش‌فرض: ``

محل دریافت کاتالوگ‌های گره‌ها. این تنظیم زمانی مفید است که برای نمونه بخواهید کاتالوگ‌ها را از پیش کامپایل کرده و در memcached یا مخزن دیگری با دسترسی سریع ذخیره کنید.

•
پیش‌فرض: compiler

پرونده سیاهه گواهی‌ها. این یک پرونده متنی است که CA در آن فهرست کاملی از تمام گواهی‌ها را می‌نویسد.

•
پیش‌فرض: $cadir/inventory.txt

دایرکتوری گواهی‌ها.

•
پیش‌فرض: $ssldir/certs

آیا بررسی ابطال گواهی فعال باشد و چه سطحی از بررسی انجام گیرد.

هنگامی که بررسی ابطال گواهی فعال است، پاپت انتظار دارد محتوای CRL آن یک یا چند CRL با کدگذاری PEM باشد که به هم متصل شده‌اند. هنگام استفاده از بسته گواهی، CRLهای تمام CAها در زنجیره اعتماد باید در پرونده crl گنجانده شوند. زنجیره باید از کمترین تا معتبرترین مرتب شود، به طوری که اولین CRL برای ریشه زنجیره و آخرین برای CA برگ باشد.

هنگامی که certificate_revocation بر روی 'true' یا 'chain' تنظیم شود، پاپت اطمینان حاصل می‌کند که هیچ‌یک از CAها در زنجیره اعتماد توسط CA صادرکننده‌شان ابطال نشده باشند.

هنگامی که بر روی 'leaf' تنظیم شود، پاپت گواهی‌ها را در برابر فهرست ابطال CA صادرکننده بررسی می‌کند، اما وضعیت ابطال CA صادرکننده یا سطوح بالاتر در زنجیره اعتماد را بررسی نمی‌کند.

هنگامی که بر روی 'false' تنظیم شود، تمام بررسی‌های ابطال گواهی غیرفعال شده و تلاشی برای دانلود CRL انجام نمی‌شود.

•
پیش‌فرض: chain

نام مورد استفاده هنگام رسیدگی به گواهی‌ها. هنگامی که گره‌ای از سرور CA پاپت درخواست گواهی می‌کند، از مقدار تنظیم certname به عنوان Subject CN درخواستی خود استفاده می‌نماید.

این نامی است که هنگام مدیریت مجوزهای گره در auth.conf سرور پاپت در نشانی https://puppet.com/docs/puppetserver/latest/config_file_auth.html استفاده می‌شود. در بیشتر موارد، همچنین به عنوان نام گره هنگام تطبیق تعاریف گره در https://puppet.com/docs/puppet/latest/lang_node_definitions.html و درخواست داده از ENC به کار می‌رود.

نام گواهی گره در مانیفست‌های پاپت به صورت $trusted['certname'] در دسترس است (برای جزئیات بیشتر به Facts and Built-In Variables در https://puppet.com/docs/puppet/latest/lang_facts_and_builtin_vars.html مراجعه کنید).

  • برای بهترین سازگاری، مقدار certname را فقط به حروف کوچک، اعداد، نقطه، زیرخط و خط تیره محدود کنید (یعنی با /A[a-z0-9._-]+Z/ مطابقت داشته باشد).
  • مقدار ویژه ca رزرو شده است و نمی‌تواند به عنوان certname برای یک گره معمولی استفاده شود.
نکته: باید certname را در بخش main پرونده puppet.conf تنظیم کنید. تنظیم آن در بخش دیگر باعث بروز خطا می‌شود.

پیش‌فرض به نام دامنه کاملاً واجد شرایط (FQDN) گره تنظیم می‌شود.

•
پیش‌فرض: the Host's fully qualified domain name, as determined by Facter

فهرست مجموعه‌های رمزنگاری (ciphersuites) برای اتصالات TLS برقرارشده توسط پاپت. مقدار پیش‌فرض برای پشتیبانی از TLS 1.0 به بالا انتخاب شده است، اما در صورت نیاز می‌توان آن را محدودتر کرد. مجموعه‌های رمزنگاری باید در قالب OpenSSL مشخص شوند، نه IANA.

•
پیش‌فرض: ECDHE-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

پرونده‌ای که عامل پاپت فهرستی از کلاس‌های مرتبط با پیکربندی دریافت‌شده را در آن ذخیره می‌کند. می‌تواند در برنامه اجرایی مجزای puppet با استفاده از گزینه --loadclasses بارگیری شود.

•
پیش‌فرض: $statedir/classes.txt

دایرکتوری‌ای که داده‌های سریال‌شده در آن بر روی کلاینت ذخیره می‌شوند.

•
پیش‌فرض: $vardir/client_data

محل ذخیره محلی پرونده‌های FileBucket.

•
پیش‌فرض: $vardir/clientbucket

دایرکتوری‌ای که داده‌های YAML سمت کلاینت در آن ذخیره می‌شوند.

•
پیش‌فرض: $vardir/client_yaml

کد برای تجزیه مستقیم. این اساساً فقط توسط puppet استفاده می‌شود و فقط در صورتی باید تنظیم شود که برنامه اجرایی پاپت اختصاصی خود را می‌نویسید.

دایرکتوری اصلی کد پاپت. پیش‌فرض این تنظیم بر اساس کاربر محاسبه می‌شود. اگر فرآیند به عنوان root یا کاربری که پاپت باید تحت آن اجرا شود در حال اجرا باشد، به یک دایرکتوری سیستمی پیش‌فرض می‌شود، اما اگر تحت هر کاربر دیگری اجرا شود، در دایرکتوری خانگی کاربر قرار می‌گیرد.

•
پیش‌فرض: Unix/Linux: /etc/puppetlabs/code -- Windows: C:\ProgramData\PuppetLabs\code -- Non-root user: ~/.puppetlabs/etc/code

آیا هنگام ثبت وقایع در کنسول از رنگ‌ها استفاده شود یا خیر. مقادیر معتبر عبارتند از ansi (معادل true)، html و false که هیچ رنگی تولید نمی‌کند.

•
پیش‌فرض: ansi

دایرکتوری اصلی پیکربندی پاپت. پیش‌فرض این تنظیم بر اساس کاربر محاسبه می‌شود. اگر فرآیند به عنوان root یا کاربری که پاپت باید تحت آن اجرا شود اجرا شود، به دایرکتوری سیستمی پیش‌فرض می‌شود، اما اگر تحت هر کاربر دیگری اجرا شود، در دایرکتوری خانگی کاربر خواهد بود.

•
پیش‌فرض: Unix/Linux: /etc/puppetlabs/puppet -- Windows: C:\ProgramData\PuppetLabs\puppet\etc -- Non-root user: ~/.puppetlabs/etc/puppet

پرونده پیکربندی برای برنامه کاربردی جاری پاپت.

•
پیش‌فرض: $confdir/${config_file_name}

نام پرونده پیکربندی پاپت.

•
پیش‌فرض: puppet.conf

نحوه تعیین نسخه پیکربندی. به طور پیش‌فرض، زمانی خواهد بود که پیکربندی تجزیه می‌شود، اما می‌توانید یک اسکریپت شل ارائه دهید تا نحوه تعیین نسخه را بازنویسی کند. خروجی این اسکریپت به هر پیام ثبت وقایع در گزارش‌ها افزوده می‌شود و به شما امکان می‌دهد تغییرات روی میزبان‌های خود را با نسخه مبدأ روی سرور مرتبط سازید.

تنظیم مقدار سراسری برای config_version در puppet.conf مجاز نیست (اما می‌توان آن را از خط فرمان بازنویسی کرد). لطفاً به جای آن یک مقدار به ازای هر محیط در environment.conf تنظیم کنید. برای اطلاعات بیشتر به https://puppet.com/docs/puppet/latest/environments_about.html مراجعه کنید.

مقدار یک تنظیم پیکربندی خاص را چاپ می‌کند. اگر نام یک تنظیم برای این گزینه ارائه شود، مقدار آن چاپ شده و پاپت خارج می‌شود. برای مقادیر چندگانه از کاما استفاده کنید. برای فهرستی از تمام مقادیر، 'all' را مشخص نمایید. این تنظیم منسوخ شده است و دستور 'puppet config' جایگزین این قابلیت شده است.

فاصله زمانی تازه‌سازی فهرست ابطال گواهی (CRL) محلی توسط عامل پاپت. به طور پیش‌فرض، CRL هر ۲۴ ساعت تازه‌سازی می‌شود. اگر فاصله متفاوتی مشخص شود، چنانچه زمان سپری‌شده از آخرین تازه‌سازی از مقدار مشخص‌شده بیشتر باشد، عامل در اجرای بعدی پاپت CRL خود را تازه‌سازی می‌کند.

به طور کلی، این فاصله باید بیشتر از مقدار runinterval باشد. تنظیم crl_refresh_interval بر روی 0 یا مقداری برابر یا کمتر از runinterval باعث می‌شود CRL در هر بار اجرا تازه‌سازی شود.

اگر عامل CRL جدیدی دانلود کند، از آن برای درخواست‌های شبکه بعدی استفاده خواهد کرد. اگر درخواست تازه‌سازی با شکست مواجه شود یا CRL روی سرور تغییری نکرده باشد، اجرای عامل با CRL محلی فعلی ادامه می‌یابد. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد.

•
پیش‌فرض: 1d

یک پرونده اختیاری حاوی ویژگی‌های سفارشی برای افزودن به درخواست‌های امضای گواهی (CSR). باید مطمئن شوید این پرونده روی سرور CA پاپت شما وجود نداشته باشد؛ در صورت وجود، ممکن است پسوندهای ناخواسته گواهی به گواهی‌های ایجادشده با دستور puppetserver ca generate نفوذ کنند.

در صورت وجود، این پرونده باید یک درهم‌سازی YAML حاوی کلید custom_attributes و/یا کلید extension_requests باشد. مقدار هر کلید باید یک درهم‌سازی باشد که هر کلید آن یک OID معتبر و هر مقدار شیئی قابل تبدیل به رشته باشد.

ویژگی‌های سفارشی می‌توانند توسط CA هنگام تصمیم‌گیری برای امضای گواهی استفاده شوند، اما پس از آن کنار گذاشته می‌شوند. OID ویژگی‌ها می‌تواند هر مقدار OID به جز ویژگی‌های استاندارد CSR (یعنی ویژگی‌های شرح‌داده‌شده در RFC 2985 بخش ۵.۴) باشد. این امر برای تعبیه کلید از پیش اشتراک‌گذاری‌شده برای برنامه‌های خط‌مشی امضای خودکار مفید است (تنظیم autosign را ببینید)، که اغلب با استفاده از OID با شناسه 1.2.840.113549.1.9.7 انجام می‌گیرد.

درخواست‌های پسوند به طور دائم در گواهی نهایی تعبیه خواهند شد. OIDهای پسوند باید در شاخه‌های OID مربوط به "ppRegCertExt" (1.3.6.1.4.1.34380.1.1)، "ppPrivCertExt" (1.3.6.1.4.1.34380.1.2)، یا "ppAuthCertExt" (1.3.6.1.4.1.34380.1.3) باشند. شاخه ppRegCertExt برای چهار مورد از رایج‌ترین داده‌ها برای تعبیه رزرو شده است: pp_uuid (.1)، pp_instance_id (.2)، pp_image_name (.3)، و pp_preshared_key (.4) -- در پرونده YAML می‌توان به جای OID کامل به این موارد با نام‌های توصیفی کوتاه اشاره کرد.

•
پیش‌فرض: $confdir/csr_attributes.yaml

محل ذخیره درخواست‌های گواهی توسط CA.

•
پیش‌فرض: $cadir/requests

آیا فرآیند به پس‌زمینه فرستاده شود (دیمن شود) یا خیر. این گزینه در سیستم‌های POSIX به طور پیش‌فرض true و در ویندوز (که پاپت فعلاً نمی‌تواند دیمن شود) false است.

•
پیش‌فرض: true

این تنظیم منسوخ شده است. هر مقداری به جز 'hiera' باید در hiera.yaml نسخه ۵ پیکربندی شود. تا زمان حذف این تنظیم، کنترل می‌کند که از کدام پایانه پیوند داده برای پیوند داده‌های خودکار سراسری (در تمام محیط‌ها) استفاده شود. به طور پیش‌فرض این مقدار 'hiera' است. مقدار 'none' پیوند سراسری را خاموش می‌کند.

•
پیش‌فرض: hiera

مبدأ پیش‌فرض برای پرونده‌ها در صورتی که سروری در URI مشخص نشده باشد، مانند puppet:///file. پیش‌فرض rest باعث می‌شود پرونده با استفاده از تنظیم server دریافت شود. هنگام اجرای apply پیش‌فرض file_server است که باعث می‌شود درخواست‌ها به صورت محلی برآورده شوند.

•
پیش‌فرض: rest

مانیفست اصلی پیش‌فرض برای محیط‌های دایرکتوری. هر محیطی که تنظیم manifest را در پرونده environment.conf خود مشخص نکرده باشد از این مانیفست استفاده خواهد کرد.

مقدار این تنظیم می‌تواند یک مسیر مطلق یا نسبی باشد. یک مسیر مطلق باعث می‌شود همه محیط‌ها به طور پیش‌فرض از یک مانیفست اصلی استفاده کنند؛ یک مسیر نسبی به هر محیط اجازه می‌دهد از مانیفست خود استفاده کند و پاپت مسیر را نسبت به دایرکتوری اصلی هر محیط حل خواهد کرد.

در هر دو حالت، مسیر می‌تواند به یک پرونده منفرد یا دایرکتوری‌ای از مانیفست‌ها اشاره کند که به ترتیب الفبایی ارزیابی می‌شوند.

•
پیش‌فرض: ./manifests

بولی؛ آیا منابع زمان‌بندی پیش‌فرض ایجاد شوند یا خیر. تنظیم این مقدار بر روی false برای تمیز نگه داشتن پردازنده‌های گزارش خارجی از منابع زمان‌بندی نادیده گرفته شده مفید است.

•
پیش‌فرض: true

دایرکتوری ریشه $confdir دستگاه‌ها.

•
پیش‌فرض: $confdir/devices

مسیر به پرونده پیکربندی دستگاه برای puppet device.

•
پیش‌فرض: $confdir/device.conf

دایرکتوری ریشه $vardir دستگاه‌ها.

•
پیش‌فرض: $vardir/devices

دستور diff مورد استفاده هنگام چاپ تفاوت‌های بین پرونده‌ها. این تنظیم در ویندوز مقدار پیش‌فرضی ندارد، زیرا diff استاندارد در دسترس نیست، اما پاپت می‌تواند از ابزارهای diff متفرقه استفاده کند.

•
پیش‌فرض: diff

آرگومان‌هایی که هنگام چاپ تفاوت بین پرونده‌ها به دستور diff ارسال می‌شوند. دستور مورد استفاده را می‌توان با تنظیم diff انتخاب کرد.

•
پیش‌فرض: -u

الگوریتم خلاصه‌سازی (دایجِست) مورد استفاده برای منابع پرونده و filebucket. مقادیر معتبر عبارتند از sha256، sha384، sha512، sha224 و md5. پیش‌فرض sha256 است.

•
پیش‌فرض: sha256

اگر true باشد، تمام ترجمه‌های پیام‌های ثبت وقایع پاپت و ماژول‌ها خاموش می‌شود، که بر پیام‌های خطای لاگ، هشدار، اطلاعات، و هرگونه ترجمه در گزارش و خط فرمان تأثیر می‌گذارد.

•
پیش‌فرض: true

آیا مانیفست اصلی مخصوص یک محیط ممنوع شود یا خیر. هنگام تنظیم بر روی true، پاپت از مانیفست مشخص‌شده در تنظیم default_manifest برای تمام محیط‌ها استفاده می‌کند. اگر محیطی مانیفست اصلی متفاوتی را در پرونده environment.conf خود تعیین کند، درخواست‌های کاتالوگ برای آن محیط با خطا مواجه می‌شوند.

این تنظیم مستلزم این است که default_manifest روی یک مسیر مطلق تنظیم شده باشد.

•
پیش‌فرض: false

فهرستی از انواع هشدارهای جداشده با کاما برای سرکوب کردن. اگر تعداد زیادی از هشدارها لاگ‌های پاپت را بیش از حد بزرگ یا غیرقابل استفاده می‌کند، می‌توانید موقتاً با این تنظیم آن‌ها را بی‌صدا کنید.

اگر در حال آماده شدن برای ارتقای پاپت به یک نسخه اصلی جدید هستید، باید مدتی همه هشدارها را مجدداً فعال کنید.

مقادیر معتبر برای این تنظیم عبارتند از:

  • deprecations -- هشدارهای منسوخ شدن را غیرفعال می‌کند.
  • undefined_variables -- هشدارهای مربوط به متغیرهای ناموجود را غیرفعال می‌کند.
  • undefined_resources -- هشدارهای مربوط به منابع ناموجود را غیرفعال می‌کند.
  • پیش‌فرض: []

فهرستی از نام‌های جایگزین DNS برای سرور پاپت که با کاما از هم جدا شده‌اند. این‌ها نام‌های میزبان اضافی (علاوه بر certname آن) هستند که سرور مجاز است هنگام سرویس‌دهی به عامل‌ها از آن‌ها استفاده کند. پاپت هنگام ایجاد خودکار گواهی برای عامل یا سرور پاپت این تنظیم را بررسی می‌کند. این مقادیر می‌توانند IP یا DNS باشند، و نوع باید مشخص شده و دونقطه به دنبال آن بیاید. ورودی‌های بدون نوع به طور پیش‌فرض DNS در نظر گرفته می‌شوند.

به منظور پاسخگویی به درخواست‌های عامل در یک نام میزبان مشخص (مانند "puppet.example.com")، سرور پاپت به گواهی نیاز دارد که ثابت کند مجاز به استفاده از آن نام است؛ اگر سروری گواهی ارائه دهد که شامل نام میزبان آن نباشد، عامل‌های پاپت از اعتماد به آن خودداری می‌کنند. اگر از یک نام میزبان برای ترافیک پاپت استفاده می‌کنید اما آن را روی چندین سرور پاپت متعادل‌سازی بار (load-balance) می‌کنید، هر یک از آن سرورها باید نام میزبان رسمی را در فهرست نام‌های اضافی خود بگنجانند.

نکته: فهرست نام‌های جایگزین هنگام امضای گواهی سرور قفل می‌شود. اگر بعداً نیاز به تغییر فهرست داشته باشید، نمی‌توانید فقط این تنظیم را تغییر دهید؛ همچنین باید گواهی را دوباره تولید کنید. برای اطلاعات بیشتر به نشانی https://puppet.com/docs/puppet/latest/ssl_regenerate_certificates.html مراجعه کنید.

برای مشاهده تمام نام‌های جایگزینی که سرورهای شما استفاده می‌کنند، به سرور CA خود وارد شوید و دستور puppetserver ca list --all را اجرا کنید، سپس خروجی را برای (alt names: ...) بررسی نمایید. بیشتر گره‌های عامل نباید نام‌های جایگزین داشته باشند؛ تنها گواهی‌هایی که باید آن‌ها را داشته باشند گره‌های سرور پاپت هستند که می‌خواهید سایر عامل‌ها به آن‌ها اعتماد کنند.

آیا هنگام استفاده از puppet doc برای تولید مستندات مانیفست، تمام منابع مستندسازی شوند یا خیر.

•
پیش‌فرض: false

محیطی که پاپت در آن در حال اجرا است. برای کلاینت‌ها، مانند puppet agent، این خود محیط را تعیین می‌کند که پاپت برای یافتن ماژول‌ها و موارد دیگر از آن استفاده می‌نماید. برای سرورها، مانند puppet server، این محیط پیش‌فرض را برای گره‌هایی که پاپت چیزی درباره آن‌ها نمی‌داند فراهم می‌کند.

هنگام تعریف یک محیط در بخش [agent]، این به محیطی اشاره دارد که عامل از سرور اصلی درخواست می‌کند. نیازی نیست که محیط در سیستم پرونده محلی وجود داشته باشد زیرا عامل آن را از سرور اصلی واکشی می‌کند. این تعریف هنگام اجرای puppet agent استفاده می‌شود.

هنگامی که در بخش [user] تعریف شود، محیط به مسیری اشاره دارد که پاپت برای جستجوی کد و ماژول‌های مربوط به اجرای خود از آن استفاده می‌کند. این مستلزم آن است که محیط به صورت محلی در سیستم پرونده‌ای که پاپت در آن اجرا می‌شود وجود داشته باشد. دستورات فرعی پاپت، از جمله puppet module و puppet apply، از این تعریف استفاده می‌کنند.

با توجه به این‌که زمینه و اثرات بسته به بخش پیکربندی https://puppet.com/docs/puppet/latest/config_file_main.html#config-sections که تنظیم environment در آن تعریف شده متفاوت است، آن را به صورت سراسری تنظیم نکنید.

•
پیش‌فرض: production

نام ارائه‌دهنده داده‌های محیطی ثبت‌شده که هنگام به‌دست آوردن داده‌های خاص محیط استفاده می‌شود. سه ارائه‌دهنده داخلی و ثبت‌شده عبارتند از 'none' (بدون داده)، 'function' (داده‌های به‌دست آمده از فراخوانی تابع 'environment::data()') و 'hiera' (داده‌های به‌دست آمده با استفاده از ارائه‌دهنده داده پیکربندی‌شده با پرونده hiera.yaml در ریشه محیط). سایر ارائه‌دهندگان داده‌های محیط ممکن است در ماژول‌های موجود در مسیر ماژول ثبت شوند. این تنظیم منسوخ شده است.

•
پیش‌فرض: ``

چه مدت سرور پاپت باید داده‌هایی را که از یک محیط بارگیری می‌کند در حافظه پنهان نگه دارد.

مقدار 0 ذخیره‌سازی در حافظه پنهان را غیرفعال می‌کند. این تنظیم همچنین می‌تواند روی unlimited تنظیم شود که محیط‌ها را تا زمان راه‌اندازی مجدد سرور یا دستور تازه‌سازی حافظه پنهان ذخیره می‌کند. سایر مقادیر باعث می‌شوند سرور پاپت محیط‌هایی را که در طول environment_timeout ثانیه گذشته استفاده نشده‌اند، از حافظه پنهان خارج کند.

هنگامی که استقرار پاپت شما کارهای غیربدیهی انجام می‌دهد، باید این تنظیم را تغییر دهید. مقدار پیش‌فرض 0 انتخاب شده است زیرا به کاربران جدید اجازه می‌دهد بدون مراحل اضافی کد خود را به‌روزرسانی کنند، اما عملکرد سرور پاپت شما را کاهش می‌دهد. توصیه می‌کنیم یکی از این دو کار را انجام دهید:

  • این مقدار را روی unlimited قرار دهید و به عنوان بخشی از فرآیند استقرار کد، سرور پاپت خود را به صراحت تازه‌سازی کنید.
  • این مقدار را روی عددی تنظیم کنید که فعال‌ترین محیط‌های مورد استفاده شما را در حافظه پنهان نگه دارد، اما به محیط‌های آزمایشی اجازه دهد از حافظه پنهان خارج شوند تا مصرف حافظه کاهش یابد. مقدار ۳ دقیقه (3m) مقداری معقول است.

هنگامی که environment_timeout را روی یک مقدار غیرصفر تنظیم کردید، پس از استقرار کد جدید باید با استفاده از نقطه پایانی API به نام environment-cache به سرور پاپت بگویید کد جدید را از دیسک بخواند. به مستندات API مدیریتی سرور پاپت در نشانی https://puppet.com/docs/puppetserver/latest/admin-api/v1/environment-cache.html مراجعه کنید.

•
پیش‌فرض: 0

مسیر جستجو برای محیط‌های دایرکتوری، به صورت فهرستی از دایرکتوری‌ها که با نویسه جداکننده مسیر سیستم از هم جدا شده‌اند (جداکننده POSIX علامت ':' و ویندوز ';' است).

این تنظیم باید مقداری داشته باشد تا محیط‌های دایرکتوری فعال شوند. مقدار توصیه‌شده $codedir/environments است. برای جزئیات بیشتر به https://puppet.com/docs/puppet/latest/environments_about.html مراجعه کنید.

•
پیش‌فرض: $codedir/environments

آیا هر منبع هنگام ارزیابی شدن باید گزارش ثبت کند یا خیر. این به شما امکان می‌دهد دقیقاً آنچه را که انجام می‌شود به صورت تعاملی مشاهده کنید.

•
پیش‌فرض: false

نحوه فهرست شدن منابع تغییرنیافته در گزارش‌ها را مشخص می‌کند. در صورت تنظیم بر روی true، منابعی که پس از اعمال کاتالوگ تغییری نداشته‌اند، به‌روزرسانی وضعیت منبع تغییرنیافته مربوطه در گزارش فهرست نخواهد شد.

•
پیش‌فرض: true

اسکریپت دسته‌بندی‌کننده خارجی گره (ENC) برای استفاده از داده‌های گره. پاپت این داده‌ها را با مانیفست اصلی ترکیب می‌کند تا کاتالوگ‌های گره را تولید کند.

برای فعال کردن این تنظیم، تنظیم node_terminus را روی exec قرار دهید.

مقدار این تنظیم باید مسیر یک دستور اجرایی باشد که بتواند اطلاعات گره را تولید کند. این دستور باید:

  • نام یک گره را به عنوان آرگومان خط فرمان دریافت کند.
  • یک درهم‌سازی YAML با حداکثر سه کلید برگرداند:
  • classes -- فهرستی از کلاس‌ها، به صورت آرایه یا درهم‌سازی.
  • environment -- یک رشته.
  • parameters -- فهرستی از متغیرهای دامنه سطح بالا برای تنظیم، به صورت درهم‌سازی.
•
برای گره‌های ناشناخته، با کد خروج غیرصفر خارج شود.

به طور کلی، یک اسکریپت ENC درخواست‌هایی را به یک منبع داده خارجی ارسال می‌کند.

برای اطلاعات بیشتر، به مستندات ENC در https://puppet.com/docs/puppet/latest/nodes_external.html مراجعه کنید.

•
پیش‌فرض: none

حد نرم برای طول نام یک واقعیت (فکت).

•
پیش‌فرض: 2560

حد نرم برای طول مقدار یک واقعیت (فکت).

•
پیش‌فرض: 4096

محل جستجوی واقعیت‌ها (فکت‌ها) توسط پاپت. چندین دایرکتوری باید با نویسه جداکننده مسیر سیستم از هم جدا شوند (جداکننده POSIX علامت ':' و ویندوز ';' است).

•
پیش‌فرض: $vardir/lib/facter:$vardir/facts

پایانه واقعیت‌های گره.

•
پیش‌فرض: facter

محل ذخیره پیکربندی پرونده‌سرور (fileserver).

•
پیش‌فرض: $confdir/fileserver.conf

حداقل زمان انتظار بین بررسی به‌روزرسانی‌ها در پرونده‌های پیکربندی. این مهلت زمانی تعیین می‌کند که پاپت با چه سرعتی تغییر پرونده‌ها (مانند مانیفست‌ها یا puppet.conf) روی دیسک را بررسی کند. برای بازخوانی پرونده‌ها در یک محیط در سرور پاپت، لطفاً از نقطه پایانی environment_cache استفاده کنید.

•
پیش‌فرض: 15s

کلید مجوز برای اتصال به Puppet Forge. برای اتصالات غیرمجاز یا مبتنی بر مجوز خالی بگذارید.

•
پیش‌فرض: ``

کلاس 'main' را مسدود می‌کند و اجازه نمی‌دهد هیچ کدی به آن اضافه شود. این اساساً به این معنی است که شما نمی‌توانید کدی خارج از گره، کلاس یا تعریفی به جز در مانیفست سایت داشته باشید.

•
پیش‌فرض: false

در صورت true بودن، باعث می‌شود برنامه‌های پاپت یک پرونده پیکربندی نمونه را در خروجی استاندارد چاپ کرده و خارج شوند. این نمونه شامل توضیحات هر تنظیم و مقدار فعلی (یا پیش‌فرض) آن با اعمال تنظیمات بازنویسی‌شده در CLI خواهد بود. این تنظیم فقط زمانی معنا دارد که در خط فرمان به عنوان --genconfig مشخص شود.

•
پیش‌فرض: false

آیا فقط یک مانیفست در خروجی استاندارد چاپ شود و خارج گردد یا خیر. فقط زمانی معنا دارد که در خط فرمان به عنوان --genmanifest مشخص شود. آرگومان‌های مشخص‌شده در CLI را لحاظ می‌کند.

•
پیش‌فرض: false

آیا پرونده‌های نمودار .dot ایجاد شوند یا خیر، که به شما امکان می‌دهد روابط وابستگی و مهار را در کاتالوگ پاپت تجسم کنید. می‌توانید این پرونده‌ها را با ابزارهایی مانند OmniGraffle در نشانی http://www.omnigroup.com/applications/omnigraffle یا graphviz در http://www.graphviz.org مشاهده کنید.

پرونده‌های نمودار هنگام اعمال کاتالوگ ایجاد می‌شوند، بنابراین این تنظیم باید در گره‌هایی که puppet agent یا puppet apply را اجرا می‌کنند استفاده شود.

تنظیم graphdir تعیین می‌کند که پاپت نمودارها را در کجا ذخیره کند. توجه داشته باشید که نمودارها برای اجراهای گذشته ذخیره نمی‌شوند؛ پاپت هر بار که کاتالوگی را اعمال می‌کند، پرونده‌های .dot قبلی را با پرونده‌های جدید جایگزین خواهد کرد.

اگر از دستور dot در GraphViz استفاده می‌کنید، می‌توانید با dot -Tpng <DOT FILE> -o <OUTPUT FILE> یک رندر سریع PNG بگیرید.

•
پیش‌فرض: false

محل ذخیره نمودارهای قالب .dot (هنگامی که تنظیم graph فعال باشد).

•
پیش‌فرض: $statedir/graphs

گروهی که سرور پاپت تحت آن اجرا خواهد شد. برای اطمینان از این‌که فرآیندهای سمت عامل (agent، apply و غیره) در صورت لزوم پرونده‌ها و دایرکتوری‌های قابل خواندن توسط سرور پاپت را ایجاد می‌کنند، استفاده می‌شود.

•
پیش‌فرض: puppet

پرونده پیکربندی hiera. پاپت این پرونده را فقط در زمان راه‌اندازی می‌خواند، بنابراین هر بار که آن را ویرایش می‌کنید باید سرور پاپت را مجدداً راه‌اندازی کنید.

•
پیش‌فرض: $confdir/hiera.yaml. However, for backwards compatibility, if a file exists at $codedir/hiera.yaml, Puppet uses that instead.

جایی که میزبان‌های منفرد گواهی‌های خود را ذخیره کرده و به دنبال آن می‌گردند.

•
پیش‌فرض: $certdir/$certname.pem

عامل پاپت هر چند وقت یک‌بار گواهی کلاینت خود را تمدید کند. به طور پیش‌فرض، گواهی کلاینت ۳۰ روز قبل از انقضای گواهی تمدید می‌شود. اگر بازه دیگری مشخص شود، عامل گواهی کلاینت خود را در طول اجرای بعدی عامل تمدید می‌کند، با این فرض که گواهی کلاینت در مدت زمان مشخص‌شده منقضی شده باشد.

به طور کلی، مقدار hostcert_renewal_interval باید بیشتر از مقدار runinterval باشد. تنظیم مقدار hostcert_renewal_interval بر روی 0 تمدید خودکار را غیرفعال می‌کند.

این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد.

•
پیش‌فرض: 30d

محل یافتن فهرست ابطال گواهی (CRL) میزبان. این مورد متمایز از CRL مرجع صدور گواهی است.

•
پیش‌فرض: $ssldir/crl.pem

جایی که میزبان‌های منفرد درخواست گواهی (CSR) خود را در حین انتظار برای صدور گواهی توسط CA ذخیره می‌کنند.

•
پیش‌فرض: $requestdir/$certname.pem

محل ذخیره و جستجوی کلید خصوصی میزبان‌های منفرد.

•
پیش‌فرض: $privatekeydir/$certname.pem

محل ذخیره و جستجوی کلید عمومی میزبان‌های منفرد.

•
پیش‌فرض: $publickeydir/$certname.pem

حداکثر زمان انتظار هنگام برقراری اتصال HTTP. مقدار پیش‌فرض ۲ دقیقه است. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد.

•
پیش‌فرض: 2m

آیا درخواست‌ها و پاسخ‌های HTTP در خروجی خطای استاندارد (stderr) نوشته شوند یا خیر. این هرگز نباید در یک محیط عملیاتی استفاده شود.

•
پیش‌فرض: false

فهرست سرایندهای اضافی که همراه با درخواست‌های http به سرور اصلی ارسال می‌شوند. تعریف سرایند شامل یک نام و یک مقدار است که با دونقطه از هم جدا شده‌اند.

•
پیش‌فرض: []

حداکثر زمانی که یک اتصال پایدار HTTP می‌تواند در استخر اتصالات بیکار بماند قبل از این‌که بسته شود. این زمان باید کوتاه‌تر از زمان نگه‌داری اتصال سرور HTTP باشد (مانند دستور KeepAliveTimeout در آپاچی). این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد.

•
پیش‌فرض: 4s

میزبان پروکسی HTTP مورد استفاده برای اتصالات خروجی. اگر نام میزبان سرور با متغیر محیطی NO_PROXY یا تنظیم no_proxy مطابقت داشته باشد، پروکسی نادیده گرفته می‌شود. متغیر محیطی http_proxy یا HTTP_PROXY این مقدار را بازنویسی خواهد کرد.

•
پیش‌فرض: none

گذرواژه کاربر یک پروکسی احراز هویت‌شده HTTP. به تنظیم http_proxy_user نیاز دارد.

توجه داشته باشید که گذرواژه‌ها هنگام استفاده به عنوان بخشی از URL باید معتبر باشند. اگر گذرواژه‌ای حاوی نویسه‌های با معانی ویژه در URL باشد، باید به صورت درصد کدگذاری (URL-encode) شود (برای نمونه # به %23 تبدیل می‌شود).

•
پیش‌فرض: none

درگاه (پورت) پروکسی HTTP مورد استفاده برای اتصالات خروجی.

•
پیش‌فرض: 3128

نام کاربری برای یک پروکسی احراز هویت‌شده HTTP. به تنظیم http_proxy_host نیاز دارد.

•
پیش‌فرض: none

زمان انتظار برای خواندن داده‌ها از یک اتصال HTTP. اگر پس از گذشت این بازه چیزی خوانده نشود، اتصال بسته خواهد شد. مقدار پیش‌فرض ۱۰ دقیقه است. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد.

•
پیش‌فرض: 10m

رشته User-Agent پروتکل HTTP که هنگام برقراری درخواست‌های شبکه ارسال می‌شود.

•
پیش‌فرض: Puppet/<version> Ruby/<version> (<architecture>)

آیا اجرای پاپت باید خطاها را در طول pluginsync نادیده بگیرد یا خیر. اگر تنظیم false باشد و خطاهایی رخ دهد، عامل اجرا را لغو کرده و گزارشی حاوی اطلاعات درباره اجرای ناموفق ارسال می‌کند.

•
پیش‌فرض: false

صرف‌نظر کردن از جستجوی کلاس‌ها و تعاریفی که در کامپایل قبلی مفقود بوده‌اند. فهرست اشیاء مفقود به ازای هر محیط نگه‌داری می‌شود و تا زمانی که محیط پاک نشود یا سرور اصلی مجدداً راه‌اندازی نگردد باقی می‌ماند.

•
پیش‌فرض: false

بولی؛ آیا عامل پاپت باید زمان‌بندی‌ها را نادیده بگیرد یا خیر. این گزینه برای اجراهای اولیه عامل پاپت مفید است.

•
پیش‌فرض: false

آیا هنگام درخواست کاتالوگ، واقعیت‌های (فکت‌های) سنتی گنجانده شوند یا خیر. اگر تمام مانیفست‌های پاپت، hiera.yaml، و لایه‌های پیکربندی hiera دیگر به واقعیت‌های سنتی مانند $osfamily دسترسی ندارند و در عوض به واقعیت‌های ساختاریافته مانند $facts['os']['family'] دسترسی دارند، می‌توان این گزینه را روی false تنظیم کرد.

•
پیش‌فرض: false

نوع کلید خصوصی. مقادیر معتبر rsa و ec هستند. پیش‌فرض rsa است.

•
پیش‌فرض: rsa

طول بیت کلیدها.

•
پیش‌فرض: 4096

محل ذخیره خلاصه گزارش آخرین اجرا توسط عامل پاپت در قالب yaml.

•
پیش‌فرض: $publicdir/last_run_summary.yaml

محل ذخیره گزارش آخرین اجرا توسط عامل پاپت، به طور پیش‌فرض در قالب yaml. قالب گزارش را می‌توان با تنظیم کلید cache پایانه report در پرونده routes.yaml در نشانی https://puppet.com/docs/puppet/latest/config_file_routes.html تغییر داد.

•
پیش‌فرض: $statedir/last_run_report.yaml

ویژگی‌های LDAP برای گنجاندن هنگام پرس‌وجوی LDAP برای گره‌ها. تمام ویژگی‌های بازگردانده‌شده به عنوان متغیر در دامنه سطح بالا تنظیم می‌شوند. مقادیر چندگانه باید با کاما از هم جدا شوند. مقدار 'all' تمام ویژگی‌ها را برمی‌گرداند.

•
پیش‌فرض: all

پایه جستجو برای جستجوهای LDAP. ارائه یک مقدار پیش‌فرض معنادار در اینجا غیرممکن است، اگرچه ممکن است کتابخانه‌های LDAP از قبل مقداری تنظیم کرده باشند. به طور کلی باید شاخه 'ou=Hosts' زیر دایرکتوری اصلی شما باشد.

ویژگی‌های LDAP برای استفاده در تعریف کلاس‌های پاپت. مقادیر باید با کاما از هم جدا شوند.

•
پیش‌فرض: puppetclass

ویژگی مورد استفاده برای تعریف گره والد.

•
پیش‌فرض: parentnode

گذرواژه مورد استفاده برای اتصال به LDAP.

درگاه LDAP.

•
پیش‌فرض: 389

سرور LDAP.

•
پیش‌فرض: ldap

آیا هنگام جستجوی گره‌ها از SSL استفاده شود یا خیر. پیش‌فرض false است زیرا SSL معمولاً نیاز به تنظیم گواهی‌ها در سمت کلاینت دارد.

•
پیش‌فرض: false

ویژگی‌های LDAP که باید با افزودن مقادیر در تمام عناصر سلسله‌مراتبی درخت به صورت آرایه پشته شوند. مقادیر باید با کاما جدا شوند.

•
پیش‌فرض: puppetvar

رشته جستجوی مورد استفاده برای یافتن یک گره LDAP.

•
پیش‌فرض: (&(objectclass=puppetClient)(cn=%s))

آیا هنگام جستجوی گره‌ها از TLS استفاده شود یا خیر. پیش‌فرض false است زیرا TLS معمولاً نیاز به تنظیم گواهی‌ها در سمت کلاینت دارد.

•
پیش‌فرض: false

کاربر مورد استفاده برای اتصال به LDAP. باید به صورت یک DN کامل مشخص شود.

یک مسیر جستجوی اضافی برای پاپت. این فقط برای پرونده‌هایی مفید است که پاپت بر حسب تقاضا بارگیری می‌کند و فقط تضمین می‌شود که برای آن موارد کار کند. در واقع، سازوکار بارگیری خودکار مسئول اطمینان از قرار داشتن این دایرکتوری در مسیر جستجوی روبی است.

•
پیش‌فرض: $vardir/lib

محل ذخیره گواهی CA در هر کلاینت.

•
پیش‌فرض: $certdir/ca.pem

جایی که پاپت باید پرونده‌های ترجمه دریافتی از سرور مرکزی را ذخیره کند.

•
پیش‌فرض: $vardir/locales

مبدأ بازیابی پرونده‌های ترجمه. از نوع پرونده استاندارد پاپت (file) برای بازیابی استفاده می‌شود، بنابراین هر چیزی که یک مبدأ پرونده معتبر باشد می‌تواند در اینجا استفاده شود.

•
پیش‌فرض: puppet:///locales

این گزینه امکان ارسال نام + گذرواژه و سرایند کوکی را به تمام میزبان‌هایی که ممکن است پاپت به آن‌ها تغییر مسیر (redirect) دهد، فراهم می‌کند. اگر پاپت شما را به سایتی هدایت کند که اطلاعات احراز هویت و کوکی‌های خود را به آن ارسال می‌کنید، این ممکن است رخنه امنیتی ایجاد کند یا نکند.

•
پیش‌فرض: false

سطح پیش‌فرض ثبت وقایع برای پیام‌های پاپت. مقادیر مجاز عبارتند از:

  • debug
  • info
  • notice
  • warning
  • err
  • alert
  • emerg
  • crit
  • پیش‌فرض: notice

محل ارسال پیام‌های ثبت وقایع. از بین 'syslog' (سرویس لاگ سیستم POSIX)، 'eventlog' (لاگ رویدادهای ویندوز)، 'console' یا مسیر یک پرونده لاگ انتخاب کنید. مقاصد چندگانه را می‌توان با استفاده از یک فهرست جداشده با کاما تنظیم کرد (برای نمونه: /path/file1,console,/path/file2).

•
پیش‌فرض: ``

دایرکتوری‌ای که پرونده‌های ثبت وقایع در آن ذخیره می‌شوند.

•
پیش‌فرض: Unix/Linux: /var/log/puppetlabs/puppet -- Windows: C:\ProgramData\PuppetLabs\puppet\var\log -- Non-root user: ~/.puppetlabs/var/log

آیا پاپت باید مالک، گروه و مجوز دسترسی پرونده‌هایی را که در داخل استفاده می‌کند مدیریت کند یا خیر. نکته: برای عامل‌های ویندوز، پیش‌فرض برای نسخه‌های ۴.۱۰.۱۳ و بالاتر، نسخه‌های ۵.۵.۶ و بالاتر و نسخه‌های ۶.۰ و بالاتر برابر با false است.

•
پیش‌فرض: true

مانیفست نقطه ورود برای سرور اصلی. این می‌تواند یک پرونده یا دایرکتوری از مانیفست‌ها باشد که به ترتیب الفبایی ارزیابی می‌شوند. پاپت این مسیر را در صورت وجود یا اگر با / یا  به پایان برسد، به عنوان دایرکتوری مدیریت می‌کند.

تنظیم مقدار سراسری برای manifest در puppet.conf مجاز نیست (اما می‌توان آن را از خط فرمان بازنویسی کرد). لطفاً به جای آن از محیط‌های دایرکتوری استفاده کنید. اگر نیاز دارید از چیزی غیر از دایرکتوری manifests محیط به عنوان مانیفست اصلی استفاده کنید، می‌توانید manifest را در environment.conf تنظیم کنید. برای اطلاعات بیشتر به نشانی https://puppet.com/docs/puppet/latest/environments_about.html مراجعه کنید.

•
پیش‌فرض: ``

درگاه پیش‌فرضی که دستورات فرعی پاپت برای برقراری ارتباط با سرور پاپت استفاده می‌کنند (مانند puppet facts upload، puppet agent). ممکن است توسط تنظیمات خاص‌تر بازنویسی شود (ca_port، report_port را ببینید).

•
پیش‌فرض: 8140

حداکثر تعداد هشدارهای منسوخ شدن اعتبارسنجی تجزیه‌کننده را که در صورت شناسایی هشدارهای متعدد ثبت یا نمایش داده می‌شوند، تنظیم می‌کند. مقدار 0 مانع از ثبت هشدارهای منسوخ شدن می‌شود. شمارش به ازای هر مانیفست است.

•
پیش‌فرض: 10

حداکثر تعداد خطاهای اعتبارسنجی تجزیه‌کننده را که در صورت شناسایی خطاهای متعدد ثبت یا نمایش داده می‌شوند، تنظیم می‌کند. مقدار 0 همانند مقدار 1 است؛ همیشه حداقل یک خطا ایجاد می‌شود. شمارش به ازای هر مانیفست است.

•
پیش‌فرض: 10

حداکثر تعداد هشدارهای اعتبارسنجی تجزیه‌کننده را که در صورت شناسایی هشدارهای متعدد ثبت یا نمایش داده می‌شوند، تنظیم می‌کند. مقدار 0 مانع از ثبت هشدارها می‌شود. شمارش به ازای هر مانیفست است.

•
پیش‌فرض: 10

حداکثر UID مجاز. برخی پلتفرم‌ها از UIDهای منفی استفاده می‌کنند اما با ابزارهایی عرضه می‌شوند که نحوه رسیدگی به اعداد صحیح علامت‌دار را نمی‌دانند، بنابراین UIDها به صورت اعداد بسیار بزرگی نشان داده می‌شوند که نمی‌توان آن‌ها را مجدداً به سیستم برگرداند. این یک روش برای ایجاد خطای معنادارتر هنگام وقوع چنین وضعیتی است.

•
پیش‌فرض: 4294967290

حداکثر مدت زمانی که عامل پاپت باید برای امضای درخواست گواهی خود منتظر بماند. مقدار unlimited باعث می‌شود عامل پاپت به طور نامحدود درخواست گواهی امضاشده کند. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد.

•
پیش‌فرض: unlimited

حداکثر مدت زمانی که عامل پاپت باید قبل از شروع یک اجرای جدید، منتظر اتمام اجرای عامل پاپت در حال اجرا بماند. این مقدار به طور پیش‌فرض روی ۱ دقیقه تنظیم شده است. مقدار unlimited باعث انتظار نامحدود عامل پاپت می‌شود. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد.

•
پیش‌فرض: 1m

آیا هشدارهای شکست وابستگی در سطح کلاس ادغام شوند یا خیر.

هنگامی که یک کلاس با شکست در وابستگی مواجه می‌شود، هر منبع در کلاس یک پیام در سطح notice درباره شکست وابستگی و یک پیام در سطح warning درباره نادیده گرفتن منبع ایجاد می‌کند.

در صورت true بودن، تمام پیام‌های ناشی از شکست وابستگی کلاس در یک پیام مرتبط با آن کلاس ادغام می‌شوند.

•
پیش‌فرض: false

آیا کاربر و گروه لازم که عامل پاپت تحت آن اجرا می‌شود ایجاد شوند یا خیر.

•
پیش‌فرض: false

گروه‌های ماژول اضافی برای درخواست از Puppet Forge. این یک تنظیم داخلی است و کاربران هرگز نباید آن را تغییر دهند.

•
پیش‌فرض: ``

مخزن ماژول.

•
پیش‌فرض: https://forgeapi.puppet.com

دایرکتوری‌ای که داده‌های ابزار ماژول در آن ذخیره می‌شوند.

•
پیش‌فرض: $vardir/puppet-module

مسیر جستجو برای ماژول‌ها، به صورت فهرستی از دایرکتوری‌ها که با نویسه جداکننده مسیر سیستم از هم جدا شده‌اند (جداکننده POSIX علامت ':' و ویندوز ';' است).

تنظیم مقدار سراسری برای modulepath در puppet.conf مجاز نیست (اما می‌توان آن را از خط فرمان بازنویسی کرد). لطفاً به جای آن از محیط‌های دایرکتوری استفاده کنید. اگر نیاز به استفاده از مقداری غیر از مسیر پیش‌فرض <ACTIVE ENVIRONMENT'S MODULES DIR>:$basemodulepath دارید، می‌توانید modulepath را در environment.conf تنظیم کنید. برای اطلاعات بیشتر به نشانی https://puppet.com/docs/puppet/latest/environments_about.html مراجعه نمایید.

نام برنامه کاربردی، در صورتی که به عنوان یک برنامه در حال اجرا باشیم. پیش‌فرض اساساً 0$ بدون مسیر یا .rb است.

•
پیش‌فرض: ``

نام کوتاه برای منحنی EC مورد استفاده جهت تولید کلید خصوصی EC. مقادیر معتبر باید یکی از منحنی‌های موجود در OpenSSL::PKey::EC.builtin_curves باشد. پیش‌فرض prime256v1 است.

•
پیش‌فرض: prime256v1

فهرستی از نام‌های میزبان یا دامنه که نباید از طریق http_proxy_host عبور کنند. متغیر محیطی no_proxy یا NO_PROXY این مقدار را بازنویسی خواهد کرد. نام‌ها را می‌توان به صورت FQDN مانند host.example.com، عمومی مانند *.example.com، دامنه نقطه‌دار .example.com یا پسوند example.com مشخص کرد.

•
پیش‌فرض: localhost, 127.0.0.1

نحوه ذخیره گره‌های در حافظه پنهان. مقادیر معتبر عبارتند از (none)، 'json'، 'msgpack' یا 'yaml'.

•
پیش‌فرض: ``

نام واقعیتی (فکتی) که برای تعیین نام گره در تمام درخواست‌های ارسالی عامل به سرور اصلی استفاده می‌شود. هشدار: این تنظیم با node_name_value ناسازگار است. تغییر این تنظیم همچنین نیازمند تغییر در auth.conf پیش‌فرض سرور پاپت در نشانی https://puppet.com/docs/puppetserver/latest/config_file_auth.html است.

مقدار صریحی که برای نام گره در تمام درخواست‌های ارسالی عامل به سرور اصلی استفاده می‌شود. هشدار: این تنظیم با node_name_fact ناسازگار است. تغییر این تنظیم همچنین نیازمند تغییر در auth.conf پیش‌فرض سرور پاپت است.

•
پیش‌فرض: $certname

کدام پلاگین داده‌های گره هنگام کامپایل کاتالوگ‌های گره استفاده شود.

هنگامی که پاپت کاتالوگی را کامپایل می‌کند، دو منبع اصلی اطلاعات را ترکیب می‌کند: مانیفست اصلی و یک پلاگین داده‌های گره (که به دلایل تاریخی معمولاً "پایانه گره" نامیده می‌شود). پلاگین‌های داده‌های گره سه مورد را برای نام گره داده‌شده ارائه می‌دهند:

1.
فهرستی از کلاس‌ها برای افزودن به کاتالوگ آن گره (و به صورت اختیاری، مقادیر پارامترهای آن‌ها).
2.
محیط پاپتی که گره باید استفاده کند.
3.
فهرستی از متغیرهای دامنه سطح بالای اضافی برای تنظیم.

سه پلاگین اصلی داده‌های گره عبارتند از:

  • plain -- داده‌ای برنمی‌گرداند، بنابراین مانیفست اصلی تمام پیکربندی گره را کنترل می‌کند.
  • exec -- از یک دسته‌بندی‌کننده خارجی گره (ENC) در نشانی https://puppet.com/docs/puppet/latest/nodes_external.html که با تنظیم external_nodes پیکربندی شده است استفاده می‌کند.
  • classifier (که پیش‌تر console نامیده می‌شد) -- مخصوص Puppet Enterprise است و از کنسول PE برای داده‌های گره استفاده می‌کند.
  • پیش‌فرض: plain

آیا کاتالوگ‌ها در حالت noop اعمال شوند یا خیر، که به پاپت امکان می‌دهد یک اجرای عادی را تا حدی شبیه‌سازی کند. این تنظیم بر puppet agent و puppet apply تأثیر می‌گذارد.

هنگام اجرا در حالت noop، پاپت همانند اجرای عادی هماهنگ بودن هر منبع را بررسی می‌کند. با این حال، اگر صفت یک منبع در وضعیت مطلوب نباشد، پاپت اقدامی انجام نمی‌دهد و در عوض تغییراتی را که اعمال می‌کرد گزارش می‌دهد. این تغییرات شبیه‌سازی‌شده در گزارش ارسال‌شده به سرور پاپت نمایش داده خواهند شد.

نکته مهم: فراپارامتر noop در https://puppet.com/docs/puppet/latest/metaparameter.html#noop به شما اجازه می‌دهد منابع منفرد را در حالت noop اعمال کنید و بر مقدار سراسری تنظیم noop اولویت خواهد داشت. این بدان معناست که منبعی با noop => false در صورت نیاز تغییر داده خواهد شد، حتی زمانی که عامل با noop = true یا --noop اجرا شود.

•
پیش‌فرض: false

حد نرم برای تعداد کل مقادیر واقعیت‌ها (فکت‌ها). این شامل عناصر فرزند تمام واقعیت‌ها می‌شود (مانند تمام عناصر یک آرایه یا یک درهم‌سازی)، نه فقط واقعیت‌های سطح بالا.

•
پیش‌فرض: 10240

یک اجرای پیکربندی را انجام داده و خارج می‌شود، به جای اجرای یک دیمن با اجرای طولانی‌مدت. این گزینه برای اجرای تعاملی عامل پاپت یا اجرای عامل پاپت از طریق cron مفید است.

•
پیش‌فرض: false

جایی که عامل پاپت گذرواژه کلید خصوصی خود را ذخیره می‌کند. عموماً بدون استفاده است.

•
پیش‌فرض: $privatedir/password

مسیر جستجوی شل. پیش‌فرض به آنچه از فرآیند والد به ارث رسیده است تنظیم می‌شود.

این تنظیم فقط در بخش [main] پرونده puppet.conf قابل تنظیم است؛ نمی‌توان آن را در [server]، [agent] یا بخش پیکربندی محیط تنظیم کرد.

•
پیش‌فرض: none

حد نرم برای اندازه بار داده (payload).

•
پیش‌فرض: 16777216

پرونده حاوی PID فرآیند در حال اجرا. این پرونده برای استفاده توسط چارچوب‌های مدیریت سرویس و سیستم‌های مانیتورینگ در نظر گرفته شده تا مشخص شود آیا فرآیند پاپت هنوز در جدول فرآیندها حضور دارد یا خیر.

•
پیش‌فرض: $rundir/${run_mode}.pid

جایی که پاپت باید پلاگین‌های واکشی‌شده از سرور مرکزی را ذخیره کند.

•
پیش‌فرض: $libdir

جایی که پاپت باید واقعیت‌های خارجی مدیریت‌شده توسط pluginsync را ذخیره کند.

•
پیش‌فرض: $vardir/facts.d

مبدأ بازیابی واقعیت‌های خارجی برای pluginsync.

•
پیش‌فرض: puppet:///pluginfacts

پرونده‌هایی که باید هنگام بارگیری پلاگین‌ها نادیده گرفته شوند.

•
پیش‌فرض: .svn CVS .git .hg

مبدأ بازیابی پلاگین‌ها. از نوع پرونده استاندارد پاپت (file) برای بازیابی استفاده می‌شود، بنابراین هر چیزی که یک مبدأ پرونده معتبر باشد می‌تواند در اینجا استفاده شود.

•
پیش‌فرض: puppet:///plugins

آیا پلاگین‌ها باید با سرور مرکزی همگام‌سازی شوند یا خیر. این تنظیم منسوخ شده است.

•
پیش‌فرض: true

دستوری که پس از هر بار اجرای عامل اجرا می‌شود. اگر این دستور یک کد بازگشتی غیرصفر برگرداند، کل اجرای پاپت ناموفق تلقی خواهد شد، حتی اگر در طول اجرای عادی کارهایی را انجام داده باشد.

روش ترجیحی برای سریال‌سازی نمونه‌های روبی جهت انتقال روی شبکه. تضمین نمی‌شود که همه نمونه‌ها با این روش سریال شوند، اما برای تمام کلاس‌هایی که از آن پشتیبانی می‌کنند استفاده خواهد شد.

•
پیش‌فرض: json

آیا پاپت باید توابع به تعویق افتاده (deferred) را قبل از اعمال کاتالوگ فراخوانی کند یا خیر. در صورت تنظیم بر روی true، تمام پیش‌نیازهای مورد نیاز برای تابع به تعویق افتاده باید قبل از اجرای پاپت برآورده شوند. در صورت تنظیم بر روی false، توابع به تعویق افتاده از روابط و ترتیب‌بندی پاپت پیروی می‌کنند.

•
پیش‌فرض: false

دستوری که قبل از هر بار اجرای عامل اجرا می‌شود. اگر این دستور یک کد بازگشتی غیرصفر برگرداند، کل اجرای پاپت با شکست مواجه خواهد شد.

دایرکتوری‌ای که پیش‌نمایش کاتالوگ‌ها به ازای هر گره در آن تولید می‌شوند.

•
پیش‌فرض: $vardir/preview

اولویت زمان‌بندی فرآیند. مقادیر معتبر عبارتند از 'high'، 'normal'، 'low' یا 'idle'. اولویت را می‌توان به عنوان یک مقدار عددی صحیح نیز مشخص کرد، مانند -5. پاپت برای افزایش اولویت زمان‌بندی باید به عنوان یک کاربر دارای دسترسی ریشه (کاربر ارشد) اجرا شود.

•
پیش‌فرض: ``

جایی که کلاینت اطلاعات گواهی خصوصی را ذخیره می‌کند.

•
پیش‌فرض: $ssldir/private

دایرکتوری کلید خصوصی.

•
پیش‌فرض: $ssldir/private_keys

آیا تحلیل کارایی (profiling) تجربی فعال باشد یا خیر.

•
پیش‌فرض: false

جایی که پاپت پرونده‌های عمومی را ذخیره می‌کند.

•
پیش‌فرض: Unix/Linux: /opt/puppetlabs/puppet/public -- Windows: C:\ProgramData\PuppetLabs\puppet\public -- Non-root user: ~/.puppetlabs/opt/puppet/public

دایرکتوری کلید عمومی.

•
پیش‌فرض: $ssldir/public_keys

آیا ردپای پشته (stack trace) پاپت در برخی خطاها چاپ شود یا خیر. در صورتی که trace نیز تنظیم شده باشد، این گزینه بی اثر است.

•
پیش‌فرض: false

پرونده ثبت وقایع جایگزین (fallback). این فقط زمانی استفاده می‌شود که گزینه --logdest مشخص نشده باشد و پاپت روی سیستم‌عاملی اجرا شود که در آن هر دو سرویس syslog در POSIX و Event Log ویندوز در دسترس نباشند.

علیرغم این نام، هر دو عامل پاپت و سرور پاپت از این پرونده به عنوان مقصد لاگ جایگزین استفاده خواهند کرد.

برای کنترل مقاصد ثبت وقایع، به گزینه خط فرمان --logdest در صفحات راهنمای puppet server، puppet agent و puppet apply مراجعه کنید.

•
پیش‌فرض: $logdir/puppetd.log

آیا پس از هر تراکنش گزارش ارسال شود یا خیر.

•
پیش‌فرض: true

نحوه گزارش مسیرهای محیط را مشخص می‌کند. هنگامی که مقدار versioned_environment_dirs برابر با true باشد، پاپت تابع readlink را هنگام ساختن modulepath محیط روی تنظیم environmentpath اعمال می‌کند. مسیر کامل حل‌شده به عنوان "مسیر حل‌شده" و مسیر پیکربندی‌شده که احتمالاً شامل پیوندهای نمادین است به عنوان "مسیر پیکربندی‌شده" نامیده می‌شود.

در صورت تنظیم بر روی false، مسیرهای حل‌شده به جای مسیرهای پیکربندی‌شده گزارش می‌شوند.

•
پیش‌فرض: true

آیا پردازشگر گزارش 'http' هنگام ارسال گزارش‌ها به نشانی‌های HTTPS باید مخزن گواهی سیستم را لحاظ کند یا خیر. در صورت false بودن، پردازشگر 'http' فقط به سرورهای گزارشی اعتماد می‌کند که گواهی‌های آن‌ها توسط CA پاپت یا یکی از CAهای میانی آن صادر شده باشد.

•
پیش‌فرض: false

درگاه ارتباط با report_server.

•
پیش‌فرض: $serverport

سروری که گزارش‌های تراکنش به آن ارسال می‌شوند.

•
پیش‌فرض: $server

دایرکتوری ذخیره گزارش‌ها. هر گره یک زیردایرکتوری مجزا در این دایرکتوری دریافت می‌کند. این تنظیم فقط زمانی استفاده می‌شود که پردازشگر گزارش store فعال باشد (تنظیم reports را ببینید).

•
پیش‌فرض: $vardir/reports

فهرست گرداننده‌های گزارش مورد استفاده. هنگام استفاده از چندین گرداننده گزارش، نام‌های آن‌ها باید با کاما جدا شده و فاصله‌های خالی مجاز هستند (برای نمونه، reports = http, store).

این تنظیم به puppet server و puppet apply مربوط می‌شود. سرور اصلی پاپت این گرداننده‌های گزارش را با گزارش‌هایی که از گره‌های عامل دریافت می‌کند فراخوانی می‌نماید، و puppet apply آن‌ها را با گزارش خود فراخوانی خواهد کرد (در تمام موارد، گره اعمال‌کننده کاتالوگ باید report = true داشته باشد).

برای اطلاعات درباره گرداننده‌های گزارش داخلی به مرجع گزارش مراجعه کنید؛ گرداننده‌های سفارشی را نیز می‌توان از ماژول‌ها بارگیری کرد.

برای خاموش کردن کامل گزارش‌ها، این مقدار را روی none قرار دهید.

•
پیش‌فرض: store

نشانی URL که گزارش‌ها باید به آن بازارسال (فوروارد) شوند. این تنظیم فقط زمانی استفاده می‌شود که پردازشگر گزارش http فعال باشد (تنظیم reports را ببینید).

•
پیش‌فرض: http://localhost:3000/reports/upload

محل ذخیره درخواست‌های گواهی میزبان.

•
پیش‌فرض: $ssldir/certificate_requests

پرونده‌ای که عامل پاپت فهرستی از منابع مرتبط با پیکربندی دریافت‌شده را در آن ذخیره می‌کند.

•
پیش‌فرض: $statedir/resources.txt

آیا پس از هر تراکنش، واقعیت‌های (فکت‌های) به‌روزرسانی‌شده مجدداً ارسال شوند یا خیر. به طور پیش‌فرض پاپت فقط در ابتدای تراکنش قبل از اعمال کاتالوگ واقعیت‌ها را ارسال می‌کند. از آن‌جا که پاپت می‌تواند وضعیت سیستم را تغییر دهد، مقدار واقعیت‌ها ممکن است پس از پایان پاپت تغییر کند. بنابراین، هر واقعیتی که در puppetdb ذخیره شده ممکن است تا اجرای بعدی عامل (معمولاً در ۳۰ دقیقه آینده) سازگار نباشد. اگر این ویژگی فعال باشد، پاپت پس از اعمال کاتالوگ، فکت‌ها را مجدداً ارسال می‌کند و اطمینان حاصل می‌کند که فکت‌های ذخیره‌شده در puppetdb به‌روز هستند. با این حال، این کار بار ارسال فکت بر روی puppetdb را دو برابر می‌کند، بنابراین به طور پیش‌فرض غیرفعال است.

•
پیش‌فرض: false

فعال کردن وجود داده‌های گسترش‌یافته در کاتالوگ با ذخیره آن‌ها به عنوان یک درهم‌سازی با کلید ویژه __ptype. در صورت فعال بودن، منابع حاوی مقادیر انواع داده‌های Binary، Regexp، SemVer، SemVerRange، Timespan و Timestamp و همچنین نمونه‌هایی از انواع مشتق‌شده از Object نوع داده خود را حفظ می‌کنند.

•
پیش‌فرض: true

پرونده YAML حاوی پیکربندی مسیر indirector.

•
پیش‌فرض: $confdir/routes.yaml

محل نگه‌داری پرونده‌های PID پاپت.

•
پیش‌فرض: Unix/Linux: /var/run/puppetlabs -- Windows: C:\ProgramData\PuppetLabs\puppet\var\run -- Non-root user: ~/.puppetlabs/var/run

عامل پاپت هر چند وقت یک‌بار کاتالوگ را اعمال کند. توجه داشته باشید که runinterval برابر با 0 به معنای "اجرای پیوسته" است نه "هرگز اجرا نشدن". این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد.

•
پیش‌فرض: 30m

حداکثر مدت زمانی که یک اجرای عامل مجاز است طول بکشد. اجرای عاملی که از این مهلت فراتر رود لغو خواهد شد. مقدار 0 مهلت زمانی را غیرفعال می‌کند. پیش‌فرض ۱ ساعت است. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد.

•
پیش‌فرض: 1h

محل ذخیره شماره سریال گواهی‌ها.

•
پیش‌فرض: $cadir/serial

سرور اصلی پاپت که عامل پاپت باید به آن متصل شود.

•
پیش‌فرض: puppet

دایرکتوری‌ای که داده‌های سریال‌شده در آن ذخیره می‌شوند، معمولاً در یک زیردایرکتوری.

•
پیش‌فرض: $vardir/server_data

فهرست سرورهای اصلی پاپت که عامل پاپت باید به آن‌ها متصل شود، به ترتیبی که مورد آزمایش قرار می‌گیرند. هر مقدار باید یک نام دامنه کاملاً واجد شرایط (FQDN) باشد که به دنبال آن یک ':' اختیاری و شماره درگاه می‌آید. اگر درگاه حذف شود، پاپت از masterport برای آن میزبان استفاده می‌کند.

•
پیش‌فرض: []

درگاه پیش‌فرضی که دستورات فرعی پاپت برای برقراری ارتباط با سرور پاپت استفاده می‌کنند (مانند puppet facts upload، puppet agent). ممکن است توسط تنظیمات خاص‌تر بازنویسی شود (ca_port، report_port را ببینید).

•
پیش‌فرض: 8140

آیا کاتالوگ تنظیمات کامپایل و اعمال شود یا خیر.

•
پیش‌فرض: true

آیا هنگام جایگزینی پرونده‌ها، تفاوت متنی ثبت و گزارش شود یا خیر. این امر باعث می‌شود محتوای جزئی پرونده از سیستم ثبت و گزارش‌دهی عادی پاپت عبور کند، بنابراین در صورتی که گزارش‌های پاپت را به مقصدی ناامن ارسال می‌کنید باید با احتیاط استفاده شود. این قابلیت در حال حاضر نیازمند کتابخانه روبی diff/lcs است.

•
پیش‌فرض: false

محل ذخیره گواهی‌های امضاشده توسط CA.

•
پیش‌فرض: $cadir/signed

مشخص می‌کند که آیا اعلان مربوط به این‌که کدام کامپایلر کاتالوگ را ارائه داده سرکوب شود یا خیر. مقدار true اعلان را سرکوب می‌کند.

•
پیش‌فرض: false

برچسب‌های مورد استفاده برای پالایش منابع. در صورت تنظیم این گزینه، فقط منابعی که با این برچسب‌ها برچسب‌گذاری نشده‌اند اعمال خواهند شد. مقادیر باید با کاما جدا شوند.

نشانی‌ای که عامل باید برای شروع درخواست‌ها استفاده کند.

•
پیش‌فرض: ``

آیا قبل از انجام اولین اجرای عامل پس از راه‌اندازی مجدد سرویس، به مدت زمان تصادفی (از بلافاصله تا مقدار $splaylimit) به خواب برود یا خیر. پس از این دوره، عامل به صورت دوره‌ای بر اساس $runinterval خود اجرا می‌شود.

برای نمونه، با فرض یک $runinterval پیش‌فرض ۳۰ دقیقه‌ای، تنظیم splay روی مقدار پیش‌فرض false، و عاملی که در دقیقه 00: هر ساعت شروع به کار می‌کند، عامل هر ۳۰ دقیقه در دقایق 01: و 31: بررسی انجام می‌دهد.

با فعال بودن splay، قبل از اولین اجرای خود تا مقدار $splaylimit به هر میزانی منتظر می‌ماند. برای نمونه ممکن است ۸ دقیقه منتظر بماند و اولین اجرای خود را در دقیقه 08: آغاز کند. با فرض مقدار پیش‌فرض ۳۰ دقیقه، اجرای بعدی در دقیقه 38: خواهد بود.

اگر سرویس پاپت یک عامل را با فعال بودن splay مجدداً راه‌اندازی کنید، دوره splay را مجدداً محاسبه کرده و اولین اجرای پس از راه‌اندازی مجدد را به این دوره جدید موکول می‌کند. اگر گروهی از عامل‌های پاپت را همزمان با فعال بودن splay راه‌اندازی مجدد کنید، مراجعه آن‌ها به سرورهای اصلی به طور یکنواخت‌تری توزیع می‌شود.

•
پیش‌فرض: false

حداکثر زمان تاخیر قبل از اولین اجرای عامل هنگامی که splay فعال است. پیش‌فرض به $runinterval عامل تنظیم می‌شود. بازه splay تصادفی است و با هر بار شروع یا راه‌اندازی مجدد عامل دوباره محاسبه می‌شود. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد.

•
پیش‌فرض: $runinterval

دامنه‌ای که برای یافتن رکوردهای SRV سرورهای مورد استفاده پرس‌وجو خواهد شد.

•
پیش‌فرض: example.com

سرایند حاوی SSL DN کلاینت احراز هویت‌شده. این سرایند باید توسط پروکسی روی SSL DN کلاینت احراز هویت‌شده تنظیم شود (مانند /CN=puppet.puppetlabs.com). پاپت نام عمومی (CN) را از نام متمایز (DN) استخراج کرده و از مقدار فیلد CN برای مجوزدهی استفاده می‌کند.

توجه داشته باشید که نام سرایند HTTP توسط واسط دروازه مشترک (CGI) وب‌سرور تغییر داده می‌شود: یک پیشوند HTTP_ اضافه می‌شود، خط تيره‌ها به زیرخط تبدیل می‌شوند و تمام حروف بزرگ می‌شوند. بنابراین برای استفاده از سرایند X-Client-DN، این تنظیم باید HTTP_X_CLIENT_DN باشد.

•
پیش‌فرض: HTTP_X_CLIENT_DN

سرایند حاوی پیام وضعیت اعتبارسنجی کلاینت. اگر کلاینت با موفقیت احراز هویت شد این سرایند باید توسط پروکسی روی 'SUCCESS' تنظیم شود و در غیر این صورت هر مقدار دیگری.

توجه داشته باشید که نام سرایند HTTP توسط واسط دروازه مشترک (CGI) وب‌سرور تغییر داده می‌شود: یک پیشوند HTTP_ افزوده می‌شود، خط تیره‌ها به زیرخط تبدیل شده و تمام حروف بزرگ می‌شوند. بنابراین برای استفاده از سرایند X-Client-Verify، این تنظیم باید HTTP_X_CLIENT_VERIFY باشد.

•
پیش‌فرض: HTTP_X_CLIENT_VERIFY

پرونده قفلی برای نشان دادن این‌که فرآیند راه‌اندازی اولیه ssl در حال حاضر در حال انجام است.

•
پیش‌فرض: $ssldir/ssl.lock

پرونده‌ای حاوی گواهی‌های CA در قالب PEM که پاپت باید هنگام برقراری درخواست‌های HTTPS به آن‌ها اعتماد کند. این فقط برای درخواست‌های https به زیرساخت‌های غیر پاپت اعمال می‌شود، مانند بازیابی متاداده و محتوای پرونده از منابع پرونده https، ابزار ماژول پاپت و پردازشگر گزارش 'http'. این تنظیم هنگام برقراری درخواست‌ها به نشانی‌های //:puppet مانند کاتالوگ و درخواست‌های گزارش نادیده گرفته می‌شود.

•
پیش‌فرض: ``

محل نگه‌داری گواهی‌های SSL.

•
پیش‌فرض: $confdir/ssl

دایرکتوری‌ای که وضعیت پاپت در آن ذخیره می‌شود. به طور کلی این دایرکتوری را می‌توان بدون آسیب رساندن حذف کرد (اگرچه ممکن است منجر به راه‌اندازی‌های مجدد غیرضروری سرویس شود).

•
پیش‌فرض: $vardir/state

جایی که عامل پاپت و سرور پاپت وضعیت مرتبط با پیکربندی در حال اجرا را ذخیره می‌کنند. در مورد سرور پاپت، این پرونده وضعیت کشف‌شده از طریق تعامل با کلاینت‌ها را منعکس می‌کند.

•
پیش‌فرض: $statedir/state.yaml

عامل پاپت چه مدت باید آخرین باری را که یک منبع بررسی یا همگام‌سازی شده در حافظه پنهان نگه دارد. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد. مقدار 0 یا unlimited هرس حافظه پنهان را غیرفعال می‌کند.

این تنظیم بر استفاده از منابع schedule تأثیر می‌گذارد، زیرا اطلاعات مربوط به آخرین زمان بررسی یک منبع در statefile ذخیره می‌شود. مقدار statettl باید به اندازه کافی بزرگ باشد تا اطمینان حاصل شود که یک منبع به دلیل منقضی شدن مدخل آن از حافظه پنهان، چندین بار در طول یک زمان‌بندی اجرا نشود.

•
پیش‌فرض: 32d

آیا یک کاتالوگ ایستا در نشانی https://puppet.com/docs/puppet/latest/static_catalogs.html#enabling-or-disabling-static-catalogs کامپایل شود یا خیر، که فقط در سرور پاپت زمانی رخ می‌دهد که تنظیمات code-id-command و code-content-command در پرونده puppetserver.conf آن پیکربندی شده باشند.

•
پیش‌فرض: true

آیا پیکربندی هر کلاینت، از جمله کاتالوگ‌ها، واقعیت‌ها و داده‌های مرتبط ذخیره شود یا خیر. این همچنین وارد کردن و صادر کردن منابع در زبان پاپت را فعال می‌کند - سازوکاری برای تبادل منابع بین گره‌ها.

به طور پیش‌فرض از پشتیبان 'puppetdb' استفاده می‌شود.

می‌توانید با استفاده از تنظیم storeconfigs_backend این پشتیبان را تنظیم کنید.

•
پیش‌فرض: false

پایانه پشتیبان مورد استفاده برای StoreConfigs را پیکربندی می‌کند. به طور پیش‌فرض از مخزن PuppetDB استفاده می‌شود که باید قبل از روشن کردن StoreConfigs نصب و پیکربندی شده باشد.

•
پیش‌فرض: puppetdb

سطح سخت‌گیری پاپت. مقادیر مجاز عبارتند از:

  • off - اعتبارسنجی اضافی انجام ندهد، گزارش نکند
  • warning - اعتبارسنجی اضافی انجام دهد، به عنوان هشدار گزارش کند
  • error - اعتبارسنجی اضافی انجام دهد، با خطا متوقف شود (پیش‌فرض)

سطح سخت‌گیری هم برای معناشناسی زبان و هم برای اعتبارسنجی ارزیابی زمان اجرا است. علاوه بر کنترل رفتار با این کلید سرور اصلی، برخی از هشدارهای جداگانه ممکن است توسط تنظیم disable_warnings نیز کنترل شوند.

•
پیش‌فرض: error

آیا محیط مشخص‌شده توسط عامل باید معتبر و قطعی تلقی شود، به طوری که اگر کاتالوگ دریافت‌شده با آن مطابقت نداشت اجرا با شکست مواجه شود یا خیر.

•
پیش‌فرض: false

باعث بروز خطای ارزیابی هنگام ارجاع به متغیرهای ناشناخته می‌شود (این گزینه بر ارجاع به متغیرهایی که صریحاً روی undef تنظیم شده‌اند تأثیری ندارد).

•
پیش‌فرض: true

آیا خلاصه تراکنش چاپ شود یا خیر.

•
پیش‌فرض: false

انواع جمع‌آزمایی (checksum) پشتیبانی‌شده توسط این عامل برای استفاده در منابع پرونده یک کاتالوگ ایستا. مقادیر باید با کاما جدا شوند. انواع معتبر عبارتند از sha256، sha256lite، sha384، sha512، sha224، sha1، sha1lite، md5، md5lite، mtime و ctime.

•
پیش‌فرض: ["sha256", "sha384", "sha512", "sha224", "md5"]

کدام تسهیلات syslog هنگام ثبت وقایع در syslog استفاده شود. Syslog فهرست ثابتی از تسهیلات معتبر دارد و شما باید یکی از آن‌ها را انتخاب کنید؛ نمی‌توانید مقدار دلخواهی بسازید.

•
پیش‌فرض: daemon

برچسب‌های مورد استفاده برای یافتن منابع. در صورت تنظیم این گزینه، فقط منابعی که با برچسب‌های مشخص‌شده برچسب‌گذاری شده‌اند اعمال خواهند شد. مقادیر باید با کاما جدا شوند.

پشتیبانی تجربی از وظایف و برنامه‌ها را در زبان پاپت روشن می‌کند. این فقط برای استفاده از API داخلی است. این تنظیم را تغییر ندهید.

•
پیش‌فرض: false

حد نرم برای تعداد واقعیت‌های (فکت‌های) سطح بالا.

•
پیش‌فرض: 512

آیا در برخی خطاها ردپای پشته (stack trace) چاپ شود یا خیر. ردپای پشته داخلی روبی را همراه با فریم‌های تابع پاپت چاپ خواهد کرد.

•
پیش‌فرض: false

پرونده ذخیره‌سازی تراکنشی برای تداوم داده‌ها بین تراکنش‌ها به منظور استنتاج اطلاعات (مانند corrective_change) روی داده‌های جدید دریافت شده.

•
پیش‌فرض: $statedir/transactionstore.yaml

اسکریپت یا دایرکتوری واقعیت‌های مورد اعتماد خارجی برای استفاده. مقدار این تنظیم می‌تواند به مسیر یک دستور اجرایی تنظیم شود که می‌تواند فکت‌های مورد اعتماد خارجی را تولید کند یا به دایرکتوری حاوی آن دستورات اجرایی. دستور(ها) باید:

  • نام یک گره را به عنوان آرگومان خط فرمان دریافت کنند.
  • یک درهم‌سازی JSON با واقعیت‌های مورد اعتماد خارجی برای این گره برگردانند.
  • برای گره‌های ناشناخته یا نامعتبر، با کد خروج غیرصفر خارج شوند.

اگر تنظیم به یک دستور اجرایی اشاره کند، واقعیت‌های مورد اعتماد خارجی در کلید 'external' درهم‌سازی فکت‌های مورد اعتماد ذخیره می‌شوند. در غیر این صورت برای هر پرونده اجرایی در دایرکتوری، فکت‌های مورد اعتماد خارجی در کلید <basename> درهم‌سازی trusted['external'] ذخیره خواهند شد.

•
پیش‌فرض: ``

پرونده‌ای که نگاشت بین OIDهای سفارشی SSL و نام‌های کاربرپسند را فراهم می‌کند.

•
پیش‌فرض: $confdir/custom_trusted_oid_mapping.yaml

آیا فقط از کاتالوگ در حافظه پنهان استفاده شود به جای این‌که در هر اجرا کاتالوگ جدیدی کامپایل گردد. پاپت می‌تواند با فعال بودن پیش‌فرض این گزینه اجرا شود و سپس در صورت تمایل به کامپایل مجدد، به صورت گزینشی غیرفعال گردد. از آن‌جا که عامل پاپتی که از کاتالوگ‌های ذخیره‌شده استفاده می‌کند با سرور اصلی تماس نمی‌گیرد، در ابتدای اجرای پاپت فکت‌ها را نیز بارگذاری نمی‌کند.

•
پیش‌فرض: false

پاپت هر دو محیط اولیه و همگراشده را در پرونده last_run_summary ذخیره می‌کند. اگر آن‌ها متفاوت باشند و این تنظیم روی true باشد، ما از آخرین محیط همگراشده استفاده کرده و از درخواست گره صرف‌نظر می‌کنیم.

هنگامی که روی false تنظیم شود، درخواست گره را انجام داده و داده‌های محیط را از پرونده last_run_summary نادیده می‌گیریم.

•
پیش‌فرض: true

آیا سرور رکوردهای SRV را در DNS برای دامنه فعلی جستجو کند یا خیر.

•
پیش‌فرض: false

آیا هنگامی که پیکربندی راه دور کامپایل نمی‌شود، از پیکربندی ذخیره‌شده در حافظه پنهان استفاده شود یا خیر. این گزینه برای آزمایش پیکربندی‌های جدید مفید است، در مواردی که می‌خواهید پیکربندی خراب را اصلاح کنید به جای بازگشت به یک پیکربندی سالم شناخته‌شده.

•
پیش‌فرض: true

کاربری که سرور پاپت تحت آن اجرا خواهد شد. برای اطمینان از این‌که فرآیندهای سمت عامل (agent، apply و غیره) در صورت لزوم پرونده‌ها و دایرکتوری‌های قابل خواندن توسط سرور پاپت را ایجاد می‌کنند، استفاده می‌شود.

•
پیش‌فرض: puppet

محل ذخیره داده‌های پویا و در حال رشد توسط پاپت. مقدار پیش‌فرض این تنظیم به طور ویژه مانند confdir محاسبه می‌شود.

•
پیش‌فرض: Unix/Linux: /opt/puppetlabs/puppet/cache -- Windows: C:\ProgramData\PuppetLabs\puppet\cache -- Non-root user: ~/.puppetlabs/opt/puppet/cache

دایرکتوری حاوی ماژول‌های ارائه‌شده توسط فروشنده (vendored). این ماژول‌ها توسط تمام محیط‌ها مانند ماژول‌های موجود در basemodulepath استفاده خواهند شد. تنها تفاوت این است که ماژول‌های موجود در basemodulepath با pluginsync همگام می‌شوند، در حالی که ماژول‌های تأمین‌کننده این‌گونه نیستند.

•
پیش‌فرض: /opt/puppetlabs/puppet/vendor_modules

آیا به دنبال دایرکتوری‌های نسخه‌بندی‌شده محیط که از $environmentpath/<environment> پیوند نمادین دارند بگردد یا خیر. این یک ویژگی تجربی است و باید با احتیاط استفاده شود.

•
پیش‌فرض: false

عامل پاپت هر چند وقت یک‌بار باید درخواست گواهی امضاشده کند.

هنگام شروع برای اولین بار، عامل پاپت یک درخواست امضای گواهی (CSR) به سرور مشخص‌شده در تنظیم ca_server ارسال می‌کند؛ این ممکن است به طور خودکار امضا شود یا بسته به پیکربندی سرور CA نیاز به تأیید توسط یک انسان داشته باشد.

عامل پاپت نمی‌تواند پیکربندی‌ها را تا زمانی که گواهی تأییدشده آن در دسترس نباشد اعمال کند. از آن‌جا که گواهی ممکن است بلافاصله در دسترس نباشد، عامل پاپت مکرراً تلاش می‌کند آن را در این بازه واکشی کند. می‌توانید انتظار برای گواهی‌ها را با تعیین زمان 0 یا حداکثر زمان انتظار در تنظیم maxwaitforcert غیرفعال کنید، که در این صورت اگر عامل نتواند گواهی بگیرد خارج می‌شود. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد.

•
پیش‌فرض: 2m

عامل پاپت در صورت وجود نمونه در حال اجرای دیگری از عامل پاپت، هر چند وقت یک‌بار باید برای اجرا تلاش کند.

این آرگومان به طور پیش‌فرض غیرفعال است (مقدار 0). در این حالت عامل پاپت اگر در آن لحظه نتواند اجرا شود بلافاصله خارج خواهد شد. وقتی مقداری غیر از 0 تنظیم شود، می‌توان از این مورد در ترکیب با آرگومان maxwaitforlock نیز استفاده کرد. این تنظیم می‌تواند یک بازه زمانی بر حسب ثانیه (30 یا 30s)، دقیقه (30m)، ساعت (6h)، روز (2d)، یا سال (5y) باشد.

•
پیش‌فرض: 0

آیا پس از اعمال کاتالوگ، classfile و resourcefile نوشته شوند یا خیر. به طور پیش‌فرض فعال است، به جز هنگام اجرای puppet apply.

•
پیش‌فرض: true

دایرکتوری‌ای که داده‌های YAML در آن ذخیره می‌شوند، معمولاً در یک زیردایرکتوری.

•
پیش‌فرض: $vardir/yaml
January 2025 Vox Pupuli