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 # 要執行的模塊,默認為command。 -M # 要執行的模塊的路徑。 -o # 壓縮輸出,摘要輸出.嘗試一切都在一行上輸出。 -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 只運行標記此標簽的任務