.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "ansible-galaxy" "1" "" "Ansible 2.21.3" "دستورات مدیریت سیستم" .SH "نام (NAME)" ansible-galaxy \- انجام عملیات‌های مختلف مرتبط با نقش‌ها (Role) و مجموعه‌ها (Collection) در انسیبل .SH "خلاصه دستور (SYNOPSIS)" .sp usage: ansible\-galaxy [\-h] [\-\-version] [\-v] TYPE ... .SH "توضیحات (DESCRIPTION)" .sp دستوری برای مدیریت نقش‌ها (Roles) و مجموعه‌های (Collections) انسیبل. .sp هیچ‌کدام از ابزارهای خط فرمان (CLI) برای اجرای هم‌زمان با خود طراحی نشده‌اند. از یک زمان‌بند خارجی و/یا قفل‌گذاری استفاده کنید تا مطمئن شوید عملیات متداخل رخ نمی‌دهد. .SH "گزینه‌های عمومی (COMMON OPTIONS)" .sp \fB\-\-version\fP .INDENT 0.0 .INDENT 3.5 نمایش شماره نسخه برنامه، مسیر پرونده پیکربندی، مسیر جستجوی ماژول‌های پیکربندی‌شده، مسیر ماژول‌ها، مسیر پرونده اجرایی و خروج. .UNINDENT .UNINDENT .sp \fB\-h\fP, \fB\-\-help\fP .INDENT 0.0 .INDENT 3.5 نمایش این پیام راهنما و خروج. .UNINDENT .UNINDENT .sp \fB\-v\fP, \fB\-\-verbose\fP .INDENT 0.0 .INDENT 3.5 باعث می‌شود انسیبل پیام‌های اشکال‌زدایی (debug) بیشتری چاپ کند. افزودن چند \-v میزان جزئیات را افزایش می‌دهد، افزونه‌های داخلی در حال حاضر تا \-vvvvvv را ارزیابی می‌کنند. یک سطح معقول برای شروع \-vvv است، اشکال‌زدایی اتصال ممکن است به \-vvvv نیاز داشته باشد. این آرگومان می‌تواند چندین بار مشخص شود. .UNINDENT .UNINDENT .SH "عملیات‌ها (ACTIONS)" .INDENT 0.0 .TP .B \fBcollection\fP انجام عملیات روی یک مجموعه (Collection) در انسیبل گلکسی. باید با عملیات دیگری مانند init/install که در زیر فهرست شده ترکیب شود. .TP .B \fBcollection download\fP بارگیری مجموعه‌ها و وابستگی‌های آن‌ها به عنوان یک بایگانی tarball جهت نصب آفلاین. .sp \fB\-\-clear\-response\-cache\fP .INDENT 7.0 .INDENT 3.5 پاک‌سازی حافظه پنهان (cache) پاسخ‌های موجود سرور. .UNINDENT .UNINDENT .sp \fB\-\-no\-cache\fP .INDENT 7.0 .INDENT 3.5 عدم استفاده از حافظه پنهان پاسخ سرور. .UNINDENT .UNINDENT .sp \fB\-\-pre\fP .INDENT 7.0 .INDENT 3.5 شامل کردن نسخه‌های پیش‌انتشار (pre\-release). نسخه‌های پیش‌انتشار نسخه‌بندی معنایی به صورت پیش‌فرض نادیده گرفته می‌شوند. .UNINDENT .UNINDENT .sp \fB\-\-timeout\fP \(aqTIMEOUT\(aq .INDENT 7.0 .INDENT 3.5 مدت زمان انتظار برای عملیات در برابر سرور گلکسی، پیش‌فرض ۶۰ ثانیه است. .UNINDENT .UNINDENT .sp \fB\-\-token\fP \(aqAPI_KEY\(aq, \fB\-\-api\-key\fP \(aqAPI_KEY\(aq .INDENT 7.0 .INDENT 3.5 کلید API انسیبل گلکسی که در \%\& قابل دریافت است. .UNINDENT .UNINDENT .sp \fB\-c\fP, \fB\-\-ignore\-certs\fP .INDENT 7.0 .INDENT 3.5 نادیده گرفتن خطاهای اعتبارسنجی گواهی SSL. .UNINDENT .UNINDENT .sp \fB\-n\fP, \fB\-\-no\-deps\fP .INDENT 7.0 .INDENT 3.5 عدم بارگیری مجموعه‌های فهرست‌شده به عنوان وابستگی. .UNINDENT .UNINDENT .sp \fB\-p\fP \(aqDOWNLOAD_PATH\(aq, \fB\-\-download\-path\fP \(aqDOWNLOAD_PATH\(aq .INDENT 7.0 .INDENT 3.5 پوشه‌ای که مجموعه‌ها در آن بارگیری می‌شوند. .UNINDENT .UNINDENT .sp \fB\-r\fP \(aqREQUIREMENTS\(aq, \fB\-\-requirements\-file\fP \(aqREQUIREMENTS\(aq .INDENT 7.0 .INDENT 3.5 پرونده‌ای شامل فهرستی از مجموعه‌ها که باید بارگیری شوند. .UNINDENT .UNINDENT .sp \fB\-s\fP \(aqAPI_SERVER\(aq, \fB\-\-server\fP \(aqAPI_SERVER\(aq .INDENT 7.0 .INDENT 3.5 نشانی URL سرور API گلکسی. .UNINDENT .UNINDENT .TP .B \fBcollection init\fP ایجاد ساختار اسکلت (skeleton framework) یک نقش یا مجموعه که با قالب متاداده گلکسی سازگار است. به نام نقش یا مجموعه نیاز دارد. نام مجموعه باید در قالب \fB.\fP باشد. .sp \fB\-\-collection\-skeleton\fP \(aqCOLLECTION_SKELETON\(aq .INDENT 7.0 .INDENT 3.5 مسیر اسکلت مجموعه که مجموعه جدید باید بر پایه آن ایجاد شود. .UNINDENT .UNINDENT .sp \fB\-\-init\-path\fP \(aqINIT_PATH\(aq .INDENT 7.0 .INDENT 3.5 مسیری که اسکلت مجموعه در آن ایجاد خواهد شد. پیش‌فرض پوشه کاری جاری است. .UNINDENT .UNINDENT .sp \fB\-\-timeout\fP \(aqTIMEOUT\(aq .INDENT 7.0 .INDENT 3.5 مدت زمان انتظار برای عملیات در برابر سرور گلکسی، پیش‌فرض ۶۰ ثانیه است. .UNINDENT .UNINDENT .sp \fB\-\-token\fP \(aqAPI_KEY\(aq, \fB\-\-api\-key\fP \(aqAPI_KEY\(aq .INDENT 7.0 .INDENT 3.5 کلید API انسیبل گلکسی که در \%\& قابل دریافت است. .UNINDENT .UNINDENT .sp \fB\-c\fP, \fB\-\-ignore\-certs\fP .INDENT 7.0 .INDENT 3.5 نادیده گرفتن خطاهای اعتبارسنجی گواهی SSL. .UNINDENT .UNINDENT .sp \fB\-e\fP, \fB\-\-extra\-vars\fP .INDENT 7.0 .INDENT 3.5 تنظیم متغیرهای اضافی به صورت key=value یا YAML/JSON؛ در صورت استفاده از نام پرونده، @ را در ابتدا قرار دهید. این آرگومان می‌تواند چندین بار مشخص شود. .UNINDENT .UNINDENT .sp \fB\-f\fP, \fB\-\-force\fP .INDENT 7.0 .INDENT 3.5 اجبار به بازنویسی روی نقش یا مجموعه موجود. .UNINDENT .UNINDENT .sp \fB\-s\fP \(aqAPI_SERVER\(aq, \fB\-\-server\fP \(aqAPI_SERVER\(aq .INDENT 7.0 .INDENT 3.5 نشانی URL سرور API گلکسی. .UNINDENT .UNINDENT .TP .B \fBcollection build\fP ساخت آرتیفکت مجموعه انسیبل گلکسی که بتواند در یک مخزن مرکزی مانند Ansible Galaxy ذخیره شود. این دستور به صورت پیش‌فرض از پوشه کاری جاری می‌سازد. به صورت اختیاری می‌توانید مسیر ورودی مجموعه (جایی که پرونده \fBgalaxy.yml\fP قرار دارد) را ارسال کنید. .sp \fB\-\-output\-path\fP \(aqOUTPUT_PATH\(aq .INDENT 7.0 .INDENT 3.5 مسیری که مجموعه در آن ساخته می‌شود. پیش‌فرض پوشه کاری جاری است. .UNINDENT .UNINDENT .sp \fB\-\-timeout\fP \(aqTIMEOUT\(aq .INDENT 7.0 .INDENT 3.5 مدت زمان انتظار برای عملیات در برابر سرور گلکسی، پیش‌فرض ۶۰ ثانیه است. .UNINDENT .UNINDENT .sp \fB\-\-token\fP \(aqAPI_KEY\(aq, \fB\-\-api\-key\fP \(aqAPI_KEY\(aq .INDENT 7.0 .INDENT 3.5 کلید API انسیبل گلکسی که در \%\& قابل دریافت است. .UNINDENT .UNINDENT .sp \fB\-c\fP, \fB\-\-ignore\-certs\fP .INDENT 7.0 .INDENT 3.5 نادیده گرفتن خطاهای اعتبارسنجی گواهی SSL. .UNINDENT .UNINDENT .sp \fB\-f\fP, \fB\-\-force\fP .INDENT 7.0 .INDENT 3.5 اجبار به بازنویسی روی نقش یا مجموعه موجود. .UNINDENT .UNINDENT .sp \fB\-s\fP \(aqAPI_SERVER\(aq, \fB\-\-server\fP \(aqAPI_SERVER\(aq .INDENT 7.0 .INDENT 3.5 نشانی URL سرور API گلکسی. .UNINDENT .UNINDENT .TP .B \fBcollection publish\fP انتشار یک مجموعه در انسیبل گلکسی. به مسیر پرونده tarball مجموعه برای انتشار نیاز دارد. .sp \fB\-\-import\-timeout\fP \(aqIMPORT_TIMEOUT\(aq .INDENT 7.0 .INDENT 3.5 مدت زمان انتظار برای اتمام فرایند درون‌ریزی (import) مجموعه. .UNINDENT .UNINDENT .sp \fB\-\-no\-wait\fP .INDENT 7.0 .INDENT 3.5 منتظر نماندن برای نتایج اعتبارسنجی درون‌ریزی. .UNINDENT .UNINDENT .sp \fB\-\-timeout\fP \(aqTIMEOUT\(aq .INDENT 7.0 .INDENT 3.5 مدت زمان انتظار برای عملیات در برابر سرور گلکسی، پیش‌فرض ۶۰ ثانیه است. .UNINDENT .UNINDENT .sp \fB\-\-token\fP \(aqAPI_KEY\(aq, \fB\-\-api\-key\fP \(aqAPI_KEY\(aq .INDENT 7.0 .INDENT 3.5 کلید API انسیبل گلکسی که در \%\& قابل دریافت است. .UNINDENT .UNINDENT .sp \fB\-c\fP, \fB\-\-ignore\-certs\fP .INDENT 7.0 .INDENT 3.5 نادیده گرفتن خطاهای اعتبارسنجی گواهی SSL. .UNINDENT .UNINDENT .sp \fB\-s\fP \(aqAPI_SERVER\(aq, \fB\-\-server\fP \(aqAPI_SERVER\(aq .INDENT 7.0 .INDENT 3.5 نشانی URL سرور API گلکسی. .UNINDENT .UNINDENT .TP .B \fBcollection install\fP نصب یک یا چند نقش (\fBansible\-galaxy role install\fP)، یا یک یا چند مجموعه (\fBansible\-galaxy collection install\fP). می‌توانید فهرستی (از نقش‌ها یا مجموعه‌ها) ارسال کنید یا از گزینه پرونده که در زیر آمده استفاده کنید (این دو مانعة‌الجمع هستند). در صورت ارسال فهرست، می‌تواند یک نام باشد (که از طریق API گلکسی و GitHub بارگیری می‌شود) یا یک پرونده آرشیو tar محلی باشد. .sp \fB\-\-clear\-response\-cache\fP .INDENT 7.0 .INDENT 3.5 پاک‌سازی حافظه پنهان پاسخ‌های موجود سرور. .UNINDENT .UNINDENT .sp \fB\-\-disable\-gpg\-verify\fP .INDENT 7.0 .INDENT 3.5 غیرفعال‌سازی اعتبارسنجی امضای GPG هنگام نصب مجموعه‌ها از سرور گلکسی. .UNINDENT .UNINDENT .sp \fB\-\-force\-with\-deps\fP .INDENT 7.0 .INDENT 3.5 اجبار به بازنویسی یک مجموعه موجود و وابستگی‌های آن. .UNINDENT .UNINDENT .sp \fB\-\-ignore\-signature\-status\-code\fP .INDENT 7.0 .INDENT 3.5 ==SUPPRESS==. این آرگومان می‌تواند چندین بار مشخص شود. .UNINDENT .UNINDENT .sp \fB\-\-ignore\-signature\-status\-codes\fP .INDENT 7.0 .INDENT 3.5 فهرستی جدا شده با فاصله از کدهای وضعیت برای نادیده گرفتن در طول اعتبارسنجی امضا (به عنوان مثال، NO_PUBKEY FAILURE). توضیحات مربوط به گزینه‌ها در L(\%: قابل مشاهده است؛ این موارد را پس از آرگومان‌های مکانی مشخص کنید یا از \-\- برای جدا کردن آن‌ها استفاده نمایید. این آرگومان می‌تواند چندین بار مشخص شود. .UNINDENT .UNINDENT .sp \fB\-\-keyring\fP \(aqKEYRING\(aq .INDENT 7.0 .INDENT 3.5 دسته کلید (keyring) مورد استفاده هنگام اعتبارسنجی امضا. .UNINDENT .UNINDENT .sp \fB\-\-no\-cache\fP .INDENT 7.0 .INDENT 3.5 عدم استفاده از حافظه پنهان پاسخ سرور. .UNINDENT .UNINDENT .sp \fB\-\-offline\fP .INDENT 7.0 .INDENT 3.5 نصب آرتیفکت‌های مجموعه (tarballs) بدون برقراری ارتباط با هیچ سرور توزیعی. این گزینه برای مجموعه‌های موجود در مخازن دوردست Git یا نشانی‌های URL مربوط به tarballهای دوردست اعمال نمی‌شود. .UNINDENT .UNINDENT .sp \fB\-\-pre\fP .INDENT 7.0 .INDENT 3.5 شامل کردن نسخه‌های پیش‌انتشار. نسخه‌های پیش‌انتشار نسخه‌بندی معنایی به صورت پیش‌فرض نادیده گرفته می‌شوند. .UNINDENT .UNINDENT .sp \fB\-\-required\-valid\-signature\-count\fP \(aqREQUIRED_VALID_SIGNATURE_COUNT\(aq .INDENT 7.0 .INDENT 3.5 تعداد امضاهایی که باید با موفقیت مجموعه را تأیید کنند. این مقدار باید یک عدد صحیح مثبت یا \-1 باشد تا مشخص کند تمام امضاها باید برای تأیید مجموعه به کار روند. اضافه کردن + به ابتدای مقدار باعث می‌شود در صورت نیافتن امضای معتبر برای مجموعه، عملیات شکست بخورد (مانند +all). .UNINDENT .UNINDENT .sp \fB\-\-signature\fP .INDENT 7.0 .INDENT 3.5 منبع امضای اضافی برای تأیید اصالت MANIFEST.json پیش از نصب مجموعه از یک سرور گلکسی. همراه با نام مکانی مجموعه استفاده شود (مانعة‌الجمع با \-\-requirements\-file). این آرگومان می‌تواند چندین بار مشخص شود. .UNINDENT .UNINDENT .sp \fB\-\-timeout\fP \(aqTIMEOUT\(aq .INDENT 7.0 .INDENT 3.5 مدت زمان انتظار برای عملیات در برابر سرور گلکسی، پیش‌فرض ۶۰ ثانیه است. .UNINDENT .UNINDENT .sp \fB\-\-token\fP \(aqAPI_KEY\(aq, \fB\-\-api\-key\fP \(aqAPI_KEY\(aq .INDENT 7.0 .INDENT 3.5 کلید API انسیبل گلکسی که در \%\& قابل دریافت است. .UNINDENT .UNINDENT .sp \fB\-U\fP, \fB\-\-upgrade\fP .INDENT 7.0 .INDENT 3.5 ارتقای آرتیفکت‌های نصب‌شده مجموعه. این کار وابستگی‌ها را نیز به‌روزرسانی می‌کند مگر این‌که \-\-no\-deps مشخص شده باشد. .UNINDENT .UNINDENT .sp \fB\-c\fP, \fB\-\-ignore\-certs\fP .INDENT 7.0 .INDENT 3.5 نادیده گرفتن خطاهای اعتبارسنجی گواهی SSL. .UNINDENT .UNINDENT .sp \fB\-f\fP, \fB\-\-force\fP .INDENT 7.0 .INDENT 3.5 اجبار به بازنویسی روی نقش یا مجموعه موجود. .UNINDENT .UNINDENT .sp \fB\-i\fP, \fB\-\-ignore\-errors\fP .INDENT 7.0 .INDENT 3.5 نادیده گرفتن خطاها در طول نصب و ادامه با مجموعه مشخص‌شده بعدی. این گزینه خطاهای تعارض وابستگی را نادیده نمی‌گیرد. .UNINDENT .UNINDENT .sp \fB\-n\fP, \fB\-\-no\-deps\fP .INDENT 7.0 .INDENT 3.5 عدم بارگیری مجموعه‌های فهرست‌شده به عنوان وابستگی. .UNINDENT .UNINDENT .sp \fB\-p\fP \(aqCOLLECTIONS_PATH\(aq, \fB\-\-collections\-path\fP \(aqCOLLECTIONS_PATH\(aq .INDENT 7.0 .INDENT 3.5 مسیر پوشه حاوی مجموعه‌های شما. .UNINDENT .UNINDENT .sp \fB\-r\fP \(aqREQUIREMENTS\(aq, \fB\-\-requirements\-file\fP \(aqREQUIREMENTS\(aq .INDENT 7.0 .INDENT 3.5 پرونده‌ای شامل فهرستی از مجموعه‌ها که باید نصب شوند. .UNINDENT .UNINDENT .sp \fB\-s\fP \(aqAPI_SERVER\(aq, \fB\-\-server\fP \(aqAPI_SERVER\(aq .INDENT 7.0 .INDENT 3.5 نشانی URL سرور API گلکسی. .UNINDENT .UNINDENT .TP .B \fBcollection list\fP فهرست کردن مجموعه‌ها یا نقش‌های نصب‌شده. .sp \fB\-\-format\fP \(aqOUTPUT_FORMAT\(aq .INDENT 7.0 .INDENT 3.5 قالب نمایش فهرست مجموعه‌ها. .UNINDENT .UNINDENT .sp \fB\-\-timeout\fP \(aqTIMEOUT\(aq .INDENT 7.0 .INDENT 3.5 مدت زمان انتظار برای عملیات در برابر سرور گلکسی، پیش‌فرض ۶۰ ثانیه است. .UNINDENT .UNINDENT .sp \fB\-\-token\fP \(aqAPI_KEY\(aq, \fB\-\-api\-key\fP \(aqAPI_KEY\(aq .INDENT 7.0 .INDENT 3.5 کلید API انسیبل گلکسی که در \%\& قابل دریافت است. .UNINDENT .UNINDENT .sp \fB\-c\fP, \fB\-\-ignore\-certs\fP .INDENT 7.0 .INDENT 3.5 نادیده گرفتن خطاهای اعتبارسنجی گواهی SSL. .UNINDENT .UNINDENT .sp \fB\-p\fP, \fB\-\-collections\-path\fP .INDENT 7.0 .INDENT 3.5 یک یا چند پوشه برای جستجوی مجموعه‌ها علاوه بر مسیرهای پیش‌فرض COLLECTIONS_PATHS. چندین مسیر را با \(aq:\(aq جدا کنید. این آرگومان می‌تواند چندین بار مشخص شود. .UNINDENT .UNINDENT .sp \fB\-s\fP \(aqAPI_SERVER\(aq, \fB\-\-server\fP \(aqAPI_SERVER\(aq .INDENT 7.0 .INDENT 3.5 نشانی URL سرور API گلکسی. .UNINDENT .UNINDENT .TP .B \fBcollection verify\fP مقایسه چکسام‌ها با مجموعه(های) موجود در سرور و نسخه نصب‌شده. این کار وابستگی‌ها را بررسی نمی‌کند. .sp \fB\-\-ignore\-signature\-status\-code\fP .INDENT 7.0 .INDENT 3.5 ==SUPPRESS==. این آرگومان می‌تواند چندین بار مشخص شود. .UNINDENT .UNINDENT .sp \fB\-\-ignore\-signature\-status\-codes\fP .INDENT 7.0 .INDENT 3.5 فهرستی جدا شده با فاصله از کدهای وضعیت برای نادیده گرفتن در طول اعتبارسنجی امضا (به عنوان مثال، NO_PUBKEY FAILURE). توضیحات مربوط به گزینه‌ها در L(\%: قابل مشاهده است؛ این موارد را پس از آرگومان‌های مکانی مشخص کنید یا از \-\- برای جدا کردن آن‌ها استفاده نمایید. این آرگومان می‌تواند چندین بار مشخص شود. .UNINDENT .UNINDENT .sp \fB\-\-keyring\fP \(aqKEYRING\(aq .INDENT 7.0 .INDENT 3.5 دسته کلید (keyring) مورد استفاده هنگام اعتبارسنجی امضا. .UNINDENT .UNINDENT .sp \fB\-\-offline\fP .INDENT 7.0 .INDENT 3.5 اعتبارسنجی یکپارچگی مجموعه به صورت محلی بدون ارتباط با سرور برای هش مانیفست مرجع. .UNINDENT .UNINDENT .sp \fB\-\-required\-valid\-signature\-count\fP \(aqREQUIRED_VALID_SIGNATURE_COUNT\(aq .INDENT 7.0 .INDENT 3.5 تعداد امضاهایی که باید با موفقیت مجموعه را تأیید کنند. این مقدار باید یک عدد صحیح مثبت یا all باشد تا مشخص کند تمام امضاها باید برای تأیید مجموعه به کار روند. اضافه کردن + به ابتدای مقدار باعث می‌شود در صورت نیافتن امضای معتبر برای مجموعه، عملیات شکست بخورد (مانند +all). .UNINDENT .UNINDENT .sp \fB\-\-signature\fP .INDENT 7.0 .INDENT 3.5 منبع امضای اضافی برای تأیید اصالت MANIFEST.json پیش از استفاده از آن جهت تأیید باقی محتویات یک مجموعه از سرور گلکسی. همراه با نام مکانی مجموعه استفاده شود (مانعة‌الجمع با \-\-requirements\-file). این آرگومان می‌تواند چندین بار مشخص شود. .UNINDENT .UNINDENT .sp \fB\-\-timeout\fP \(aqTIMEOUT\(aq .INDENT 7.0 .INDENT 3.5 مدت زمان انتظار برای عملیات در برابر سرور گلکسی، پیش‌فرض ۶۰ ثانیه است. .UNINDENT .UNINDENT .sp \fB\-\-token\fP \(aqAPI_KEY\(aq, \fB\-\-api\-key\fP \(aqAPI_KEY\(aq .INDENT 7.0 .INDENT 3.5 کلید API انسیبل گلکسی که در \%\& قابل دریافت است. .UNINDENT .UNINDENT .sp \fB\-c\fP, \fB\-\-ignore\-certs\fP .INDENT 7.0 .INDENT 3.5 نادیده گرفتن خطاهای اعتبارسنجی گواهی SSL. .UNINDENT .UNINDENT .sp \fB\-i\fP, \fB\-\-ignore\-errors\fP .INDENT 7.0 .INDENT 3.5 نادیده گرفتن خطاها در طول اعتبارسنجی و ادامه با مجموعه مشخص‌شده بعدی. .UNINDENT .UNINDENT .sp \fB\-p\fP, \fB\-\-collections\-path\fP .INDENT 7.0 .INDENT 3.5 یک یا چند پوشه برای جستجوی مجموعه‌ها علاوه بر مسیرهای پیش‌فرض COLLECTIONS_PATHS. چندین مسیر را با \(aq:\(aq جدا کنید. این آرگومان می‌تواند چندین بار مشخص شود. .UNINDENT .UNINDENT .sp \fB\-r\fP \(aqREQUIREMENTS\(aq, \fB\-\-requirements\-file\fP \(aqREQUIREMENTS\(aq .INDENT 7.0 .INDENT 3.5 پرونده‌ای شامل فهرستی از مجموعه‌ها که باید تأیید شوند. .UNINDENT .UNINDENT .sp \fB\-s\fP \(aqAPI_SERVER\(aq, \fB\-\-server\fP \(aqAPI_SERVER\(aq .INDENT 7.0 .INDENT 3.5 نشانی URL سرور API گلکسی. .UNINDENT .UNINDENT .TP .B \fBrole\fP انجام عملیات روی یک نقش (Role) در انسیبل گلکسی. باید با عملیات دیگری مانند delete/install/init که در زیر فهرست شده ترکیب شود. .TP .B \fBrole init\fP ایجاد ساختار اسکلت (skeleton framework) یک نقش یا مجموعه که با قالب متاداده گلکسی سازگار است. به نام نقش یا مجموعه نیاز دارد. نام مجموعه باید در قالب \fB.\fP باشد. .sp \fB\-\-init\-path\fP \(aqINIT_PATH\(aq .INDENT 7.0 .INDENT 3.5 مسیری که اسکلت نقش در آن ایجاد خواهد شد. پیش‌فرض پوشه کاری جاری است. .UNINDENT .UNINDENT .sp \fB\-\-offline\fP .INDENT 7.0 .INDENT 3.5 عدم ارسال پرس‌وجو به API گلکسی هنگام ایجاد نقش‌ها. .UNINDENT .UNINDENT .sp \fB\-\-role\-skeleton\fP \(aqROLE_SKELETON\(aq .INDENT 7.0 .INDENT 3.5 مسیر اسکلت نقشی که نقش جدید باید بر پایه آن ایجاد شود. .UNINDENT .UNINDENT .sp \fB\-\-timeout\fP \(aqTIMEOUT\(aq .INDENT 7.0 .INDENT 3.5 مدت زمان انتظار برای عملیات در برابر سرور گلکسی، پیش‌فرض ۶۰ ثانیه است. .UNINDENT .UNINDENT .sp \fB\-\-token\fP \(aqAPI_KEY\(aq, \fB\-\-api\-key\fP \(aqAPI_KEY\(aq .INDENT 7.0 .INDENT 3.5 کلید API انسیبل گلکسی که در \%\& قابل دریافت است. .UNINDENT .UNINDENT .sp \fB\-\-type\fP \(aqROLE_TYPE\(aq .INDENT 7.0 .INDENT 3.5 راه‌اندازی اولیه با استفاده از یک نوع نقش جایگزین. انواع معتبر شامل: \(aqcontainer\(aq، \(aqapb\(aq و \(aqnetwork\(aq هستند. .UNINDENT .UNINDENT .sp \fB\-c\fP, \fB\-\-ignore\-certs\fP .INDENT 7.0 .INDENT 3.5 نادیده گرفتن خطاهای اعتبارسنجی گواهی SSL. .UNINDENT .UNINDENT .sp \fB\-e\fP, \fB\-\-extra\-vars\fP .INDENT 7.0 .INDENT 3.5 تنظیم متغیرهای اضافی به صورت key=value یا YAML/JSON؛ در صورت استفاده از نام پرونده، @ را در ابتدا قرار دهید. این آرگومان می‌تواند چندین بار مشخص شود. .UNINDENT .UNINDENT .sp \fB\-f\fP, \fB\-\-force\fP .INDENT 7.0 .INDENT 3.5 اجبار به بازنویسی روی نقش یا مجموعه موجود. .UNINDENT .UNINDENT .sp \fB\-s\fP \(aqAPI_SERVER\(aq, \fB\-\-server\fP \(aqAPI_SERVER\(aq .INDENT 7.0 .INDENT 3.5 نشانی URL سرور API گلکسی. .UNINDENT .UNINDENT .TP .B \fBrole remove\fP حذف فهرست نقش‌های ارائه‌شده به عنوان آرگومان از سیستم محلی. .sp \fB\-\-timeout\fP \(aqTIMEOUT\(aq .INDENT 7.0 .INDENT 3.5 مدت زمان انتظار برای عملیات در برابر سرور گلکسی، پیش‌فرض ۶۰ ثانیه است. .UNINDENT .UNINDENT .sp \fB\-\-token\fP \(aqAPI_KEY\(aq, \fB\-\-api\-key\fP \(aqAPI_KEY\(aq .INDENT 7.0 .INDENT 3.5 کلید API انسیبل گلکسی که در \%\& قابل دریافت است. .UNINDENT .UNINDENT .sp \fB\-c\fP, \fB\-\-ignore\-certs\fP .INDENT 7.0 .INDENT 3.5 نادیده گرفتن خطاهای اعتبارسنجی گواهی SSL. .UNINDENT .UNINDENT .sp \fB\-p\fP, \fB\-\-roles\-path\fP .INDENT 7.0 .INDENT 3.5 مسیر پوشه حاوی نقش‌های شما. پیش‌فرض اولین مسیر قابل نوشتن پیکربندی‌شده از طریق DEFAULT_ROLES_PATH است: {{ ANSIBLE_HOME ~ \(dq/roles:/usr/share/ansible/roles:/etc/ansible/roles\(dq }} . این آرگومان می‌تواند چندین بار مشخص شود. .UNINDENT .UNINDENT .sp \fB\-s\fP \(aqAPI_SERVER\(aq, \fB\-\-server\fP \(aqAPI_SERVER\(aq .INDENT 7.0 .INDENT 3.5 نشانی URL سرور API گلکسی. .UNINDENT .UNINDENT .TP .B \fBrole delete\fP حذف یک نقش از انسیبل گلکسی. .sp \fB\-\-timeout\fP \(aqTIMEOUT\(aq .INDENT 7.0 .INDENT 3.5 مدت زمان انتظار برای عملیات در برابر سرور گلکسی، پیش‌فرض ۶۰ ثانیه است. .UNINDENT .UNINDENT .sp \fB\-\-token\fP \(aqAPI_KEY\(aq, \fB\-\-api\-key\fP \(aqAPI_KEY\(aq .INDENT 7.0 .INDENT 3.5 کلید API انسیبل گلکسی که در \%\& قابل دریافت است. .UNINDENT .UNINDENT .sp \fB\-c\fP, \fB\-\-ignore\-certs\fP .INDENT 7.0 .INDENT 3.5 نادیده گرفتن خطاهای اعتبارسنجی گواهی SSL. .UNINDENT .UNINDENT .sp \fB\-s\fP \(aqAPI_SERVER\(aq, \fB\-\-server\fP \(aqAPI_SERVER\(aq .INDENT 7.0 .INDENT 3.5 نشانی URL سرور API گلکسی. .UNINDENT .UNINDENT .TP .B \fBrole list\fP فهرست کردن مجموعه‌ها یا نقش‌های نصب‌شده. .sp \fB\-\-timeout\fP \(aqTIMEOUT\(aq .INDENT 7.0 .INDENT 3.5 مدت زمان انتظار برای عملیات در برابر سرور گلکسی، پیش‌فرض ۶۰ ثانیه است. .UNINDENT .UNINDENT .sp \fB\-\-token\fP \(aqAPI_KEY\(aq, \fB\-\-api\-key\fP \(aqAPI_KEY\(aq .INDENT 7.0 .INDENT 3.5 کلید API انسیبل گلکسی که در \%\& قابل دریافت است. .UNINDENT .UNINDENT .sp \fB\-c\fP, \fB\-\-ignore\-certs\fP .INDENT 7.0 .INDENT 3.5 نادیده گرفتن خطاهای اعتبارسنجی گواهی SSL. .UNINDENT .UNINDENT .sp \fB\-p\fP, \fB\-\-roles\-path\fP .INDENT 7.0 .INDENT 3.5 مسیر پوشه حاوی نقش‌های شما. پیش‌فرض اولین مسیر قابل نوشتن پیکربندی‌شده از طریق DEFAULT_ROLES_PATH است: {{ ANSIBLE_HOME ~ \(dq/roles:/usr/share/ansible/roles:/etc/ansible/roles\(dq }} . این آرگومان می‌تواند چندین بار مشخص شود. .UNINDENT .UNINDENT .sp \fB\-s\fP \(aqAPI_SERVER\(aq, \fB\-\-server\fP \(aqAPI_SERVER\(aq .INDENT 7.0 .INDENT 3.5 نشانی URL سرور API گلکسی. .UNINDENT .UNINDENT .TP .B \fBrole search\fP جستجوی نقش‌ها در سرور انسیبل گلکسی. .sp \fB\-\-author\fP \(aqAUTHOR\(aq .INDENT 7.0 .INDENT 3.5 نام کاربری GitHub. .UNINDENT .UNINDENT .sp \fB\-\-galaxy\-tags\fP \(aqGALAXY_TAGS\(aq .INDENT 7.0 .INDENT 3.5 فهرستی از برچسب‌های گلکسی برای پالایش بر اساس آن‌ها. .UNINDENT .UNINDENT .sp \fB\-\-platforms\fP \(aqPLATFORMS\(aq .INDENT 7.0 .INDENT 3.5 فهرستی از پلتفرم‌های سیستم‌عامل برای پالایش بر اساس آن‌ها. .UNINDENT .UNINDENT .sp \fB\-\-timeout\fP \(aqTIMEOUT\(aq .INDENT 7.0 .INDENT 3.5 مدت زمان انتظار برای عملیات در برابر سرور گلکسی، پیش‌فرض ۶۰ ثانیه است. .UNINDENT .UNINDENT .sp \fB\-\-token\fP \(aqAPI_KEY\(aq, \fB\-\-api\-key\fP \(aqAPI_KEY\(aq .INDENT 7.0 .INDENT 3.5 کلید API انسیبل گلکسی که در \%\& قابل دریافت است. .UNINDENT .UNINDENT .sp \fB\-c\fP, \fB\-\-ignore\-certs\fP .INDENT 7.0 .INDENT 3.5 نادیده گرفتن خطاهای اعتبارسنجی گواهی SSL. .UNINDENT .UNINDENT .sp \fB\-s\fP \(aqAPI_SERVER\(aq, \fB\-\-server\fP \(aqAPI_SERVER\(aq .INDENT 7.0 .INDENT 3.5 نشانی URL سرور API گلکسی. .UNINDENT .UNINDENT .TP .B \fBrole import\fP برای درون‌ریزی (import) یک نقش به انسیبل گلکسی استفاده می‌شود. .sp \fB\-\-branch\fP \(aqREFERENCE\(aq .INDENT 7.0 .INDENT 3.5 نام شاخه‌ای برای درون‌ریزی. پیش‌فرض شاخه پیش‌فرض مخزن است (معمولاً master). .UNINDENT .UNINDENT .sp \fB\-\-no\-wait\fP .INDENT 7.0 .INDENT 3.5 منتظر نماندن برای نتایج درون‌ریزی. .UNINDENT .UNINDENT .sp \fB\-\-role\-name\fP \(aqROLE_NAME\(aq .INDENT 7.0 .INDENT 3.5 نامی که نقش باید داشته باشد، در صورتی که متفاوت از نام مخزن باشد. .UNINDENT .UNINDENT .sp \fB\-\-status\fP .INDENT 7.0 .INDENT 3.5 بررسی وضعیت تازه‌ترین درخواست درون‌ریزی برای github_user/github_repo داده‌شده. .UNINDENT .UNINDENT .sp \fB\-\-timeout\fP \(aqTIMEOUT\(aq .INDENT 7.0 .INDENT 3.5 مدت زمان انتظار برای عملیات در برابر سرور گلکسی، پیش‌فرض ۶۰ ثانیه است. .UNINDENT .UNINDENT .sp \fB\-\-token\fP \(aqAPI_KEY\(aq, \fB\-\-api\-key\fP \(aqAPI_KEY\(aq .INDENT 7.0 .INDENT 3.5 کلید API انسیبل گلکسی که در \%\& قابل دریافت است. .UNINDENT .UNINDENT .sp \fB\-c\fP, \fB\-\-ignore\-certs\fP .INDENT 7.0 .INDENT 3.5 نادیده گرفتن خطاهای اعتبارسنجی گواهی SSL. .UNINDENT .UNINDENT .sp \fB\-s\fP \(aqAPI_SERVER\(aq, \fB\-\-server\fP \(aqAPI_SERVER\(aq .INDENT 7.0 .INDENT 3.5 نشانی URL سرور API گلکسی. .UNINDENT .UNINDENT .TP .B \fBrole setup\fP راه‌اندازی یکپارچه‌سازی (integration) از GitHub یا Travis برای نقش‌های انسیبل گلکسی. .sp \fB\-\-list\fP .INDENT 7.0 .INDENT 3.5 فهرست کردن تمام یکپارچه‌سازی‌های شما. .UNINDENT .UNINDENT .sp \fB\-\-remove\fP \(aqREMOVE_ID\(aq .INDENT 7.0 .INDENT 3.5 حذف یکپارچه‌سازی منطبق با مقدار شناسه ارائه‌شده. برای مشاهده مقادیر شناسه از \-\-list استفاده کنید. .UNINDENT .UNINDENT .sp \fB\-\-timeout\fP \(aqTIMEOUT\(aq .INDENT 7.0 .INDENT 3.5 مدت زمان انتظار برای عملیات در برابر سرور گلکسی، پیش‌فرض ۶۰ ثانیه است. .UNINDENT .UNINDENT .sp \fB\-\-token\fP \(aqAPI_KEY\(aq, \fB\-\-api\-key\fP \(aqAPI_KEY\(aq .INDENT 7.0 .INDENT 3.5 کلید API انسیبل گلکسی که در \%\& قابل دریافت است. .UNINDENT .UNINDENT .sp \fB\-c\fP, \fB\-\-ignore\-certs\fP .INDENT 7.0 .INDENT 3.5 نادیده گرفتن خطاهای اعتبارسنجی گواهی SSL. .UNINDENT .UNINDENT .sp \fB\-p\fP, \fB\-\-roles\-path\fP .INDENT 7.0 .INDENT 3.5 مسیر پوشه حاوی نقش‌های شما. پیش‌فرض اولین مسیر قابل نوشتن پیکربندی‌شده از طریق DEFAULT_ROLES_PATH است: {{ ANSIBLE_HOME ~ \(dq/roles:/usr/share/ansible/roles:/etc/ansible/roles\(dq }} . این آرگومان می‌تواند چندین بار مشخص شود. .UNINDENT .UNINDENT .sp \fB\-s\fP \(aqAPI_SERVER\(aq, \fB\-\-server\fP \(aqAPI_SERVER\(aq .INDENT 7.0 .INDENT 3.5 نشانی URL سرور API گلکسی. .UNINDENT .UNINDENT .TP .B \fBrole info\fP چاپ اطلاعات دقیق درباره یک نقش نصب‌شده و همچنین اطلاعات موجود از API گلکسی. .sp \fB\-\-offline\fP .INDENT 7.0 .INDENT 3.5 عدم ارسال پرس‌وجو به API گلکسی هنگام ایجاد نقش‌ها. .UNINDENT .UNINDENT .sp \fB\-\-timeout\fP \(aqTIMEOUT\(aq .INDENT 7.0 .INDENT 3.5 مدت زمان انتظار برای عملیات در برابر سرور گلکسی، پیش‌فرض ۶۰ ثانیه است. .UNINDENT .UNINDENT .sp \fB\-\-token\fP \(aqAPI_KEY\(aq, \fB\-\-api\-key\fP \(aqAPI_KEY\(aq .INDENT 7.0 .INDENT 3.5 کلید API انسیبل گلکسی که در \%\& قابل دریافت است. .UNINDENT .UNINDENT .sp \fB\-c\fP, \fB\-\-ignore\-certs\fP .INDENT 7.0 .INDENT 3.5 نادیده گرفتن خطاهای اعتبارسنجی گواهی SSL. .UNINDENT .UNINDENT .sp \fB\-p\fP, \fB\-\-roles\-path\fP .INDENT 7.0 .INDENT 3.5 مسیر پوشه حاوی نقش‌های شما. پیش‌فرض اولین مسیر قابل نوشتن پیکربندی‌شده از طریق DEFAULT_ROLES_PATH است: {{ ANSIBLE_HOME ~ \(dq/roles:/usr/share/ansible/roles:/etc/ansible/roles\(dq }} . این آرگومان می‌تواند چندین بار مشخص شود. .UNINDENT .UNINDENT .sp \fB\-s\fP \(aqAPI_SERVER\(aq, \fB\-\-server\fP \(aqAPI_SERVER\(aq .INDENT 7.0 .INDENT 3.5 نشانی URL سرور API گلکسی. .UNINDENT .UNINDENT .TP .B \fBrole install\fP نصب یک یا چند نقش (\fBansible\-galaxy role install\fP)، یا یک یا چند مجموعه (\fBansible\-galaxy collection install\fP). می‌توانید فهرستی (از نقش‌ها یا مجموعه‌ها) ارسال کنید یا از گزینه پرونده که در زیر آمده استفاده کنید (این دو مانعة‌الجمع هستند). در صورت ارسال فهرست، می‌تواند یک نام باشد (که از طریق API گلکسی و GitHub بارگیری می‌شود) یا یک پرونده آرشیو tar محلی باشد. .sp \fB\-\-force\-with\-deps\fP .INDENT 7.0 .INDENT 3.5 اجبار به بازنویسی یک نقش موجود و وابستگی‌های آن. .UNINDENT .UNINDENT .sp \fB\-\-timeout\fP \(aqTIMEOUT\(aq .INDENT 7.0 .INDENT 3.5 مدت زمان انتظار برای عملیات در برابر سرور گلکسی، پیش‌فرض ۶۰ ثانیه است. .UNINDENT .UNINDENT .sp \fB\-\-token\fP \(aqAPI_KEY\(aq, \fB\-\-api\-key\fP \(aqAPI_KEY\(aq .INDENT 7.0 .INDENT 3.5 کلید API انسیبل گلکسی که در \%\& قابل دریافت است. .UNINDENT .UNINDENT .sp \fB\-c\fP, \fB\-\-ignore\-certs\fP .INDENT 7.0 .INDENT 3.5 نادیده گرفتن خطاهای اعتبارسنجی گواهی SSL. .UNINDENT .UNINDENT .sp \fB\-f\fP, \fB\-\-force\fP .INDENT 7.0 .INDENT 3.5 اجبار به بازنویسی روی نقش یا مجموعه موجود. .UNINDENT .UNINDENT .sp \fB\-g\fP, \fB\-\-keep\-scm\-meta\fP .INDENT 7.0 .INDENT 3.5 استفاده از tar به جای گزینه آرشیو scm هنگام بسته‌بندی نقش. .UNINDENT .UNINDENT .sp \fB\-i\fP, \fB\-\-ignore\-errors\fP .INDENT 7.0 .INDENT 3.5 نادیده گرفتن خطاها و ادامه با نقش مشخص‌شده بعدی. .UNINDENT .UNINDENT .sp \fB\-n\fP, \fB\-\-no\-deps\fP .INDENT 7.0 .INDENT 3.5 عدم بارگیری نقش‌های فهرست‌شده به عنوان وابستگی. .UNINDENT .UNINDENT .sp \fB\-p\fP, \fB\-\-roles\-path\fP .INDENT 7.0 .INDENT 3.5 مسیر پوشه حاوی نقش‌های شما. پیش‌فرض اولین مسیر قابل نوشتن پیکربندی‌شده از طریق DEFAULT_ROLES_PATH است: {{ ANSIBLE_HOME ~ \(dq/roles:/usr/share/ansible/roles:/etc/ansible/roles\(dq }} . این آرگومان می‌تواند چندین بار مشخص شود. .UNINDENT .UNINDENT .sp \fB\-r\fP \(aqREQUIREMENTS\(aq, \fB\-\-role\-file\fP \(aqREQUIREMENTS\(aq .INDENT 7.0 .INDENT 3.5 پرونده‌ای شامل فهرستی از نقش‌ها که باید نصب شوند. .UNINDENT .UNINDENT .sp \fB\-s\fP \(aqAPI_SERVER\(aq, \fB\-\-server\fP \(aqAPI_SERVER\(aq .INDENT 7.0 .INDENT 3.5 نشانی URL سرور API گلکسی. .UNINDENT .UNINDENT .UNINDENT .SH "متغیرهای محیطی (ENVIRONMENT)" .sp متغیرهای محیطی زیر می‌توانند مشخص شوند: .sp ANSIBLE_CONFIG \-\- مشخص کردن مسیر جایگزین برای پرونده پیکربندی انسیبل .sp متغیرهای بسیار بیشتری برای اکثر گزینه‌ها در ansible.cfg موجود است. .sp برای فهرست کامل به \% مراجعه کنید یا از دستور \fIansible\-config\fP استفاده نمایید. .SH "پرونده‌ها (FILES)" .sp /etc/ansible/ansible.cfg \-\- پرونده پیکربندی، در صورت وجود استفاده می‌شود .sp ~/.ansible.cfg \-\- پرونده پیکربندی کاربر، در صورت وجود بر پیکربندی پیش‌فرض اولویت دارد .sp \&./ansible.cfg \-\- پرونده پیکربندی محلی (در پوشه کاری جاری) که فرض می‌شود مختص پروژه است و در صورت وجود بر بقیه اولویت دارد. .sp همان‌طور که در بالا ذکر شد، متغیر محیطی ANSIBLE_CONFIG بر همه موارد دیگر اولویت خواهد داشت. .SH "نویسنده (AUTHOR)" .sp انسیبل در ابتدا توسط Michael DeHaan نوشته شده است. .SH "حق نشر (COPYRIGHT)" .sp حق نشر © 2018 Red Hat, Inc | Ansible. انسیبل تحت شرایط مجوز GPLv3 منتشر شده است. .SH "همچنین ببینید (SEE ALSO)" .sp \fBansible\fP (1), \fBansible\-config\fP (1), \fBansible\-console\fP (1), \fBansible\-doc\fP (1), \fBansible\-inventory\fP (1), \fBansible\-playbook\fP (1), \fBansible\-pull\fP (1), \fBansible\-vault\fP (1) .sp مستندات جامع در وب‌سایت مستندات در دسترس است: <\%> اطلاعات IRC و فهرست پستی در پرونده CONTRIBUTING.md قابل مشاهده است، در دسترس در: <\%> .\" End of generated man page.