Ansible 命令

Ansible 系列：

• （一）：快速上手 Ansible
• （二）：Ansible 命令
• （三）：Ansible 主機清單配置文件
• （四）：Ansible Playbook 劇本語法

Ansible 命令

ansible

Ad-Hoc 即單條命令，指須要快速執行而且不須要保存的命令。默認不指定模塊時，使用的是 Command 模塊。

Usage: ansible <host-pattern> [options]

命令選項
-a # 模塊的參數。
-B # 異步運行時，多長時間超時。
-P # 若是使用-B，則設置輪詢間隔。
-C # 只是測試一下會改變什麼內容，不會真正去執行;相反,試圖預測一些可能發生的變化。
-D # 當更改文件和模板時，顯示這些文件得差別，比--check效果好。
-f # 指定定要使用的並行進程數，默認爲5個。
-i # 指定主機清單文件或逗號分隔的主機，默認爲/etc/ansible/hosts。
-l # 進一步限制所選主機/組模式，只執行-l 後的主機和組。 也能夠這樣使用 -l @retry_hosts.txt
-m &emsp;&emsp;# 要執行的模塊，默認爲command。
-M &emsp;&emsp;# 要執行的模塊的路徑。
-o &emsp;&emsp;# 壓縮輸出，摘要輸出.嘗試一切都在一行上輸出。
-v, --verbose # 輸出執行的詳細信息，使用-vvv得到更多，-vvvv 啓用鏈接調試
--version # 顯示程序版本號
-e --extra-vars=EXTRA_VARS # 添加附加變量，好比key=value，yaml，json格式。
--list-hosts # 輸出將要操做的主機列表，不會執行操做
--output=OUTPUT_FILE # 加密或解密輸出文件名 用於標準輸出。
--tree=TREE # 將日誌內容保存在該目錄中,文件名以執行主機名命名。
--syntax-check # 對playbook進行語法檢查，且不執行playbook。
--ask-vault-pass # vault 密碼。
--vault-password-file=VAULT_PASSWORD_FILE vault密碼文件
--new-vault-password-file=NEW_VAULT_PASSWORD_FILE 新vault密鑰文件。
 
 
鏈接選項:
-k --ask-pass # 要求用戶輸入請求鏈接密碼
-u --user=REMOTE_USER # 鏈接遠程用戶
-c --connection=CONNECTION # 鏈接類型，默認smart，支持local ssh 和 paramiko
-T --timeout=TIMEOUT # 指定默認超時時間，默認是10S
--ssh-common-args=SSH_COMMON_ARGS # 指定要傳遞給sftp / scp / ssh的常見參數 （例如 ProxyCommand）
--sftp-extra-args=SFTP_EXTRA_ARGS # 指定要傳遞給sftp，例如-f -l
--scp-extra-args=SCP_EXTRA_ARGS # 指定要傳遞給scp，例如 -l
--ssh-extra-args=SSH_EXTRA_ARGS # 指定要傳遞給ssh，例如 -R
--private-key=PRIVATE_KEY_FILE, --key-file=PRIVATE_KEY_FILE 私鑰路徑，使用這個文件來驗證鏈接
 
 
特權升級選項：
-s --sudo # 使用sudo (nopasswd)運行操做， 不推薦使用
-U --sudo-user=SUDO_USER # sudo 用戶，默認爲root， 不推薦使用
-S --su # 使用su運行操做 不推薦使用
-R --su-user=SU_USER # su 用戶，默認爲root，不推薦使用
-b --become # 運行操做
--become-method=BECOME_METHOD # 權限升級方法使用 ，默認爲sudo，有效選擇：sudo,su,pbrun,pfexec,runas,doas,dzdo
--become-user=BECOME_USER # 使用哪一個用戶運行，默認爲root
--ask-sudo-pass # sudo密碼，不推薦使用
--ask-su-pass # su密碼，不推薦使用
-K --ask-become-pass # 權限提高密碼
複製代碼

ansible-doc

用於查看模塊信息。

Usage: ansible <host-pattern> [options]

選項
-h --help # 顯示此幫助信息
-l --list # 列出可用的模塊
-s --snippet # 顯示playbook制定模塊的用法
-v --verbose # 詳細模式（-vvv表示更多，-vvvv表示啓用鏈接調試）
--version # 顯示程序版本號
-M --module-path=MODULE_PATH # 指定模塊庫的路徑


示例：
ansible-doc -l
ansible-doc shell
ansible-doc -s shell
複製代碼

ansible-playbook

對於需反覆執行的、較爲複雜的任務，咱們能夠經過定義 Playbook 來搞定。它容許使用變量、條件、循環、以及模板，也能經過角色及包含指令來重用既有內容。

Usage: ansible-playbook playbook.yml

相對於ansible，增長了下列選項：
--flush-cache # 清除fact緩存
--syntax-check # 語法檢查
--force-handlers # 若是任務失敗，也要運行handlers
--list-tags # 列出全部可用的標籤
--list-tasks # 列出將要執行的全部任務
--skip-tags=SKIP_TAGS # 跳過運行標記此標籤的任務
--start-at-task=START_AT_TASK # 在此任務處開始運行
--step 一步一步：在運行以前確認每一個任務
-t TAGS, --tags=TAGS 只運行標記此標籤的任務
複製代碼