نام (NAME)

puppet-parser - تعامل مستقیم با تجزیه‌کننده (parser)

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

puppet parser action

گزینه‌ها (OPTIONS)

توجه داشته باشید که هر پیکربندی معتبر در فایل پیکربندی، به عنوان یک آرگومان بلند نیز معتبر است، هرچند ممکن است به اقدام فعلی مرتبط باشد یا نباشد. برای نمونه، server و run_mode تنظیمات معتبری هستند، بنابراین می‌توانید --server <servername> یا --run_mode <runmode> را به عنوان آرگومان مشخص کنید.

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

--render-as FORMAT: قالب نمایش خروجی. رایج‌ترین قالب‌ها عبارتند از json، s (رشته)، yaml و console، اما گزینه‌های دیگری مانند dot نیز گاهی در دسترس هستند.
--verbose: آیا گزارش‌ها با جزئیات کامل ثبت شوند یا خیر.
--debug: آیا اطلاعات اشکال‌زدایی ثبت شوند یا خیر.

اقدامات (ACTIONS)

•: dump - خروجی گرفتن از درخت تجزیه داخلی برای اشکال‌زدایی: SYNOPSIS

: puppet parser dump [--e source] [--[no-]validate] [--format old, pn, or json] [--pretty] [--format old|pn|json] [--pretty] { -e source | [templates ...] }
: DESCRIPTION
: این اقدام ساختار نحوی Puppet DSL را بدون کامپایل کاتالوگ یا همگام‌سازی هیچ منبعی، تجزیه و اعتبارسنجی می‌کند.
: قالب خروجی را می‌توان با استفاده از --format old|pn|json کنترل کرد که در آن:

مقدار 'old' پیش‌فرض است، اما اکنون منسوخ شده و جزو API نیست.
مقدار 'pn' نمادگذاری بیان نمادین گسترش‌یافته پاپت (Puppet Extended S-Expression Notation) است.
مقدار 'json' همان نمودار 'pn' را اما با نحو JSON خروجی می‌دهد.


: هنگامی که گزینه --pretty همراه با --format 'pn' یا 'json' داده شود، خروجی به‌صورت «خوانا» (pretty printed) خواهد بود. این گزینه روی قالب 'old' بی‌تأثیر است.
: این دستور یک یا چند فایل مانیفست (.pp) یا یک -e به همراه متن منبع پاپت را می‌پذیرد. اگر آرگومانی ارائه نشود، ورودی استاندارد (stdin) خوانده می‌شود (مگر اینکه به یک ترمینال متصل باشد).
: قالب خروجی درخت استخراج‌شده برای اهداف اشکال‌زدایی در نظر گرفته شده است و جزو API نیست، بنابراین ممکن است هر از چند گاهی تغییر کند.
: OPTIONS --e <source> - استخراج یک عبارت منبع داده‌شده در خط فرمان.
: --format <old, pn, or json> - دریافت نتیجه در قالب‌های 'old' (قالب منسوخ‌شده)، 'pn' (قالب جدید) یا 'json' (قالب جدید در JSON).
: --pretty - چاپ خوانای خروجی. تنها همراه با --format pn یا json قابل استفاده است.
: --[no-]validate - اعتبارسنجی یا عدم اعتبارسنجی نتیجه تجزیه‌شده؛ در صورت استفاده از no-validate تنها خطاهای نحوی گزارش می‌شوند.
: RETURNS
: خروجی مدل AST حاصل، مگر اینکه خطاهای نحوی یا اعتبارسنجی وجود داشته باشد.

•: validate - اعتبارسنجی نحو یک یا چند مانیفست پاپت: SYNOPSIS

: puppet parser validate [manifest] [manifest ...]
: DESCRIPTION
: این اقدام نحو Puppet DSL را بدون کامپایل کاتالوگ یا همگام‌سازی هیچ منبعی اعتبارسنجی می‌کند. اگر هیچ فایل مانیفستی ارائه نشود، مانیفست پیش‌فرض سایت را اعتبارسنجی خواهد کرد.
: هنگام اعتبارسنجی، چندین مورد اشکال در هر فایل تا سقف تنظیمات max_error و max_warnings گزارش می‌شود. پردازش پس از گزارش اشکالات اولین فایل دارای خطا متوقف می‌شود.
: RETURNS
: هیچ چیز، یا اولین خطای نحوی مشاهده‌شده.

مثال‌ها (EXAMPLES)

validate

اعتبارسنجی مانیفست پیش‌فرض سایت در /etc/puppetlabs/puppet/manifests/site.pp:

$ puppet parser validate

اعتبارسنجی دو فایل مانیفست دلخواه:

$ puppet parser validate init.pp vhost.pp

اعتبارسنجی از STDIN:

$ cat init.pp | puppet parser validate

حق نشر و مجوز (COPYRIGHT AND LICENSE)