ansible-inventory(1) System administration commands ansible-inventory(1)

ansible-inventory - نمایش اطلاعات موجودی (inventory) انسیبل، به صورت پیش‌فرض از قالب JSON اسکریپت موجودی استفاده می‌کند

[--flush-cache] [--vault-id VAULT_IDS] [-J | --vault-password-file VAULT_PASSWORD_FILES] [--playbook-dir BASEDIR] [-e EXTRA_VARS] [--list] [--host HOST] [--graph] [-y] [--toml] [--vars] [--export] [--output OUTPUT_FILE] [group]

برای نمایش یا خروجی گرفتن از موجودی (inventory) پیکربندی‌شده به همان صورتی که انسیبل آن را می‌بیند استفاده می‌شود.

نام یک گروه در موجودی، در زمان استفاده از --graph کاربرد دارد

--export

هنگام استفاده از --list، خروجی را به شکلی بهینه‌شده برای صدور (export) نمایش می‌دهد، نه به صورت بازنمایی دقیق نحوه پردازش آن توسط انسیبل

--flush-cache

پاکسازی کش فکت‌ها (fact cache) برای تک‌تک میزبان‌های موجود در inventory

--graph

ایجاد گراف ساختار موجودی، در صورت ارائه الگو باید یک نام گروه معتبر باشد. این گزینه محدودیت (limit) را نادیده می‌گیرد

--host 'HOST'

خروجی دادن اطلاعات یک میزبان خاص، مشابه اسکریپت موجودی عمل می‌کند. محدودیت (limit) را نادیده می‌گیرد

--list

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

--output 'OUTPUT_FILE'

هنگام استفاده از --list، ارسال اطلاعات موجودی به یک فایل به جای نمایش در صفحه نمایش

--playbook-dir 'BASEDIR'

از آنجا که این ابزار مستقیماً از playbook استفاده نمی‌کند، این مسیر را به عنوان دایرکتوری جایگزین playbook در نظر بگیرید. این گزینه مسیر نسبی را برای بسیاری از ویژگی‌ها از جمله roles/ و group_vars/ تنظیم می‌کند

--toml

استفاده از قالب TOML به جای JSON پیش‌فرض، در صورت استفاده با --graph نادیده گرفته می‌شود

--vars

افزودن متغیرها به نمایش گراف، نادیده گرفته می‌شود مگر اینکه همراه با --graph استفاده شود

--vault-id

شناسه vault مورد استفاده. این آرگومان می‌تواند چندین بار مشخص شود.

--vault-password-file, --vault-pass-file

فایل گذرواژه vault

--version

نمایش شماره نسخه برنامه، مسیر فایل پیکربندی، مسیر جستجوی ماژول‌های پیکربندی‌شده، مسیر ماژول‌ها، مسیر فایل اجرایی و خروج

-J, --ask-vault-password, --ask-vault-pass

درخواست گذرواژه vault از کاربر

-e, --extra-vars

تنظیم متغیرهای اضافی به صورت key=value یا YAML/JSON؛ اگر نام فایل است با @ شروع شود. این آرگومان می‌تواند چندین بار مشخص شود.

-h, --help

نمایش این پیام راهنما و خروج

-i, --inventory, --inventory-file

مشخص کردن مسیر فایل موجودی یا فهرستی از میزبان‌ها جدا شده با کاما. این آرگومان می‌تواند چندین بار مشخص شود.

-l 'SUBSET', --limit 'SUBSET'

محدود کردن بیشتر میزبان‌های انتخاب‌شده به یک الگوی اضافی

-v, --verbose

موجب چاپ پیام‌های اشکال‌زدایی بیشتر توسط انسیبل می‌شود. افزودن چندین -v سطح جزئیات را افزایش می‌دهد؛ افزونه‌های توکار فعلاً تا -vvvvvv را ارزیابی می‌کنند. یک سطح منطقی برای شروع -vvv است، و اشکال‌زدایی ارتباطات ممکن است به -vvvv نیاز داشته باشد. این آرگومان می‌تواند چندین بار مشخص شود.

-y, --yaml

استفاده از قالب YAML به جای JSON پیش‌فرض، برای --graph نادیده گرفته می‌شود

group

نام یک گروه در موجودی، هنگام استفاده از --graph کاربرد دارد

انسیبل میزبان‌هایی را که به طور بالقوه می‌تواند روی آن‌ها عملیات انجام دهد در یک inventory نگهداری می‌کند. این می‌تواند یک فایل YAML، فایلی شبیه به ini، یک اسکریپت، دایرکتوری، فهرست و غیره باشد. برای گزینه‌های بیشتر، مستندات موجود در https://docs.ansible.com را ببینید.

متغیرهای محیطی زیر می‌توانند مشخص شوند:

ANSIBLE_INVENTORY -- بازنویسی منابع پیش‌فرض موجودی انسیبل

ANSIBLE_CONFIG -- مشخص کردن مسیر جایگزین برای فایل کانفیگ انسیبل

متغیرهای بسیار بیشتری برای اکثر گزینه‌ها در ansible.cfg موجود است.

برای فهرست کامل به https://docs.ansible.com مراجعه کنید یا از دستور ansible-config استفاده نمایید.

/etc/ansible/hosts -- فایل موجودی پیش‌فرض

/etc/ansible/ansible.cfg -- فایل پیکربندی، در صورت وجود استفاده می‌شود

~/.ansible.cfg -- فایل پیکربندی کاربر، در صورت وجود بر پیکربندی پیش‌فرض اولویت دارد

./ansible.cfg -- فایل پیکربندی محلی (در پوشه کاری جاری) که فرض می‌شود مختص به پروژه است و در صورت وجود بر بقیه اولویت دارد.

همان‌طور که در بالا ذکر شد، متغیر محیطی ANSIBLE_CONFIG بر همه گزینه‌های دیگر اولویت خواهد داشت.

انسیبل در ابتدا توسط Michael DeHaan نوشته شده است.

حق نشر © 2018 Red Hat, Inc | Ansible. انسیبل تحت شرایط مجوز GPLv3 منتشر شده است.

ansible (1), ansible-config (1), ansible-console (1), ansible-doc (1), ansible-galaxy (1), ansible-playbook (1), ansible-pull (1), ansible-vault (1)

مستندات جامع در وب‌سایت مستندات در دسترس است: <https://docs.ansible.com> اطلاعات IRC و فهرست پستی در فایل CONTRIBUTING.md قابل مشاهده است، در دسترس در: <https://github.com/ansible/ansible>

Ansible 2.21.3