PUPPET-NODE(8) OpenVox manual PUPPET-NODE(8)

puppet-node - مشاهده و مدیریت تعاریف گره‌ها.

puppet node action [--terminus _TERMINUS]

این زیردستور با اشیاء گره (node objects) تعامل می‌کند؛ این اشیاء توسط OpenVox برای ساخت یک کاتالوگ استفاده می‌شوند. یک شیء گره متشکل از فکت‌های گره (facts)، محیط (environment)، پارامترهای گره (که در تجزیه‌کننده به عنوان متغیرهای دامنهٔ بالا یا top-scope در دسترس هستند) و کلاس‌ها است.

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

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

قالبی که خروجی در آن ارائه می‌شود. رایج‌ترین قالب‌ها عبارت‌اند از json، s (رشته)، yaml و console، اما گزینه‌های دیگری مانند dot نیز گاهی در دسترس هستند.
آیا گزارش‌ها با جزئیات کامل ثبت شوند یا خیر.
آیا اطلاعات اشکال‌زدایی ثبت شوند یا خیر.
رابط‌های Indirector (یا indirector faces) زیرسیستم‌های هدایت‌شده (indirected) در Puppet را در دسترس قرار می‌دهند. هر یک از این زیرسیستم‌ها می‌توانند نوع خاصی از داده‌ها را (با اقدامات آشنای find، search، save و destroy) از تعداد دلخواهی از بک‌اند‌های (backends) قابل اتصال بازیابی کرده و تغییر دهند. در اصطلاح Puppet، این بک‌اندها ترمینوس (terminuses) نامیده می‌شوند.
تقریباً تمام زیرسیستم‌های indirected دارای یک ترمینوس rest هستند که با داده‌های puppet master تعامل دارد. اکثر آن‌ها ترمینوس‌های دیگری نیز برای مدل‌های دادهٔ محلی گوناگون دارند که به نوبهٔ خود توسط زیرسیستم indirected در puppet master هنگام دریافت درخواست از راه دور استفاده می‌شوند.
ترمینوس برای یک اقدام معمولاً توسط زمینه تعیین می‌شود، اما گاهی اوقات لازم است به‌طور صریح تنظیم گردد. برای جزئیات بیشتر، بخش «نکات» در صفحه راهنمای این face را ببینید.

خلاصه دستور (SYNOPSIS)
puppet node clean [--terminus _TERMINUS] host1 [host2 ...]
توضیحات (DESCRIPTION)
اطلاعات زیر را که puppet master دربارهٔ یک گره می‌داند، پاک‌سازی می‌کند:
گواهی‌های امضاشده - ($vardir/ssl/ca/signed/node.domain.pem)
فکت‌های کش‌شده - ($vardir/yaml/facts/node.domain.yaml)
اشیاء گره کش‌شده - ($vardir/yaml/node/node.domain.yaml)
گزارش‌ها - ($vardir/reports/node.domain)
نکته: این اقدام اکنون گواهی‌ها را از طریق Puppet Server CA API پاک‌سازی می‌کند. برای پاک‌سازی گواهی‌ها به یک کارساز در حال اجرا نیاز است.
خلاصه دستور (SYNOPSIS)
puppet node decrypt [--terminus _TERMINUS] [-d DATA | --data DATA] [-e VARIABLE | --env VARIABLE]
توضیحات (DESCRIPTION)
یک مقدار را با استفاده از گواهی خود عامل رمزگشایی می‌کند. برای ارسال داده جهت رمزگشایی سه روش دارید. می‌توانید آن را مستقیماً در خط فرمان ارسال کنید (اگر هستهٔ شما چنین رشته‌های فرمانی طولانی را مجاز بداند)، می‌توانید آن را در یک متغیر محیطی تنظیم کرده و نام متغیر را ارسال کنید، یا می‌توانید آن را با استفاده از ورودی استاندارد (STDIN) هدایت (pipe) کنید.
گزینه‌ها (OPTIONS) -d DATA | --data DATA - رشته‌ای از داده‌ها برای رمزگشایی
-e VARIABLE | --env VARIABLE - یک متغیر محیطی حاوی داده‌ها برای رمزگشایی
خلاصه دستور (SYNOPSIS)
puppet node encrypt [--terminus _TERMINUS] [-t CERTNAME | --target CERTNAME] string
توضیحات (DESCRIPTION)
رمزنگاری یک مقدار با استفاده از گواهی یک عامل مشخص، که برای جای‌گذاری در یک مانیفست جهت نوع منبع node_encrypted_file یا برای مقدار داده در یک قطعهٔ datacat کاربرد دارد.
این اقدام تنها روی یک گره CA با دسترسی به گواهی عمومی امضاشدهٔ هر گره به‌درستی اجرا می‌شود.
گزینه‌ها (OPTIONS) -t CERTNAME | --target CERTNAME - کدام عامل برای رمزنگاری استفاده شود
خلاصه دستور (SYNOPSIS)
puppet node find [--terminus _TERMINUS] host
توضیحات (DESCRIPTION)
یک شیء گره را بازیابی می‌کند.
مقادیر بازگشتی (RETURNS)
یک درهم‌سازی (هش) شامل classes، environment، expiration، name، parameters (فکت‌های آن، ترکیب‌شده با هر پارامتر تنظیم‌شده توسط ENC) و time گره. هنگام استفاده از طریق Ruby API: یک شیء Puppet::Node.
مشکلات ارائه (RENDERING ISSUES): ارائه به صورت رشته (string) و json در حال حاضر کار نمی‌کند؛ اشیاء گره را فقط می‌توان به صورت yaml ارائه کرد.
خلاصه دستور (SYNOPSIS)
puppet node info [--terminus _TERMINUS]
توضیحات (DESCRIPTION)
کلاس ترمینوس پیش‌فرض را برای این زیردستور چاپ می‌کند. توجه داشته باشید که حالت‌های مختلف اجرا ممکن است ترمینوس‌های پیش‌فرض متفاوتی داشته باشند؛ در صورت تردید، حالت اجرا را با گزینهٔ '--run_mode' مشخص کنید.

decrypt

$ puppet node decrypt --data encrypted blob of data $ puppet node decrypt --env environment variable containing blob of encrypted data $ echo encrypted blob of data | puppet node decrypt $ cat /file/with/encrypted/blob.txt | puppet node decrypt

encrypt

$ puppet node encrypt --certname testhost.example.com "some text to encrypt"

find

بازیابی یک گره «خالی» (بدون کلاس، بدون پارامترهای اعمال‌شده از سوی ENC، و با محیط "production"):

$ puppet node find somenode.puppetlabs.lan --terminus plain --render-as yaml

بازیابی یک گره با استفاده از ENC پیکربندی‌شده در Puppet Server:

$ puppet node find somenode.puppetlabs.lan --terminus exec --run_mode server --render-as yaml

بازیابی همان گره از Puppet Server:

$ puppet node find somenode.puppetlabs.lan --terminus rest --render-as yaml

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

  • exec
  • json
  • memory
  • msgpack
  • plain
  • rest
  • store_configs
  • yaml

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

January 2025 Vox Pupuli