نام (NAME)

puppet-resource - پوسته لایه انتزاع منبع (RAL) در OpenVox

خلاصه دستور (SYNOPSIS)

از OpenVox RAL برای تعامل مستقیم با سیستم استفاده می‌کند.

نحوه استفاده (USAGE)

puppet resource [-h|--help] [-d|--debug] [-v|--verbose] [-e|--edit] [-p|--param parameter] [-t|--types] [-y|--to_yaml] type [name] [attribute=value ...]

توضیحات (DESCRIPTION)

این دستور امکانات ساده‌ای را برای تبدیل وضعیت فعلی سیستم به کد Puppet، همراه با توانایی تغییر وضعیت فعلی با استفاده از لایه انتزاع منبع (RAL) پاپت فراهم می‌کند.

به‌طور پیش‌فرض، حداقل باید یک نوع (type) را برای فهرست کردن مشخص کنید، که در این صورت puppet resource تمام اطلاعات خود را درباره تمامی منابع از آن نوع به شما ارائه می‌دهد. همچنین می‌توانید به‌صورت اختیاری یک نام نمونه (instance name) مشخص کنید تا puppet resource فقط همان یک نمونه را توصیف کند.

اگر یک نوع، یک نام، و مجموعه‌ای از جفت‌های attribute=value داده شود، puppet resource وضعیت منبع مشخص‌شده را تغییر می‌دهد. در غیر این صورت، اگر یک نوع، یک نام، و گزینه --edit داده شود، puppet resource خروجی خود را در یک فایل می‌نویسد، آن فایل را در یک ویرایشگر باز می‌کند، و سپس فایل ذخیره‌شده را به‌عنوان یک تراکنش پاپت اعمال می‌نماید.

گزینه‌ها (OPTIONS)

توجه داشته باشید که هر تنظیمی که در فایل پیکربندی معتبر باشد، به‌عنوان یک آرگومان بلند نیز معتبر است. برای مثال، ssldir یک تنظیم معتبر است، بنابراین می‌توانید --ssldir directory را به‌عنوان یک آرگومان تعیین کنید.

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

--debug

اشکال‌زدایی کامل را فعال می‌کند.

--edit

نتایج پرس‌وجو را در یک فایل می‌نویسد، فایل را در یک ویرایشگر باز می‌کند، و فایل را مجدداً به‌عنوان یک مانیفست اجرایی پاپت می‌خواند.

--help

این پیام راهنما را چاپ می‌کند.

--param

پارامترهای بیشتری را برای خروجی گرفتن از پرس‌وجوها اضافه می‌کند.

--types

تمام نوع‌های موجود را فهرست می‌کند.

--verbose

اطلاعات اضافی را چاپ می‌کند.

--to_yaml

منابع یافت‌شده را در قالب yaml خروجی می‌دهد که برای استفاده با Hiera و create_resources مناسب است.

--fail

در صورتی که منبع قابل تغییر نباشد، با شکست مواجه شده و کد خروج 1 را برمی‌گرداند.

مثال (EXAMPLE)

این مثال از puppet resource برای برگرداندن یک پیکربندی پاپت برای کاربر luke استفاده می‌کند:

$ 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']
}

نویسنده (AUTHOR)

Luke Kanies

حق نشر (COPYRIGHT)

Copyright (c) 2011 Puppet Inc. Copyright (c) 2024 Vox Pupuli Licensed under the Apache 2.0 License