.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "PUPPET\-NODE" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
.SH "نام (NAME)"
\fBpuppet\-node\fR \- مشاهده و مدیریت تعاریف گره‌ها\.
.SH "خلاصه دستور (SYNOPSIS)"
puppet node \fIaction\fR [\-\-terminus _TERMINUS]
.SH "توضیحات (DESCRIPTION)"
این زیردستور با اشیاء گره (node objects) تعامل می‌کند؛ این اشیاء توسط OpenVox برای ساخت یک کاتالوگ استفاده می‌شوند\. یک شیء گره متشکل از فکت‌های گره (facts)، محیط (environment)، پارامترهای گره (که در تجزیه‌کننده به عنوان متغیرهای دامنهٔ بالا یا top\-scope در دسترس هستند) و کلاس‌ها است\.
.SH "گزینه‌ها (OPTIONS)"
توجه داشته باشید هر تنظیمی که در فایل پیکربندی معتبر باشد، به عنوان یک آرگومان بلند نیز معتبر است، هرچند ممکن است به اقدام فعلی مرتبط باشد یا نباشد\. برای نمونه، \fBserver\fR و \fBrun_mode\fR تنظیمات معتبری هستند، بنابراین می‌توانید \fB\-\-server <servername>\fR یا \fB\-\-run_mode <runmode>\fR را به عنوان آرگومان مشخص کنید\.
.P
برای مشاهدهٔ فهرست کامل پارامترهای پذیرفتنی، مستندات فایل پیکربندی را در نشانی \fIhttps://puppet\.com/docs/puppet/latest/configuration\.html\fR ببینید\. همچنین می‌توان با اجرای puppet به همراه \fB\-\-genconfig\fR فهرستی حاوی توضیحات از تمام گزینه‌های پیکربندی تولید کرد\.
.TP
\-\-render\-as FORMAT
قالبی که خروجی در آن ارائه می‌شود\. رایج‌ترین قالب‌ها عبارت‌اند از \fBjson\fR، \fBs\fR (رشته)، \fByaml\fR و \fBconsole\fR، اما گزینه‌های دیگری مانند \fBdot\fR نیز گاهی در دسترس هستند\.
.TP
\-\-verbose
آیا گزارش‌ها با جزئیات کامل ثبت شوند یا خیر\.
.TP
\-\-debug
آیا اطلاعات اشکال‌زدایی ثبت شوند یا خیر\.
.TP
\-\-terminus _TERMINUS
رابط‌های Indirector (یا indirector faces) زیرسیستم‌های هدایت‌شده (indirected) در Puppet را در دسترس قرار می‌دهند\. هر یک از این زیرسیستم‌ها می‌توانند نوع خاصی از داده‌ها را (با اقدامات آشنای \fBfind\fR، \fBsearch\fR، \fBsave\fR و \fBdestroy\fR) از تعداد دلخواهی از بک‌اند‌های (backends) قابل اتصال بازیابی کرده و تغییر دهند\. در اصطلاح Puppet، این بک‌اندها ترمینوس (terminuses) نامیده می‌شوند\.
.IP
تقریباً تمام زیرسیستم‌های indirected دارای یک ترمینوس \fBrest\fR هستند که با داده‌های puppet master تعامل دارد\. اکثر آن‌ها ترمینوس‌های دیگری نیز برای مدل‌های دادهٔ محلی گوناگون دارند که به نوبهٔ خود توسط زیرسیستم indirected در puppet master هنگام دریافت درخواست از راه دور استفاده می‌شوند\.
.IP
ترمینوس برای یک اقدام معمولاً توسط زمینه تعیین می‌شود، اما گاهی اوقات لازم است به‌طور صریح تنظیم گردد\. برای جزئیات بیشتر، بخش «نکات» در صفحه راهنمای این face را ببینید\.
.SH "اقدامات (ACTIONS)"
.TP
\fBclean\fR \- پاک‌سازی گواهی‌های امضاشده، فکت‌های کش‌شده، اشیاء گره و گزارش‌های ذخیره‌شده توسط puppetmaster برای یک گره
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet node clean [\-\-terminus _TERMINUS] \fIhost1\fR [\fIhost2\fR \|\.\|\.\|\.]
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
اطلاعات زیر را که puppet master دربارهٔ یک گره می‌داند، پاک‌سازی می‌کند:
.IP
\fIگواهی‌های امضاشده\fR \- ($vardir/ssl/ca/signed/node\.domain\.pem)
.IP
\fIفکت‌های کش‌شده\fR \- ($vardir/yaml/facts/node\.domain\.yaml)
.IP
\fIاشیاء گره کش‌شده\fR \- ($vardir/yaml/node/node\.domain\.yaml)
.IP
\fIگزارش‌ها\fR \- ($vardir/reports/node\.domain)
.IP
نکته: این اقدام اکنون گواهی‌ها را از طریق Puppet Server CA API پاک‌سازی می‌کند\. برای پاک‌سازی گواهی‌ها به یک کارساز در حال اجرا نیاز است\.
.TP
\fBdecrypt\fR \- رمزگشایی یک مقدار با استفاده از گواهی خود عامل
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet node decrypt [\-\-terminus _TERMINUS] [\-d DATA | \-\-data DATA] [\-e VARIABLE | \-\-env VARIABLE]
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
یک مقدار را با استفاده از گواهی خود عامل رمزگشایی می‌کند\. برای ارسال داده جهت رمزگشایی سه روش دارید\. می‌توانید آن را مستقیماً در خط فرمان ارسال کنید (اگر هستهٔ شما چنین رشته‌های فرمانی طولانی را مجاز بداند)، می‌توانید آن را در یک متغیر محیطی تنظیم کرده و نام متغیر را ارسال کنید، یا می‌توانید آن را با استفاده از ورودی استاندارد (STDIN) هدایت (pipe) کنید\.
.IP
\fBگزینه‌ها (OPTIONS)\fR \fI\-d DATA\fR | \fI\-\-data DATA\fR \- رشته‌ای از داده‌ها برای رمزگشایی
.IP
\fI\-e VARIABLE\fR | \fI\-\-env VARIABLE\fR \- یک متغیر محیطی حاوی داده‌ها برای رمزگشایی
.TP
\fBencrypt\fR \- رمزنگاری یک مقدار با استفاده از گواهی یک عامل مشخص
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet node encrypt [\-\-terminus _TERMINUS] [\-t CERTNAME | \-\-target CERTNAME] \fIstring\fR
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
رمزنگاری یک مقدار با استفاده از گواهی یک عامل مشخص، که برای جای‌گذاری در یک مانیفست جهت نوع منبع node_encrypted_file یا برای مقدار داده در یک قطعهٔ datacat کاربرد دارد\.
.IP
این اقدام تنها روی یک گره CA با دسترسی به گواهی عمومی امضاشدهٔ هر گره به‌درستی اجرا می‌شود\.
.IP
\fBگزینه‌ها (OPTIONS)\fR \fI\-t CERTNAME\fR | \fI\-\-target CERTNAME\fR \- کدام عامل برای رمزنگاری استفاده شود
.TP
\fBfind\fR \- بازیابی یک شیء گره\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet node find [\-\-terminus _TERMINUS] \fIhost\fR
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
یک شیء گره را بازیابی می‌کند\.
.IP
\fBمقادیر بازگشتی (RETURNS)\fR
.IP
یک درهم‌سازی (هش) شامل \fBclasses\fR، \fBenvironment\fR، \fBexpiration\fR، \fBname\fR، \fBparameters\fR (فکت‌های آن، ترکیب‌شده با هر پارامتر تنظیم‌شده توسط ENC) و \fBtime\fR گره\. هنگام استفاده از طریق Ruby API: یک شیء Puppet::Node\.
.IP
مشکلات ارائه (RENDERING ISSUES): ارائه به صورت رشته (string) و json در حال حاضر کار نمی‌کند؛ اشیاء گره را فقط می‌توان به صورت yaml ارائه کرد\.
.TP
\fBinfo\fR \- چاپ کلاس ترمینوس پیش‌فرض برای این face\.
\fBخلاصه دستور (SYNOPSIS)\fR
.IP
puppet node info [\-\-terminus _TERMINUS]
.IP
\fBتوضیحات (DESCRIPTION)\fR
.IP
کلاس ترمینوس پیش‌فرض را برای این زیردستور چاپ می‌کند\. توجه داشته باشید که حالت‌های مختلف اجرا ممکن است ترمینوس‌های پیش‌فرض متفاوتی داشته باشند؛ در صورت تردید، حالت اجرا را با گزینهٔ '\-\-run_mode' مشخص کنید\.
.SH "مثال‌ها (EXAMPLES)"
\fBdecrypt\fR
.P
$ puppet node decrypt \-\-data \fIencrypted blob of data\fR $ puppet node decrypt \-\-env \fIenvironment variable containing blob of encrypted data\fR $ echo \fIencrypted blob of data\fR | puppet node decrypt $ cat /file/with/encrypted/blob\.txt | puppet node decrypt
.P
\fBencrypt\fR
.P
$ puppet node encrypt \-\-certname testhost\.example\.com "some text to encrypt"
.P
\fBfind\fR
.P
بازیابی یک گره «خالی» (بدون کلاس، بدون پارامترهای اعمال‌شده از سوی ENC، و با محیط "production"):
.P
$ puppet node find somenode\.puppetlabs\.lan \-\-terminus plain \-\-render\-as yaml
.P
بازیابی یک گره با استفاده از ENC پیکربندی‌شده در Puppet Server:
.P
$ puppet node find somenode\.puppetlabs\.lan \-\-terminus exec \-\-run_mode server \-\-render\-as yaml
.P
بازیابی همان گره از Puppet Server:
.P
$ puppet node find somenode\.puppetlabs\.lan \-\-terminus rest \-\-render\-as yaml
.SH "نکات (NOTES)"
این زیردستور یک indirector face است که اقدامات \fBfind\fR، \fBsearch\fR، \fBsave\fR و \fBdestroy\fR را برای یک زیرسیستم هدایت‌شده (indirected) در Puppet ارائه می‌دهد\. ترمینوس‌های معتبر برای این face عبارتند از:
.IP "\(bu" 4
\fBexec\fR
.IP "\(bu" 4
\fBjson\fR
.IP "\(bu" 4
\fBmemory\fR
.IP "\(bu" 4
\fBmsgpack\fR
.IP "\(bu" 4
\fBplain\fR
.IP "\(bu" 4
\fBrest\fR
.IP "\(bu" 4
\fBstore_configs\fR
.IP "\(bu" 4
\fByaml\fR
.IP "" 0
.SH "حق نشر و مجوز (COPYRIGHT AND LICENSE)"
حق نشر ۲۰۱۱ متعلق به Puppet Inc\.، مجوز Vox Pupuli Apache 2؛ پروندهٔ COPYING را ببینید