.\" 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-console" "1" "" "Ansible 2.21.3" "دستورات مدیریت سیستم" .SH "نام (NAME)" ansible\-console \- کنسول تعاملی (REPL) برای اجرای وظایف Ansible .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .TP .B usage: ansible\-console [\-h] [\-\-version] [\-v] [\-b] [\-\-become\-method BECOME_METHOD] [\-\-become\-user BECOME_USER] [\-K | \-\-become\-password\-file BECOME_PASSWORD_FILE] [\-i INVENTORY] [\-\-list\-hosts] [\-l SUBSET] [\-\-flush\-cache] [\-\-private\-key PRIVATE_KEY_FILE] [\-u REMOTE_USER] [\-c CONNECTION] [\-T TIMEOUT] [\-\-ssh\-common\-args SSH_COMMON_ARGS] [\-\-sftp\-extra\-args SFTP_EXTRA_ARGS] [\-\-scp\-extra\-args SCP_EXTRA_ARGS] [\-\-ssh\-extra\-args SSH_EXTRA_ARGS] [\-k | \-\-connection\-password\-file CONNECTION_PASSWORD_FILE] [\-C] [\-D] [\-\-vault\-id VAULT_IDS] [\-J | \-\-vault\-password\-file VAULT_PASSWORD_FILES] [\-f FORKS] [\-M MODULE_PATH] [\-\-playbook\-dir BASEDIR] [\-e EXTRA_VARS] [\-\-task\-timeout TASK_TIMEOUT] [\-\-step] [pattern] .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp یک کنسول تعاملی (REPL) که امکان اجرای وظایف فی‌البداهه (ad\-hoc) را در برابر یک اینونتوری انتخابی، از طریق یک پوسته مناسب با قابلیت تکمیل خودکار با کلید تب (tab completion) فراهم می‌کند (بر پایه \fBansible\-shell\fP متعلق به dominis). .sp این ابزار از چندین دستور پشتیبانی می‌کند و می‌توانید پیکربندی آن را در زمان اجرا تغییر دهید: .INDENT 0.0 .IP \(bu 2 \fBcd [pattern]\fP: تغییر میزبان/گروه (می‌توانید از الگوهای میزبان استفاده کنید؛ مثلاً: \fBapp*.dc*:!app01*\fP) .IP \(bu 2 \fBlist\fP: فهرست کردن میزبان‌های موجود در مسیر جاری .IP \(bu 2 \fBlist groups\fP: فهرست کردن گروه‌های موجود در مسیر جاری .IP \(bu 2 \fBbecome\fP: تغییر وضعیت فلگ become .IP \(bu 2 \fB!\fP: اجبار به استفاده از ماژول shell به جای ماژول ansible (\fB!yum update \-y\fP) .IP \(bu 2 \fBverbosity [num]\fP: تنظیم سطح جزئیات خروجی (verbosity) .IP \(bu 2 \fBforks [num]\fP: تنظیم تعداد فرآیندهای موازی (forks) .IP \(bu 2 \fBbecome_user [user]\fP: تنظیم become_user .IP \(bu 2 \fBremote_user [user]\fP: تنظیم remote_user .IP \(bu 2 \fBbecome_method [method]\fP: تنظیم روش ارتقای دسترسی (privilege escalation) .IP \(bu 2 \fBcheck [bool]\fP: تغییر وضعیت حالت بررسی (check mode) .IP \(bu 2 \fBdiff [bool]\fP: تغییر وضعیت حالت مقایسه (diff mode) .IP \(bu 2 \fBtimeout [integer]\fP: تنظیم مهلت زمانی وظایف به ثانیه (0 برای غیرفعال کردن) .IP \(bu 2 \fBhelp [command/module]\fP: نمایش مستندات برای دستور یا ماژول .IP \(bu 2 \fBexit\fP: خروج از \fBansible\-console\fP .UNINDENT .SH "گزینه‌های عمومی (COMMON OPTIONS)" .INDENT 0.0 .INDENT 3.5 الگوی میزبان (host pattern) .UNINDENT .UNINDENT .sp \fB\-\-become\-method\fP \(aqBECOME_METHOD\(aq .INDENT 0.0 .INDENT 3.5 روش ارتقای دسترسی مورد استفاده (پیش‌فرض: sudo)، از \fIansible\-doc \-t become \-l\fP برای فهرست کردن گزینه‌های معتبر استفاده کنید. .UNINDENT .UNINDENT .sp \fB\-\-become\-password\-file\fP \(aqBECOME_PASSWORD_FILE\(aq, \fB\-\-become\-pass\-file\fP \(aqBECOME_PASSWORD_FILE\(aq .INDENT 0.0 .INDENT 3.5 فایل گذرواژه ارتقای دسترسی (become) .UNINDENT .UNINDENT .sp \fB\-\-become\-user\fP \(aqBECOME_USER\(aq .INDENT 0.0 .INDENT 3.5 اجرای عملیات با این کاربر (پیش‌فرض: root) .UNINDENT .UNINDENT .sp \fB\-\-connection\-password\-file\fP \(aqCONNECTION_PASSWORD_FILE\(aq, \fB\-\-conn\-pass\-file\fP \(aqCONNECTION_PASSWORD_FILE\(aq .INDENT 0.0 .INDENT 3.5 فایل گذرواژه اتصال .UNINDENT .UNINDENT .sp \fB\-\-flush\-cache\fP .INDENT 0.0 .INDENT 3.5 پاکسازی حافظه نهان فکت‌ها (fact cache) برای تمام میزبان‌های موجود در اینونتوری .UNINDENT .UNINDENT .sp \fB\-\-list\-hosts\fP .INDENT 0.0 .INDENT 3.5 فهرستی از میزبان‌های منطبق را چاپ می‌کند؛ هیچ عملیات دیگری را اجرا نمی‌کند .UNINDENT .UNINDENT .sp \fB\-\-playbook\-dir\fP \(aqBASEDIR\(aq .INDENT 0.0 .INDENT 3.5 از آن‌جا که این ابزار از پلی‌بوک‌ها استفاده نمی‌کند، از این دایرکتوری به عنوان جایگزین پوشه پلی‌بوک استفاده کنید. این گزینه مسیر نسبی را برای بسیاری از ویژگی‌ها از جمله roles/، group_vars/ و غیره تنظیم می‌کند. .UNINDENT .UNINDENT .sp \fB\-\-private\-key\fP \(aqPRIVATE_KEY_FILE\(aq, \fB\-\-key\-file\fP \(aqPRIVATE_KEY_FILE\(aq .INDENT 0.0 .INDENT 3.5 استفاده از این فایل برای احراز هویت اتصال .UNINDENT .UNINDENT .sp \fB\-\-scp\-extra\-args\fP \(aqSCP_EXTRA_ARGS\(aq .INDENT 0.0 .INDENT 3.5 تعیین آرگومان‌های اضافی برای ارسال اختصاصی به scp (مانند \-l) .UNINDENT .UNINDENT .sp \fB\-\-sftp\-extra\-args\fP \(aqSFTP_EXTRA_ARGS\(aq .INDENT 0.0 .INDENT 3.5 تعیین آرگومان‌های اضافی برای ارسال اختصاصی به sftp (مانند \-f، \-l) .UNINDENT .UNINDENT .sp \fB\-\-ssh\-common\-args\fP \(aqSSH_COMMON_ARGS\(aq .INDENT 0.0 .INDENT 3.5 تعیین آرگومان‌های مشترک برای ارسال به sftp/scp/ssh (مانند ProxyCommand) .UNINDENT .UNINDENT .sp \fB\-\-ssh\-extra\-args\fP \(aqSSH_EXTRA_ARGS\(aq .INDENT 0.0 .INDENT 3.5 تعیین آرگومان‌های اضافی برای ارسال اختصاصی به ssh (مانند \-R) .UNINDENT .UNINDENT .sp \fB\-\-step\fP .INDENT 0.0 .INDENT 3.5 گام‌به‌گام: تایید هر وظیفه پیش از اجرا .UNINDENT .UNINDENT .sp \fB\-\-task\-timeout\fP \(aqTASK_TIMEOUT\(aq .INDENT 0.0 .INDENT 3.5 تنظیم محدودیت مهلت زمانی وظیفه (task) به ثانیه؛ باید یک عدد صحیح مثبت باشد. .UNINDENT .UNINDENT .sp \fB\-\-vault\-id\fP .INDENT 0.0 .INDENT 3.5 شناسه والت (vault identity) برای استفاده. این آرگومان می‌تواند چندین بار مشخص شود. .UNINDENT .UNINDENT .sp \fB\-\-vault\-password\-file\fP, \fB\-\-vault\-pass\-file\fP .INDENT 0.0 .INDENT 3.5 فایل گذرواژه والت .UNINDENT .UNINDENT .sp \fB\-\-version\fP .INDENT 0.0 .INDENT 3.5 نمایش شماره نسخه برنامه، مکان فایل پیکربندی، مسیر جستجوی ماژول‌های پیکربندی‌شده، مکان ماژول، مکان فایل اجرایی و خروج .UNINDENT .UNINDENT .sp \fB\-C\fP, \fB\-\-check\fP .INDENT 0.0 .INDENT 3.5 هیچ تغییری اعمال نمی‌کند؛ در عوض سعی می‌کند برخی از تغییراتی که ممکن است رخ دهد را پیش‌بینی کند .UNINDENT .UNINDENT .sp \fB\-D\fP, \fB\-\-diff\fP .INDENT 0.0 .INDENT 3.5 هنگام تغییر فایل‌ها و قالب‌های (کوچک)، تفاوت‌ها را در آن فایل‌ها نشان می‌دهد؛ همراه با \-\-check بسیار عالی عمل می‌کند .UNINDENT .UNINDENT .sp \fB\-J\fP, \fB\-\-ask\-vault\-password\fP, \fB\-\-ask\-vault\-pass\fP .INDENT 0.0 .INDENT 3.5 درخواست گذرواژه والت .UNINDENT .UNINDENT .sp \fB\-K\fP, \fB\-\-ask\-become\-pass\fP .INDENT 0.0 .INDENT 3.5 درخواست گذرواژه ارتقای دسترسی (privilege escalation) .UNINDENT .UNINDENT .sp \fB\-M\fP, \fB\-\-module\-path\fP .INDENT 0.0 .INDENT 3.5 افزودن مسیر(های) جداشده با دونقطه به ابتدای کتابخانه ماژول‌ها (پیش‌فرض: {{ ANSIBLE_HOME ~ \(dq/plugins/modules:/usr/share/ansible/plugins/modules\(dq }}). این آرگومان را می‌توان چندین بار مشخص کرد. .UNINDENT .UNINDENT .sp \fB\-T\fP \(aqTIMEOUT\(aq, \fB\-\-timeout\fP \(aqTIMEOUT\(aq .INDENT 0.0 .INDENT 3.5 بازنویسی مهلت زمانی اتصال به ثانیه (پیش‌فرض بستگی به نوع اتصال دارد) .UNINDENT .UNINDENT .sp \fB\-b\fP, \fB\-\-become\fP .INDENT 0.0 .INDENT 3.5 اجرای عملیات با become (به معنای درخواست گذرواژه نیست) .UNINDENT .UNINDENT .sp \fB\-c\fP \(aqCONNECTION\(aq, \fB\-\-connection\fP \(aqCONNECTION\(aq .INDENT 0.0 .INDENT 3.5 نوع اتصال مورد استفاده (پیش‌فرض: ssh) .UNINDENT .UNINDENT .sp \fB\-e\fP, \fB\-\-extra\-vars\fP .INDENT 0.0 .INDENT 3.5 تنظیم متغیرهای اضافی به صورت کلید=مقدار یا YAML/JSON؛ در صورت فایل بودن نام با @ شروع شود. این آرگومان می‌تواند چندین بار مشخص شود. .UNINDENT .UNINDENT .sp \fB\-f\fP \(aqFORKS\(aq, \fB\-\-forks\fP \(aqFORKS\(aq .INDENT 0.0 .INDENT 3.5 تعیین تعداد فرآیندهای موازی برای استفاده (پیش‌فرض: 5) .UNINDENT .UNINDENT .sp \fB\-h\fP, \fB\-\-help\fP .INDENT 0.0 .INDENT 3.5 نمایش این پیام راهنما و خروج .UNINDENT .UNINDENT .sp \fB\-i\fP, \fB\-\-inventory\fP, \fB\-\-inventory\-file\fP .INDENT 0.0 .INDENT 3.5 مشخص کردن مسیر اینونتوری میزبان‌ها یا فهرست میزبان‌های جداشده با کاما. این آرگومان را می‌توان چندین بار مشخص کرد. .UNINDENT .UNINDENT .sp \fB\-k\fP, \fB\-\-ask\-pass\fP .INDENT 0.0 .INDENT 3.5 درخواست گذرواژه اتصال .UNINDENT .UNINDENT .sp \fB\-l\fP \(aqSUBSET\(aq, \fB\-\-limit\fP \(aqSUBSET\(aq .INDENT 0.0 .INDENT 3.5 محدود کردن بیشتر میزبان‌های انتخاب‌شده بر اساس یک الگوی اضافی .UNINDENT .UNINDENT .sp \fB\-u\fP \(aqREMOTE_USER\(aq, \fB\-\-user\fP \(aqREMOTE_USER\(aq .INDENT 0.0 .INDENT 3.5 اتصال با این کاربر (پیش‌فرض: None) .UNINDENT .UNINDENT .sp \fB\-v\fP, \fB\-\-verbose\fP .INDENT 0.0 .INDENT 3.5 باعث می‌شود انسیبل پیام‌های اشکال‌زدایی بیشتری چاپ کند. افزودن چند \-v سطح جزئیات را افزایش می‌دهد؛ پلاگین‌های داخلی فعلی تا \-vvvvvv را ارزیابی می‌کنند. یک سطح معقول برای شروع \-vvv است؛ اشکال‌زدایی اتصال ممکن است به \-vvvv نیاز داشته باشد. این آرگومان را می‌توان چندین بار مشخص کرد. .UNINDENT .UNINDENT .SH "آرگومان‌ها (ARGUMENTS)" .sp host\-pattern .sp نام یک گروه در اینونتوری، یک تطابق سراسری (glob) شبیه به پوسته برای انتخاب میزبان‌ها در اینونتوری، یا هر ترکیبی از این دو که با کاما از هم جدا شده باشند. .SH "اینونتوری (INVENTORY)" .sp انسیبل میزبان‌هایی را که به طور بالقوه می‌تواند روی آن‌ها کار کند در یک اینونتوری نگهداری می‌نماید. این می‌تواند یک فایل YAML، فایل شبه-ini، یک اسکریپت، دایرکتوری، فهرست و غیره باشد. برای گزینه‌های اضافی، مستندات موجود در را ببینید. .SH "محیط (ENVIRONMENT)" .sp متغیرهای محیطی زیر را می‌توان تعیین کرد: .sp ANSIBLE_INVENTORY \-\- بازنویسی منابع پیش‌فرض اینونتوری انسیبل .sp ANSIBLE_LIBRARY \-\- بازنویسی مسیر پیش‌فرض کتابخانه ماژول‌های انسیبل .sp ANSIBLE_CONFIG \-\- تعیین مسیر جایگزین برای فایل پیکربندی انسیبل .sp متغیرهای بسیار بیشتری برای اغلب گزینه‌ها در ansible.cfg موجود هستند. .sp برای فهرست کامل به مراجعه کنید یا از دستور \fIansible\-config\fP بهره بگیرید. .SH "فایل‌ها (FILES)" .sp /etc/ansible/hosts \-\- فایل پیش‌فرض اینونتوری .sp /etc/ansible/ansible.cfg \-\- فایل پیکربندی، در صورت وجود استفاده می‌شود .sp ~/.ansible.cfg \-\- فایل پیکربندی کاربر، در صورت وجود بر پیکربندی پیش‌فرض اولویت دارد .sp \&./ansible.cfg \-\- فایل پیکربندی محلی (در دایرکتوری کاری جاری) که فرض می‌شود «مختص پروژه» است و در صورت وجود بر بقیه اولویت دارد. .sp همان‌طور که در بالا اشاره شد، متغیر محیطی ANSIBLE_CONFIG بر تمام موارد دیگر اولویت خواهد داشت. .SH "نویسندگان (AUTHORS)" .sp Ansible در ابتدا توسط Michael DeHaan نوشته شد. .SH "حق نشر (COPYRIGHT)" .sp حق نشر © 2018 Red Hat, Inc | Ansible. Ansible تحت شرایط مجوز GPLv3 منتشر شده است. .SH "همچنین ببینید (SEE ALSO)" .sp \fBansible\fP (1), \fBansible\-config\fP (1), \fBansible\-doc\fP (1), \fBansible\-galaxy\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.