| ansible-galaxy(1) | دستورات مدیریت سیستم | ansible-galaxy(1) |
نام (NAME)
ansible-galaxy - انجام عملیاتهای مختلف مرتبط با نقشها (Role) و مجموعهها (Collection) در انسیبل
خلاصه دستور (SYNOPSIS)
usage: ansible-galaxy [-h] [--version] [-v] TYPE ...
توضیحات (DESCRIPTION)
دستوری برای مدیریت نقشها (Roles) و مجموعههای (Collections) انسیبل.
هیچکدام از ابزارهای خط فرمان (CLI) برای اجرای همزمان با خود طراحی نشدهاند. از یک زمانبند خارجی و/یا قفلگذاری استفاده کنید تا مطمئن شوید عملیات متداخل رخ نمیدهد.
گزینههای عمومی (COMMON OPTIONS)
--version
-h, --help
-v, --verbose
عملیاتها (ACTIONS)
- collection
- انجام عملیات روی یک مجموعه (Collection) در انسیبل گلکسی. باید با عملیات دیگری مانند init/install که در زیر فهرست شده ترکیب شود.
- collection download
- بارگیری
مجموعهها
و
وابستگیهای
آنها به
عنوان یک
بایگانی tarball
جهت نصب
آفلاین.
--clear-response-cache
--no-cache
--pre
--timeout 'TIMEOUT'
--token 'API_KEY', --api-key 'API_KEY'
-c, --ignore-certs
-n, --no-deps
-p 'DOWNLOAD_PATH', --download-path 'DOWNLOAD_PATH'
-r 'REQUIREMENTS', --requirements-file 'REQUIREMENTS'
-s 'API_SERVER', --server 'API_SERVER'
- collection init
- ایجاد
ساختار
اسکلت (skeleton framework)
یک نقش یا
مجموعه که
با قالب
متاداده
گلکسی
سازگار است.
به نام نقش
یا مجموعه
نیاز دارد.
نام مجموعه
باید در
قالب
<namespace>.<collection>
باشد.
--collection-skeleton 'COLLECTION_SKELETON'
--init-path 'INIT_PATH'
--timeout 'TIMEOUT'
--token 'API_KEY', --api-key 'API_KEY'
-c, --ignore-certs
-e, --extra-vars
-f, --force
-s 'API_SERVER', --server 'API_SERVER'
- collection build
- ساخت
آرتیفکت
مجموعه
انسیبل
گلکسی که
بتواند در
یک مخزن
مرکزی
مانند Ansible Galaxy
ذخیره شود.
این دستور
به صورت
پیشفرض از
پوشه کاری
جاری
میسازد. به
صورت
اختیاری
میتوانید
مسیر ورودی
مجموعه
(جایی که
پرونده galaxy.yml
قرار دارد)
را ارسال
کنید.
--output-path 'OUTPUT_PATH'
--timeout 'TIMEOUT'
--token 'API_KEY', --api-key 'API_KEY'
-c, --ignore-certs
-f, --force
-s 'API_SERVER', --server 'API_SERVER'
- collection publish
- انتشار یک
مجموعه در
انسیبل
گلکسی. به
مسیر
پرونده tarball
مجموعه
برای
انتشار
نیاز دارد.
--import-timeout 'IMPORT_TIMEOUT'
--no-wait
--timeout 'TIMEOUT'
--token 'API_KEY', --api-key 'API_KEY'
-c, --ignore-certs
-s 'API_SERVER', --server 'API_SERVER'
- collection install
- نصب یک یا
چند نقش (ansible-galaxy role
install)، یا یک یا
چند مجموعه
(ansible-galaxy collection install).
میتوانید
فهرستی (از
نقشها یا
مجموعهها)
ارسال کنید
یا از گزینه
پرونده که
در زیر آمده
استفاده
کنید (این
دو
مانعةالجمع
هستند). در
صورت ارسال
فهرست،
میتواند
یک نام باشد
(که از طریق API
گلکسی و GitHub
بارگیری
میشود) یا
یک پرونده
آرشیو tar
محلی باشد.
--clear-response-cache
--disable-gpg-verify
--force-with-deps
--ignore-signature-status-code
--ignore-signature-status-codes
--keyring 'KEYRING'
--no-cache
--offline
--pre
--required-valid-signature-count 'REQUIRED_VALID_SIGNATURE_COUNT'
--signature
--timeout 'TIMEOUT'
--token 'API_KEY', --api-key 'API_KEY'
-U, --upgrade
-c, --ignore-certs
-f, --force
-i, --ignore-errors
-n, --no-deps
-p 'COLLECTIONS_PATH', --collections-path 'COLLECTIONS_PATH'
-r 'REQUIREMENTS', --requirements-file 'REQUIREMENTS'
-s 'API_SERVER', --server 'API_SERVER'
- collection list
- فهرست کردن
مجموعهها
یا نقشهای
نصبشده.
--format 'OUTPUT_FORMAT'
--timeout 'TIMEOUT'
--token 'API_KEY', --api-key 'API_KEY'
-c, --ignore-certs
-p, --collections-path
-s 'API_SERVER', --server 'API_SERVER'
- collection verify
- مقایسه
چکسامها
با
مجموعه(های)
موجود در
سرور و نسخه
نصبشده.
این کار
وابستگیها
را بررسی
نمیکند.
--ignore-signature-status-code
--ignore-signature-status-codes
--keyring 'KEYRING'
--offline
--required-valid-signature-count 'REQUIRED_VALID_SIGNATURE_COUNT'
--signature
--timeout 'TIMEOUT'
--token 'API_KEY', --api-key 'API_KEY'
-c, --ignore-certs
-i, --ignore-errors
-p, --collections-path
-r 'REQUIREMENTS', --requirements-file 'REQUIREMENTS'
-s 'API_SERVER', --server 'API_SERVER'
- role
- انجام عملیات روی یک نقش (Role) در انسیبل گلکسی. باید با عملیات دیگری مانند delete/install/init که در زیر فهرست شده ترکیب شود.
- role init
- ایجاد
ساختار
اسکلت (skeleton framework)
یک نقش یا
مجموعه که
با قالب
متاداده
گلکسی
سازگار است.
به نام نقش
یا مجموعه
نیاز دارد.
نام مجموعه
باید در
قالب
<namespace>.<collection>
باشد.
--init-path 'INIT_PATH'
--offline
--role-skeleton 'ROLE_SKELETON'
--timeout 'TIMEOUT'
--token 'API_KEY', --api-key 'API_KEY'
--type 'ROLE_TYPE'
-c, --ignore-certs
-e, --extra-vars
-f, --force
-s 'API_SERVER', --server 'API_SERVER'
- role remove
- حذف فهرست
نقشهای
ارائهشده
به عنوان
آرگومان از
سیستم محلی.
--timeout 'TIMEOUT'
--token 'API_KEY', --api-key 'API_KEY'
-c, --ignore-certs
-p, --roles-path
-s 'API_SERVER', --server 'API_SERVER'
- role delete
- حذف یک نقش
از انسیبل
گلکسی.
--timeout 'TIMEOUT'
--token 'API_KEY', --api-key 'API_KEY'
-c, --ignore-certs
-s 'API_SERVER', --server 'API_SERVER'
- role list
- فهرست کردن
مجموعهها
یا نقشهای
نصبشده.
--timeout 'TIMEOUT'
--token 'API_KEY', --api-key 'API_KEY'
-c, --ignore-certs
-p, --roles-path
-s 'API_SERVER', --server 'API_SERVER'
- role search
- جستجوی
نقشها در
سرور
انسیبل
گلکسی.
--author 'AUTHOR'
--galaxy-tags 'GALAXY_TAGS'
--platforms 'PLATFORMS'
--timeout 'TIMEOUT'
--token 'API_KEY', --api-key 'API_KEY'
-c, --ignore-certs
-s 'API_SERVER', --server 'API_SERVER'
- role import
- برای
درونریزی
(import) یک نقش به
انسیبل
گلکسی
استفاده
میشود.
--branch 'REFERENCE'
--no-wait
--role-name 'ROLE_NAME'
--status
--timeout 'TIMEOUT'
--token 'API_KEY', --api-key 'API_KEY'
-c, --ignore-certs
-s 'API_SERVER', --server 'API_SERVER'
- role setup
- راهاندازی
یکپارچهسازی
(integration) از GitHub یا Travis
برای
نقشهای
انسیبل
گلکسی.
--list
--remove 'REMOVE_ID'
--timeout 'TIMEOUT'
--token 'API_KEY', --api-key 'API_KEY'
-c, --ignore-certs
-p, --roles-path
-s 'API_SERVER', --server 'API_SERVER'
- role info
- چاپ
اطلاعات
دقیق
درباره یک
نقش
نصبشده و
همچنین
اطلاعات
موجود از API
گلکسی.
--offline
--timeout 'TIMEOUT'
--token 'API_KEY', --api-key 'API_KEY'
-c, --ignore-certs
-p, --roles-path
-s 'API_SERVER', --server 'API_SERVER'
- role install
- نصب یک یا
چند نقش (ansible-galaxy role
install)، یا یک یا
چند مجموعه
(ansible-galaxy collection install).
میتوانید
فهرستی (از
نقشها یا
مجموعهها)
ارسال کنید
یا از گزینه
پرونده که
در زیر آمده
استفاده
کنید (این
دو
مانعةالجمع
هستند). در
صورت ارسال
فهرست،
میتواند
یک نام باشد
(که از طریق API
گلکسی و GitHub
بارگیری
میشود) یا
یک پرونده
آرشیو tar
محلی باشد.
--force-with-deps
--timeout 'TIMEOUT'
--token 'API_KEY', --api-key 'API_KEY'
-c, --ignore-certs
-f, --force
-g, --keep-scm-meta
-i, --ignore-errors
-n, --no-deps
-p, --roles-path
-r 'REQUIREMENTS', --role-file 'REQUIREMENTS'
-s 'API_SERVER', --server 'API_SERVER'
متغیرهای محیطی (ENVIRONMENT)
متغیرهای محیطی زیر میتوانند مشخص شوند:
ANSIBLE_CONFIG -- مشخص کردن مسیر جایگزین برای پرونده پیکربندی انسیبل
متغیرهای بسیار بیشتری برای اکثر گزینهها در ansible.cfg موجود است.
برای فهرست کامل به https://docs.ansible.com مراجعه کنید یا از دستور ansible-config استفاده نمایید.
پروندهها (FILES)
/etc/ansible/ansible.cfg -- پرونده پیکربندی، در صورت وجود استفاده میشود
~/.ansible.cfg -- پرونده پیکربندی کاربر، در صورت وجود بر پیکربندی پیشفرض اولویت دارد
./ansible.cfg -- پرونده پیکربندی محلی (در پوشه کاری جاری) که فرض میشود مختص پروژه است و در صورت وجود بر بقیه اولویت دارد.
همانطور که در بالا ذکر شد، متغیر محیطی ANSIBLE_CONFIG بر همه موارد دیگر اولویت خواهد داشت.
نویسنده (AUTHOR)
انسیبل در ابتدا توسط Michael DeHaan نوشته شده است.
حق نشر (COPYRIGHT)
حق نشر © 2018 Red Hat, Inc | Ansible. انسیبل تحت شرایط مجوز GPLv3 منتشر شده است.
همچنین ببینید (SEE ALSO)
ansible (1), ansible-config (1), ansible-console (1), ansible-doc (1), ansible-inventory (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 |