نام (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 خروجی خود را در یک فایل می‌نویسد، آن فایل را در یک ویرایشگر باز می‌کند، و سپس فایل ذخیره‌شده را به‌عنوان یک تراکنش Puppet اعمال می‌نماید.

گزینه‌ها (OPTIONS)

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

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

--debug

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

--edit

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

--help

چاپ این پیام راهنما.

--param

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

--types

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

--verbose

چاپ اطلاعات اضافی.

--to_yaml

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

--fail

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

مثال (EXAMPLE)

این مثال از puppet resource برای برگرداندن یک پیکربندی Puppet برای کاربر 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