.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "PUPPET\-DEVICE" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
.SH "نام (NAME)"
puppet\-device \- مدیریت دستگاه‌های شبکه از راه دور از طریق OpenVox
.SH "خلاصه دستور (SYNOPSIS)"
کاتالوگ‌ها را از سرور OpenVox دریافت کرده و آن‌ها را روی دستگاه‌های از راه دور اعمال می‌کند\.
.P
این زیردستور می‌تواند به‌صورت دستی، یا به‌طور دوره‌ای با استفاده از cron، یک وظیفه زمان‌بندی‌شده (scheduled task) یا ابزاری مشابه اجرا شود\.
.SH "نحوه استفاده (USAGE)"
puppet device [\-h|\-\-help] [\-v|\-\-verbose] [\-d|\-\-debug] [\-l|\-\-logdest syslog|\fIfile\fR|console] [\-\-detailed\-exitcodes] [\-\-deviceconfig \fIfile\fR] [\-w|\-\-waitforcert \fIseconds\fR] [\-\-libdir \fIdirectory\fR] [\-a|\-\-apply \fIfile\fR] [\-f|\-\-facts] [\-r|\-\-resource \fItype\fR [name]] [\-t|\-\-target \fIdevice\fR] [\-\-user=\fIuser\fR] [\-V|\-\-version]
.SH "توضیحات (DESCRIPTION)"
دستگاه‌ها برای درخواست گواهی‌ها، جمع‌آوری factها، دریافت و اعمال کاتالوگ‌ها، و ذخیره گزارش‌ها به یک عامل (agent) پراکسی OpenVox نیاز دارند\.
.SH "نکات استفاده (USAGE NOTES)"
دستگاه‌هایی که توسط زیردستور puppet\-device روی یک عامل OpenVox مدیریت می‌شوند، در device\.conf پیکربندی می‌گردند که به‌طور پیش‌فرض در $confdir/device\.conf قرار دارد و با تنظیم $deviceconfig قابل پیکربندی است\.
.P
فایل device\.conf یک فایل مشابه INI است که برای هر دستگاه یک بخش مجزا دارد:
.P
[\fIDEVICE_CERTNAME\fR] type \fITYPE\fR url \fIURL\fR debug
.P
نام بخش، certname دستگاه را مشخص می‌کند\.
.P
مقادیر ویژگی‌های type و url برای هر نوع دستگاه مختص همان نوع است\.
.P
ویژگی اختیاری debug اشکال‌زدایی در سطح لایه انتقال (transport) را مشخص می‌کند و محدود به روش‌های انتقال telnet و ssh است\.
.P
برای جزئیات بیشتر https://puppet\.com/docs/puppet/latest/config_file_device\.html را ببینید\.
.SH "گزینه‌ها (OPTIONS)"
توجه داشته باشید که هر تنظیمی که در فایل پیکربندی معتبر باشد، یک آرگومان بلند معتبر نیز به شمار می‌رود\. برای نمونه، 'server' یک پارامتر پیکربندی معتبر است، بنابراین می‌توانید '\-\-server \fIservername\fR' را به‌عنوان یک آرگومان مشخص کنید\.
.TP
\-\-help, \-h
چاپ این پیام راهنما\.
.TP
\-\-verbose, \-v
فعال‌سازی گزارش‌دهی پرجزئیات\.
.TP
\-\-debug, \-d
فعال‌سازی اشکال‌زدایی کامل\.
.TP
\-\-logdest, \-l
محل ارسال پیام‌های ثبت وقایع (لاگ)\. از میان 'syslog' (سرویس syslog در پوزیکس)، 'console'، یا مسیر یک فایل لاگ انتخاب کنید\. اگر اشکال‌زدایی یا گزارش‌دهی پرجزئیات فعال باشد، مقدار پیش‌فرض 'console' است؛ در غیر این صورت، پیش‌فرض 'syslog' خواهد بود\. مقصدهای متعدد را می‌توان با استفاده از یک فهرست جداشده با کاما تعیین کرد (مانند: \fB/path/file1,console,/path/file2\fR)\.
.IP
مسیری که به '\.json' ختم شود، خروجی ساختاریافته را در قالب JSON دریافت خواهد کرد\. با توجه به ماهیت الحاقی لاگ‌گیری، علامت پایانی ']' به‌طور خودکار در فایل لاگ نوشته نخواهد شد؛ برای معتبر بودن ساختار JSON باید این علامت به‌صورت دستی در انتهای فایل اضافه شود\.
.TP
\-\-detailed\-exitcodes
ارائه اطلاعات تراکنش از طریق کدهای خروج\. در صورت فعال بودن این گزینه، کد خروج '1' به این معنی است که حداقل یک دستگاه خطای کامپایل داشته است، کد خروج '2' به این معنی است که حداقل یک دستگاه تغییرات منابع داشته است، و کد خروج '4' به این معنی است که حداقل یک دستگاه با شکست منابع مواجه شده است\. کدهای خروج '3'، '5'، '6'، یا '7' نشان‌دهنده وقوع ترکیبی بیتی (bitwise) از کدهای خروج قبلی هستند\.
.TP
\-\-deviceconfig
مسیر فایل پیکربندی دستگاه برای puppet device\. پیش‌فرض: $confdir/device\.conf
.TP
\-\-waitforcert, \-w
این گزینه فقط برای مقصدهایی اهمیت دارد که هنوز گواهی ندارند و به‌طور پیش‌فرض با مقدار 120 (ثانیه) فعال است\. این امر باعث می‌شود puppet device هر 2 دقیقه یک‌بار از سرور استعلام کرده (poll) و درخواست امضای گواهی کند\. این قابلیت برای راه‌اندازی اولیه یک مقصد مفید است\. می‌توانید با تعیین مقدار زمان 0، انتظار برای گواهی‌ها را غیرفعال کنید\.
.TP
\-\-libdir
جایگزینی libdir مربوط به هر دستگاه با یک دایرکتوری محلی\. تعیین libdir همچنین pluginsync را غیرفعال می‌کند\. این گزینه برای آزمایش مفید است\.
.IP
مسیری که به '\.jsonl' ختم شود، خروجی ساختاریافته را در قالب خطوط JSON (JSON Lines) دریافت خواهد کرد\.
.TP
\-\-apply
اعمال یک مانیفست روی یک مقصد از راه دور\. تعیین مقصد (target) الزامی است\.
.TP
\-\-facts
نمایش factهای یک مقصد از راه دور\. تعیین مقصد (target) الزامی است\.
.TP
\-\-resource
نمایش وضعیت یک منبع به‌صورت کد Puppet، تقریباً معادل \fBpuppet resource\fR\. می‌تواند بر اساس عنوان فیلتر شود\. مستلزم تعیین \-\-target است\.
.TP
\-\-target
هدف‌گیری یک دستگاه/گواهی مشخص در device\.conf\. انجام این کار باعث می‌شود اجرای دستگاه فقط روی همان دستگاه/گواهی صورت گیرد\.
.TP
\-\-to_yaml
خروجی دادن منابع یافت‌شده در قالب yaml، مناسب برای استفاده با Hiera و create_resources\.
.TP
\-\-user
کاربری که دستور با هویت آن اجرا می‌شود\.
.SH "مثال (EXAMPLE)"
.nf
  $ puppet device \-\-target remotehost \-\-verbose
.fi
.SH "نویسنده (AUTHOR)"
Brice Figureau
.SH "حق نشر (COPYRIGHT)"
Copyright (c) 2011\-2018 Puppet Inc\., Copyright (c) 2024 Vox Pupuli Licensed under the Apache 2\.0 License