.\" 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-pull" "1" "" "Ansible 2.21.3" "دستورات مدیریت سیستم" .SH "نام (NAME)" ansible-pull \- دریافت پلی‌بوک‌ها از مخزن سامانه کنترل نسخه (VCS) و اجرای آن‌ها روی میزبان هدف .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .TP .B usage: ansible\-pull [\-h] [\-\-version] [\-v] [\-\-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] [\-\-vault\-id VAULT_IDS] [\-J | \-\-vault\-password\-file VAULT_PASSWORD_FILES] [\-e EXTRA_VARS] [\-t TAGS] [\-\-skip\-tags SKIP_TAGS] [\-i INVENTORY] [\-\-list\-hosts] [\-l SUBSET] [\-\-flush\-cache] [\-M MODULE_PATH] [\-K | \-\-become\-password\-file BECOME_PASSWORD_FILE] [\-\-purge] [\-o] [\-s SLEEP] [\-f] [\-d DEST] [\-U URL] [\-\-full] [\-C CHECKOUT] [\-\-accept\-host\-key] [\-m MODULE_NAME] [\-\-verify\-commit] [\-\-clean] [\-\-track\-subs] [\-\-check] [\-\-diff] [playbook.yml ...] .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp برای دریافت و کشیدن یک نسخه دوردست از ansible روی هر گره تحت مدیریت استفاده می‌شود، به طوری که هر گره از طریق cron اجرا شده و سورس پلی‌بوک را از طریق یک مخزن مبدا به‌روزرسانی می‌کند. این کار معماری پیش‌فرض ارسال پیش‌ران (\fIpush\fP) انسیبل را به معماری مبتنی بر دریافت خودکار (\fIpull\fP) معکوس می‌کند که پتانسیل مقیاس‌پذیری تقریباً نامحدودی به همراه دارد. .sp هیچ‌یک از ابزارهای CLI برای اجرای همزمان با نمونه‌های دیگر از خود طراحی نشده‌اند؛ شما باید از یک زمان‌بند خارجی یا قفل‌گذاری استفاده کنید تا مطمئن شوید تداخل عملیاتی رخ نمی‌دهد. .sp پلی‌بوک راه‌اندازی می‌تواند برای تغییر تناوب cron، محل‌های ثبت لاگ و پارامترهای ارسالی به ansible\-pull تنظیم و بهینه‌سازی شود. این امر هم برای مقیاس‌پذیری بسیار بالا و هم برای اصلاح و تعمیرات دوره‌ای کارایی دارد. استفاده از ماژول \(aqfetch\(aq برای واکشی لاگ‌ها از اجراهای ansible\-pull روشی بسیار عالی برای گردآوری و تحلیل لاگ‌های راه دور خواهد بود. .SH "گزینه‌های عمومی (COMMON OPTIONS)" .INDENT 0.0 .INDENT 3.5 پلی‌بوک(ها) .UNINDENT .UNINDENT .sp \fB\-\-accept\-host\-key\fP .INDENT 0.0 .INDENT 3.5 افزودن hostkey برای نشانی مخزن در صورت عدم اضافه شدن قبلی .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\-\-check\fP .INDENT 0.0 .INDENT 3.5 هیچ تغییری اعمال نمی‌کند؛ در عوض سعی می‌کند تغییراتی که ممکن است رخ دهد را پیش‌بینی کند .UNINDENT .UNINDENT .sp \fB\-\-clean\fP .INDENT 0.0 .INDENT 3.5 فایل‌های دستکاری‌شده در مخزن کاری نادیده گرفته و دور ریخته خواهند شد .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\-\-diff\fP .INDENT 0.0 .INDENT 3.5 هنگام تغییر فایل‌ها و قالب‌های (کوچک)، تفاوت‌ها را در آن فایل‌ها نشان می‌دهد؛ همراه با \-\-check بسیار عالی عمل می‌کند .UNINDENT .UNINDENT .sp \fB\-\-flush\-cache\fP .INDENT 0.0 .INDENT 3.5 پاکسازی حافظه نهان فکت‌ها (fact cache) برای تمام میزبان‌های موجود در اینونتوری .UNINDENT .UNINDENT .sp \fB\-\-full\fP .INDENT 0.0 .INDENT 3.5 انجام یک کلون کامل به جای یک کلون کم‌عمق (shallow) .UNINDENT .UNINDENT .sp \fB\-\-list\-hosts\fP .INDENT 0.0 .INDENT 3.5 فهرستی از میزبان‌های منطبق را چاپ می‌کند؛ هیچ عملیات دیگری را اجرا نمی‌نماید .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\-\-purge\fP .INDENT 0.0 .INDENT 3.5 پاکسازی کامل نسخه واکشی‌شده (checkout) پس از پایان اجرای پلی‌بوک .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\-\-skip\-tags\fP .INDENT 0.0 .INDENT 3.5 فقط بازی‌ها و تسک‌هایی را اجرا می‌کند که برچسب‌های آن‌ها با این مقادیر مطابقت نداشته باشد. این آرگومان را می‌توان چندین بار مشخص کرد. .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\-\-track\-subs\fP .INDENT 0.0 .INDENT 3.5 زیرماژول‌ها آخرین تغییرات را پیگیری خواهند کرد. این معادل تعیین پرچم \-\-remote در git submodule update است .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\-\-verify\-commit\fP .INDENT 0.0 .INDENT 3.5 تایید امضای GPG برای کامیت واکشی‌شده؛ در صورت عدم تایید، اجرای پلی‌بوک لغو می‌شود. ماژول VCS متناظر باید از چنین عملیاتی پشتیبانی کند .UNINDENT .UNINDENT .sp \fB\-\-version\fP .INDENT 0.0 .INDENT 3.5 نمایش شماره نسخه برنامه، مسیر فایل کانفیگ، مسیر جستجوی ماژول‌های پیکربندی‌شده، مسیر ماژول‌ها، مسیر فایل اجرایی و خروج .UNINDENT .UNINDENT .sp \fB\-C\fP \(aqCHECKOUT\(aq, \fB\-\-checkout\fP \(aqCHECKOUT\(aq .INDENT 0.0 .INDENT 3.5 شاخه/تگ/کامیتی که باید واکشی (checkout) شود. پیش‌فرض رفتار ماژول مخزن است. .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\-U\fP \(aqURL\(aq, \fB\-\-url\fP \(aqURL\(aq .INDENT 0.0 .INDENT 3.5 نشانی URL مخزن پلی‌بوک .UNINDENT .UNINDENT .sp \fB\-c\fP \(aqCONNECTION\(aq, \fB\-\-connection\fP \(aqCONNECTION\(aq .INDENT 0.0 .INDENT 3.5 نوع اتصال مورد استفاده (پیش‌فرض: ssh) .UNINDENT .UNINDENT .sp \fB\-d\fP \(aqDEST\(aq, \fB\-\-directory\fP \(aqDEST\(aq .INDENT 0.0 .INDENT 3.5 مسیر دایرکتوری که انسیبل مخزن را در آن واکشی (checkout) خواهد کرد. .UNINDENT .UNINDENT .sp \fB\-e\fP, \fB\-\-extra\-vars\fP .INDENT 0.0 .INDENT 3.5 تنظیم متغیرهای اضافی به صورت کلید=مقدار یا YAML/JSON؛ در صورت فایل بودن نام با @ شروع شود. این آرگومان می‌تواند چندین بار مشخص شود. .UNINDENT .UNINDENT .sp \fB\-f\fP, \fB\-\-force\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\-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\-m\fP \(aqMODULE_NAME\(aq, \fB\-\-module\-name\fP \(aqMODULE_NAME\(aq .INDENT 0.0 .INDENT 3.5 نام ماژول مخزن که انسیبل برای واکشی مخزن استفاده می‌کند. گزینه‌ها عبارتند از (\(aqgit\(aq, \(aqsubversion\(aq, \(aqhg\(aq, \(aqbzr\(aq). مقدار پیش‌فرض git است. .UNINDENT .UNINDENT .sp \fB\-o\fP, \fB\-\-only\-if\-changed\fP .INDENT 0.0 .INDENT 3.5 تنها در صورتی پلی‌بوک را اجرا می‌کند که مخزن به‌روزرسانی شده باشد .UNINDENT .UNINDENT .sp \fB\-s\fP \(aqSLEEP\(aq, \fB\-\-sleep\fP \(aqSLEEP\(aq .INDENT 0.0 .INDENT 3.5 وقفه به مدت تصادفی (بین ۰ تا n ثانیه) قبل از شروع. این روشی مناسب برای توزیع درخواست‌های git و جلوگیری از هجوم همزمان است .UNINDENT .UNINDENT .sp \fB\-t\fP, \fB\-\-tags\fP .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 اتصال با این کاربر (پیش‌فرض: هیچ‌کدام) .UNINDENT .UNINDENT .sp \fB\-v\fP, \fB\-\-verbose\fP .INDENT 0.0 .INDENT 3.5 باعث می‌شود انسیبل پیام‌های اشکال‌زدایی بیشتری چاپ کند. افزودن چند \-v سطح جزئیات را افزایش می‌دهد؛ پلاگین‌های داخلی فعلی تا \-vvvvvv را ارزیابی می‌کنند. یک سطح معقول برای شروع \-vvv است؛ اشکال‌زدایی اتصال ممکن است به \-vvvv نیاز داشته باشد. این آرگومان را می‌توان چندین بار مشخص کرد. .UNINDENT .UNINDENT .SH "آرگومان‌ها (ARGUMENTS)" .sp playbook.yml .sp نام یکی از فایل‌های فرمت YAML برای اجرا به عنوان پلی‌بوک انسیبل. این می‌تواند یک مسیر نسبی درون مخزن واکشی‌شده باشد. به طور پیش‌فرض، انسیبل به دنبال پلی‌بوکی بر اساس نام دامنه کاملاً واجد شرایط (FQDN) میزبان، نام میزبان و در نهایت پلی‌بوکی به نام \fIlocal.yml\fP می‌گردد. .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 انسیبل در اصل توسط 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\-galaxy\fP (1), \fBansible\-inventory\fP (1), \fBansible\-playbook\fP (1), \fBansible\-vault\fP (1) .sp مستندات گسترده در سایت مستندات در دسترس است: . اطلاعات IRC و فهرست پستی را می‌توان در فایل CONTRIBUTING.md یافت، موجود در: