.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "PUPPET\-APPLY" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
.SH "نام (NAME)"
\fBpuppet\-apply\fR \- اعمال محلی مانیفست‌های Puppet از طریق OpenVox
.SH "خلاصه دستور (SYNOPSIS)"
یک مانیفست مستقل Puppet را روی سیستم محلی اعمال می‌کند\.
.SH "نحوه استفاده (USAGE)"
puppet apply [\-h|\-\-help] [\-V|\-\-version] [\-d|\-\-debug] [\-v|\-\-verbose] [\-e|\-\-execute] [\-\-detailed\-exitcodes] [\-L|\-\-loadclasses] [\-l|\-\-logdest syslog|eventlog|\fIABS FILEPATH\fR|console] [\-\-noop] [\-\-catalog \fIcatalog\fR] [\-\-write\-catalog\-summary] \fIfile\fR
.SH "توضیحات (DESCRIPTION)"
این ابزار اجرای مستقل puppet است؛ از آن برای اعمال تک‌تک مانیفست‌ها استفاده کنید\.
.P
هنگامی که مسیر ماژول‌ها (modulepath) از طریق خط فرمان یا فایل پیکربندی مشخص شود، puppet apply می‌تواند به‌خوبی کاتالوگی را که توسط سرور OpenVox با دسترسی به همان ماژول‌ها ارائه می‌شود شبیه‌سازی کند، اگرچه تفاوت‌های جزئی وجود دارد\. این ابزار اگر با زمان‌بندی و یک سامانه خودکار برای ارسال مانیفست‌ها ترکیب شود، می‌تواند برای پیاده‌سازی سایتی بدون سرور (serverless) به کار رود\.
.P
بیشتر کاربران باید برای مانیفست‌های سراسری سایت از 'puppet agent' و 'puppet master' استفاده کنند\.
.SH "گزینه‌ها (OPTIONS)"
هر تنظیمی که در فایل پیکربندی معتبر باشد، یک آرگومان بلند معتبر برای puppet apply نیز به شمار می‌رود\. برای نمونه، 'tags' یک تنظیم معتبر است، بنابراین می‌توانید '\-\-tags \fIclass\fR,\fItag\fR' را به عنوان یک آرگومان مشخص کنید\.
.P
برای فهرست کامل پارامترهای قابل قبول، مستندات فایل پیکربندی را در https://puppet\.com/docs/puppet/latest/configuration\.html مشاهده کنید\. همچنین می‌توانید با اجرای puppet به همراه '\-\-genconfig' فهرستی همراه با توضیح از تمام گزینه‌های پیکربندی تولید کنید\.
.IP "\(bu" 4
\-\-debug: فعال‌سازی اشکال‌زدایی کامل\.
.IP "\(bu" 4
\-\-detailed\-exitcodes: ارائه اطلاعات اضافی درباره اجرای برنامه از طریق کدهای خروج\. در صورت فعال بودن، 'puppet apply' از کدهای خروج زیر استفاده خواهد کرد:
.IP
0: اجرا بدون هیچ تغییر یا شکستی با موفقیت انجام شد؛ سیستم از پیش در وضعیت مطلوب قرار داشته است\.
.IP
1: اجرا با شکست مواجه شد\.
.IP
2: اجرا با موفقیت انجام شد و برخی از منابع تغییر یافتند\.
.IP
4: اجرا با موفقیت انجام شد، اما برخی منابع با شکست مواجه شدند\.
.IP
6: اجرا با موفقیت انجام شد و شامل هر دو موردِ تغییرات و شکست‌ها بود\.
.IP "\(bu" 4
\-\-help: چاپ این پیام راهنما\.
.IP "\(bu" 4
\-\-loadclasses: بارگذاری کلاس‌های ذخیره‌شده\. دستور 'puppet agent' کلاس‌های پیکربندی‌شده را ذخیره (کش) می‌کند (معمولاً در /etc/puppetlabs/puppet/classes\.txt)، و تنظیم این گزینه باعث می‌شود تمامی آن کلاس‌ها در مانیفست puppet شما تنظیم شوند\.
.IP "\(bu" 4
\-\-logdest: محل ارسال پیام‌های ثبت وقایع (لاگ)\. از میان 'syslog' (سرویس syslog در پوزیکس)، 'eventlog' (ثبت رویدادهای ویندوز)، 'console' (کنسول)، یا مسیر یک فایل لاگ انتخاب کنید\. مقدار پیش‌فرض 'console' است\. مقصدهای متعدد را می‌توان با استفاده از یک فهرست جداشده با کاما تعیین کرد (مانند: \fB/path/file1,console,/path/file2\fR)\.
.IP
مسیری که به '\.json' ختم شود، خروجی ساختاریافته را در قالب JSON دریافت خواهد کرد\. با توجه به ماهیت الحاقی لاگ‌گیری، علامت پایانی ']' به‌طور خودکار در فایل لاگ نوشته نخواهد شد؛ برای معتبر بودن ساختار JSON باید این علامت به صورت دستی در انتهای فایل اضافه شود\.
.IP
مسیری که به '\.jsonl' ختم شود، خروجی ساختاریافته را در قالب خطوط JSON (JSON Lines) دریافت خواهد کرد\.
.IP "\(bu" 4
\-\-noop: استفاده از حالت 'noop' که در آن Puppet در حالت بدون عملیات (no\-op) یا اجرای آزمایشی (dry\-run) کار می‌کند\. این حالت برای مشاهده تغییراتی که پاپت بدون اعمال واقعی آن‌ها ایجاد خواهد کرد، مفید است\.
.IP "\(bu" 4
\-\-execute: اجرای یک قطعه کد مشخص از Puppet\.
.IP "\(bu" 4
\-\-test: فعال‌سازی رایج‌ترین گزینه‌های مورد استفاده برای آزمایش\. این گزینه‌ها شامل 'verbose'، 'detailed\-exitcodes' و 'show_diff' هستند\.
.IP "\(bu" 4
\-\-verbose: چاپ اطلاعات اضافی\.
.IP "\(bu" 4
\-\-catalog: اعمال یک کاتالوگ JSON (مانند کاتالوگ تولیدشده با 'puppet master \-\-compile')\. می‌توانید یک فایل JSON را مشخص کنید یا داده‌های JSON را از طریق ورودی استاندارد (standard input) هدایت (pipe) کنید\.
.IP "\(bu" 4
\-\-write\-catalog\-summary: پس از کامپایل کاتالوگ، فهرست منابع و فهرست کلاس‌ها را در دایرکتوری وضعیت گره در فایل‌هایی به نام classes\.txt و resources\.txt ذخیره می‌کند\.
.IP "" 0
.SH "مثال (EXAMPLE)"
.nf
$ puppet apply \-e 'notify { "hello world": }'
$ puppet apply \-l /tmp/manifest\.log manifest\.pp
$ puppet apply \-\-modulepath=/root/dev/modules \-e "include ntpd::server"
$ puppet apply \-\-catalog catalog\.json
.fi
.SH "نویسنده (AUTHOR)"
Luke Kanies
.SH "حق نشر (COPYRIGHT)"
Copyright (c) 2011 Puppet Inc\. Copyright (c) 2024 Vox Pupuli Licensed under the Apache 2\.0 License