.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "PUPPET\-RESOURCE" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
.SH "نام (NAME)"
puppet-resource \- پوسته لایه انتزاع منبع (RAL) در OpenVox
.SH "خلاصه دستور (SYNOPSIS)"
از OpenVox RAL برای تعامل مستقیم با سیستم استفاده می‌کند\.
.SH "نحوه استفاده (USAGE)"
puppet resource [\-h|\-\-help] [\-d|\-\-debug] [\-v|\-\-verbose] [\-e|\-\-edit] [\-p|\-\-param \fIparameter\fR] [\-t|\-\-types] [\-y|\-\-to_yaml] \fItype\fR [\fIname\fR] [\fIattribute\fR=\fIvalue\fR \|\.\|\.\|\.]
.SH "توضیحات (DESCRIPTION)"
این دستور امکانات ساده‌ای را برای تبدیل وضعیت فعلی سیستم به کد Puppet، همراه با توانایی تغییر وضعیت فعلی با استفاده از لایه انتزاع منبع (RAL) پاپت فراهم می‌کند\.
.P
به‌طور پیش‌فرض، حداقل باید یک نوع (type) را برای فهرست کردن مشخص کنید، که در این صورت puppet resource تمام اطلاعات خود را درباره تمامی منابع از آن نوع به شما ارائه می‌دهد\. همچنین می‌توانید به‌صورت اختیاری یک نام نمونه (instance name) مشخص کنید تا puppet resource فقط همان یک نمونه را توصیف کند\.
.P
اگر یک نوع، یک نام، و مجموعه‌ای از جفت‌های
.IR attribute = value
داده شود، puppet resource وضعیت منبع مشخص‌شده را تغییر می‌دهد\. در غیر این صورت، اگر یک نوع، یک نام، و گزینه
.B \-\-edit
داده شود، puppet resource خروجی خود را در یک فایل می‌نویسد، آن فایل را در یک ویرایشگر باز می‌کند، و سپس فایل ذخیره‌شده را به‌عنوان یک تراکنش پاپت اعمال می‌نماید\.
.SH "گزینه‌ها (OPTIONS)"
توجه داشته باشید که هر تنظیمی که در فایل پیکربندی معتبر باشد، به‌عنوان یک آرگومان بلند نیز معتبر است\. برای مثال،
.B ssldir
یک تنظیم معتبر است، بنابراین می‌توانید
.BI "\-\-ssldir " directory
را به‌عنوان یک آرگومان تعیین کنید\.
.P
برای مشاهده فهرست کامل پارامترهای قابل قبول، مستندات فایل پیکربندی را در
<https://puppet.com/docs/puppet/latest/configuration.html>
ببینید\. فهرستی از تمام گزینه‌های پیکربندی همراه با توضیحات نیز با اجرای puppet با گزینه
.B \-\-genconfig
قابل تولید است\.
.TP
\-\-debug
اشکال‌زدایی کامل را فعال می‌کند\.
.TP
\-\-edit
نتایج پرس‌وجو را در یک فایل می‌نویسد، فایل را در یک ویرایشگر باز می‌کند، و فایل را مجدداً به‌عنوان یک مانیفست اجرایی پاپت می‌خواند\.
.TP
\-\-help
این پیام راهنما را چاپ می‌کند\.
.TP
\-\-param
پارامترهای بیشتری را برای خروجی گرفتن از پرس‌وجوها اضافه می‌کند\.
.TP
\-\-types
تمام نوع‌های موجود را فهرست می‌کند\.
.TP
\-\-verbose
اطلاعات اضافی را چاپ می‌کند\.
.TP
\-\-to_yaml
منابع یافت‌شده را در قالب yaml خروجی می‌دهد که برای استفاده با Hiera و create_resources مناسب است\.
.TP
\-\-fail
در صورتی که منبع قابل تغییر نباشد، با شکست مواجه شده و کد خروج 1 را برمی‌گرداند\.
.SH "مثال (EXAMPLE)"
این مثال از \fBpuppet resource\fR برای برگرداندن یک پیکربندی پاپت برای کاربر \fBluke\fR استفاده می‌کند:
.IP "" 4
.nf
$ puppet resource user luke
user { 'luke':
 home => '/home/luke',
 uid => '100',
 ensure => 'present',
 comment => 'Luke Kanies,,,',
 gid => '1000',
 shell => '/bin/bash',
 groups => ['sysadmin','audio','video','puppet']
}
.fi
.IP "" 0
.SH "نویسنده (AUTHOR)"
Luke Kanies
.SH "حق نشر (COPYRIGHT)"
Copyright (c) 2011 Puppet Inc\. Copyright (c) 2024 Vox Pupuli Licensed under the Apache 2\.0 License