نام (NAME)

puppet-facts - بازیابی و نمایش حقایق و اطلاعات سیستم در Puppet

خلاصه دستور (SYNOPSIS)

puppet facts action [--terminus _TERMINUS]

توضیحات (DESCRIPTION)

این زیردستور فکت‌ها (حقایق) را مدیریت می‌کند؛ فکت‌ها مجموعه‌ای از اطلاعات استانداردشدهٔ سیستم هستند که توسط OpenVox مورد استفاده قرار می‌گیرند. این زیردستور می‌تواند حقایق را مستقیماً از سیستم محلی بخواند (با ترمینوس پیش‌فرض facter).

گزینه‌ها (OPTIONS)

توجه داشته باشید هر تنظیمی که در فایل پیکربندی معتبر باشد، به عنوان یک آرگومان بلند نیز معتبر است، هرچند ممکن است به اقدام فعلی مربوط باشد یا نباشد. برای نمونه، server و run_mode تنظیمات معتبری هستند، بنابراین می‌توانید --server <servername> یا --run_mode <runmode> را به عنوان آرگومان مشخص کنید.

برای مشاهدهٔ فهرست کامل پارامترهای پذیرفتنی، مستندات فایل پیکربندی را در نشانی https://puppet.com/docs/puppet/latest/configuration.html ببینید. همچنین می‌توان با اجرای puppet به همراه --genconfig فهرستی حاوی توضیحات از تمام گزینه‌های پیکربندی تولید کرد.

--render-as FORMAT: قالبی که خروجی در آن ارائه می‌شود. رایج‌ترین قالب‌ها عبارت‌اند از json، s (رشته)، yaml و console، اما گزینه‌های دیگری مانند dot نیز گاهی در دسترس هستند.
--verbose: آیا گزارش‌ها با جزئیات کامل ثبت شوند یا خیر.
--debug: آیا اطلاعات اشکال‌زدایی ثبت شوند یا خیر.
--terminus _TERMINUS: رابط‌های Indirector (یا indirector faces) زیرسیستم‌های هدایت‌شده (indirected) در Puppet را در دسترس قرار می‌دهند. هر یک از این زیرسیستم‌ها می‌توانند نوع خاصی از داده‌ها را (با اقدامات آشنای find، search، save و destroy) از تعداد دلخواهی از بک‌اند‌های (backends) قابل اتصال بازیابی کرده و تغییر دهند. در اصطلاح Puppet، این بک‌اندها ترمینوس (terminuses) نامیده می‌شوند.

: تقریباً تمام زیرسیستم‌های indirected دارای یک ترمینوس rest هستند که با داده‌های puppet master تعامل دارد. اکثر آن‌ها ترمینوس‌های دیگری نیز برای مدل‌های دادهٔ محلی گوناگون دارند که به نوبهٔ خود توسط زیرسیستم indirected در puppet master هنگام دریافت درخواست از راه دور استفاده می‌شوند.
: ترمینوس برای یک اقدام معمولاً توسط زمینه تعیین می‌شود، اما گاهی اوقات لازم است به‌طور صریح تنظیم گردد. برای جزئیات بیشتر، بخش «نکات (NOTES)» در صفحه راهنمای این face را ببینید.

اقدامات (ACTIONS)

find - بازیابی فکت‌های یک گره.: خلاصه دستور (SYNOPSIS)

: puppet facts find [--terminus _TERMINUS] [node_certname]
: توضیحات (DESCRIPTION)
: بازیابی فکت‌های یک گره.
: مقادیر بازگشتی (RETURNS)
: یک درهم‌سازی (هش) حاوی برخی فراداده‌ها و (زیر کلید "values") مجموعه‌ای از فکت‌ها برای گره درخواست‌شده. در صورت استفاده از API روبی: یک شیء Puppet::Node::Facts.
: مشکلات رندرینگ: فکت‌ها در حال حاضر نمی‌توانند به عنوان یک رشته نمایش داده شوند؛ از yaml یا json استفاده کنید.
: نکات (NOTES)
: هنگام استفاده از ترمینوس facter، آرگومان میزبان (host) نادیده گرفته می‌شود.

info - چاپ کلاس ترمینوس پیش‌فرض برای این face.: خلاصه دستور (SYNOPSIS)

: puppet facts info [--terminus _TERMINUS]
: توضیحات (DESCRIPTION)
: کلاس ترمینوس پیش‌فرض را برای این زیردستور چاپ می‌کند. توجه داشته باشید که حالت‌های مختلف اجرا ممکن است ترمینوس‌های پیش‌فرض متفاوتی داشته باشند؛ در صورت تردید، حالت اجرا را با گزینهٔ '--run_mode' مشخص کنید.

save - فقط برای API: ایجاد یا بازنویسی یک شیء.: خلاصه دستور (SYNOPSIS)

: puppet facts save [--terminus _TERMINUS] key
: توضیحات (DESCRIPTION)
: فقط برای API: ایجاد یا بازنویسی یک شیء. از آنجا که چارچوب Faces در حال حاضر داده‌ها را از STDIN نمی‌پذیرد، در حال حاضر نمی‌توان اقدامات save را از خط فرمان فراخوانی کرد.

show - بازیابی فکت‌های گره جاری.: خلاصه دستور (SYNOPSIS)

: puppet facts [--terminus _TERMINUS] [--config-file path] [--custom-dir path] [--external-dir path] [--no-block] [--no-cache] [--show-legacy] [--value-only] [--timing] [facts]
: توضیحات (DESCRIPTION)
: فکت‌ها را با استفاده از ترمینوس facter از سیستم محلی می‌خواند. می‌توان یک پرسمان (query) ارائه داد تا فقط یک فکت خاص یا مجموعه‌ای از فکت‌ها بازیابی شوند.
: گزینه‌ها (OPTIONS) --config-file <path> - مکان فایل پیکربندی برای Facter.
: --custom-dir <path> - مسیر دایرکتوری حاوی فکت‌های سفارشی.
: --external-dir <path> - مسیر دایرکتوری حاوی فکت‌های خارجی.
: --no-block - غیرفعال کردن سازوکار مسدودسازی فکت‌ها (fact blocking).
: --no-cache - غیرفعال کردن سازوکار کش فکت‌ها (fact caching).
: --show-legacy - نمایش فکت‌های قدیمی (legacy) هنگام پرسمان همه فکت‌ها.
: --timing - نمایش مدت زمان صرف‌شده برای حل و تعیین هر فکت.
: --value-only - تنها نمایش مقدار هنگامی که اقدام با یک پرسمان منفرد فراخوانی می‌شود.
: مقادیر بازگشتی (RETURNS)
: خروجی facter به همراه فکت‌های خاص اضافه شدهٔ Puppet.
: نکات (NOTES)

upload - بارگذاری فکت‌های محلی در puppet master.: خلاصه دستور (SYNOPSIS)

: puppet facts upload [--terminus _TERMINUS]
: توضیحات (DESCRIPTION)
: فکت‌ها را با استفاده از ترمینوس facter از سیستم محلی می‌خواند، سپس فکت‌های بازگردانده‌شده را با استفاده از ترمینوس rest ذخیره می‌کند.
: مقادیر بازگشتی (RETURNS)
: هیچ چیز.
: نکات (NOTES)
: این اقدام مستلزم آن است که فایل auth.conf در Puppet Server، دسترسی PUT یا save را به نقطه پایانی API یعنی /puppet/v3/facts مجاز بداند.
: برای جزئیات بیشتر در مورد پیکربندی auth.conf در Puppet Server، نشانی زیر را ببینید:
: https://puppet.com/docs/puppetserver/latest/config_file_auth.html

مثال‌ها (EXAMPLES)

find

دریافت فکت‌ها از سیستم محلی:

$ puppet facts find

show

بازیابی فکت‌ها:

$ puppet facts show os

upload

بارگذاری فکت‌ها:

$ puppet facts upload

نکات (NOTES)

این زیردستور یک indirector face است که اقدامات find، search، save و destroy را برای یک زیرسیستم هدایت‌شده (indirected) در Puppet ارائه می‌دهد. ترمینوس‌های معتبر برای این face عبارت‌اند از:

facter
json
memory
network_device
rest
store_configs
yaml

حق نشر و مجوز (COPYRIGHT AND LICENSE)

حق نشر ۲۰۱۱ متعلق به Puppet Inc.، مجوز Vox Pupuli Apache 2؛ فایل COPYING را ببینید

January 2025

Vox Pupuli