ansible 参数的详解

Define and run a single task 'playbook' against a set of hosts

Options:
  -a MODULE_ARGS, --args=MODULE_ARGS
                        module arguments
  --ask-vault-pass      ask for vault password
  -B SECONDS, --background=SECONDS
                        run asynchronously, failing after X seconds
                        (default=N/A)
  -C, --check           don't make any changes; instead, try to predict some
                        of the changes that may occur
  -D, --diff            when changing (small) files and templates, show the
                        differences in those files; works great with --check
  -e EXTRA_VARS, --extra-vars=EXTRA_VARS
                        set additional variables as key=value or YAML/JSON, if
                        filename prepend with @
  -f FORKS, --forks=FORKS
                        specify number of parallel processes to use
                        (default=5)
  -h, --help            show this help message and exit
  -i INVENTORY, --inventory=INVENTORY, --inventory-file=INVENTORY
                        specify inventory host path or comma separated host
                        list. --inventory-file is deprecated
  -l SUBSET, --limit=SUBSET
                        further limit selected hosts to an additional pattern
  --list-hosts          outputs a list of matching hosts; does not execute
                        anything else
  -m MODULE_NAME, --module-name=MODULE_NAME
                        module name to execute (default=command)
  -M MODULE_PATH, --module-path=MODULE_PATH
                        prepend colon-separated path(s) to module library
                        (default=[u'/home/witcomm/.ansible/plugins/modules',
                        u'/usr/share/ansible/plugins/modules'])
  -o, --one-line        condense output
  --playbook-dir=BASEDIR
                        Since this tool does not use playbooks, use this as a
                        subsitute playbook directory.This sets the relative
                        path for many features including roles/ group_vars/
                        etc.
  -P POLL_INTERVAL, --poll=POLL_INTERVAL
                        set the poll interval if using -B (default=15)
  --syntax-check        perform a syntax check on the playbook, but do not
                        execute it
  -t TREE, --tree=TREE  log output to this directory
  --vault-id=VAULT_IDS  the vault identity to use
  --vault-password-file=VAULT_PASSWORD_FILES
                        vault password file
  -v, --verbose         verbose mode (-vvv for more, -vvvv to enable
                        connection debugging)
  --version             show program's version number and exit

  Connection Options:
    control as whom and how to connect to hosts

    -k, --ask-pass      ask for connection password
    --private-key=PRIVATE_KEY_FILE, --key-file=PRIVATE_KEY_FILE
                        use this file to authenticate the connection
    -u REMOTE_USER, --user=REMOTE_USER
                        connect as this user (default=None)
    -c CONNECTION, --connection=CONNECTION
                        connection type to use (default=smart)
    -T TIMEOUT, --timeout=TIMEOUT
                        override the connection timeout in seconds
                        (default=10)
    --ssh-common-args=SSH_COMMON_ARGS
                        specify common arguments to pass to sftp/scp/ssh (e.g.
                        ProxyCommand)
    --sftp-extra-args=SFTP_EXTRA_ARGS
                        specify extra arguments to pass to sftp only (e.g. -f,
                        -l)
    --scp-extra-args=SCP_EXTRA_ARGS
                        specify extra arguments to pass to scp only (e.g. -l)
    --ssh-extra-args=SSH_EXTRA_ARGS
                        specify extra arguments to pass to ssh only (e.g. -R)

  Privilege Escalation Options:
    control how and which user you become as on target hosts

    -s, --sudo          run operations with sudo (nopasswd) (deprecated, use
                        become)
    -U SUDO_USER, --sudo-user=SUDO_USER
                        desired sudo user (default=root) (deprecated, use
                        become)
    -S, --su            run operations with su (deprecated, use become)
    -R SU_USER, --su-user=SU_USER
                        run operations with su as this user (default=None)
                        (deprecated, use become)
    -b, --become        run operations with become (does not imply password
                        prompting)
    --become-method=BECOME_METHOD
                        privilege escalation method to use (default=sudo),
                        valid choices: [ sudo | su | pbrun | pfexec | doas |
                        dzdo | ksu | runas | pmrun | enable | machinectl ]
    --become-user=BECOME_USER
                        run operations as this user (default=root)
    --ask-sudo-pass     ask for sudo password (deprecated, use become)
    --ask-su-pass       ask for su password (deprecated, use become)
    -K, --ask-become-pass
                        ask for privilege escalation password

Some modules do not make sense in Ad-Hoc (include, meta, etc)

*****************************************

-a 命令行参数
  -B 后台运行时间
  -C 测试脚本能否运行，检查语法
  -D 对比文件与上次是否相同，不想同打印
  -e 添加额外文件yml
  -f 进程数(default=5)
  -h, --help   show this help message and exit
  -i 指定主机目录
  -l 指定所有运行的组，ansible all -l test1 -a ping    防止有组之间的继承
  -m 指定模板名字  module name to execute (default=command)
  -M 指顶模板路径
  -o, 异步
  --playbook-dir=BASEDIR
                        Since this tool does not use playbooks, use this as a
                        subsitute playbook directory.This sets the relative
                        path for many features including roles/ group_vars/
                        etc.
  -P 查询后台运行的状态查询B后台状态 (default=15)
  --syntax-check   异步进行的状态进度
  -t 是否输出历史纪录
  --vault-id=VAULT_IDS  the vault identity to use
  --vault-password-file=VAULT_PASSWORD_FILES
                        vault password file
  -v, --verbose   -vvv 调试状态
  --version  查看版本

  Connection Options:
    control as whom and how to connect to hosts

    -k, 连接输入密码
    --private-key=PRIVATE_KEY_FILE, --key-file=PRIVATE_KEY_FILE   指定私钥文件
                        use this file to authenticate the connection
    -u REMOTE_USER, --user=REMOTE_USER
                        connect as this user (default=None)
    -c 连接方式
                        connection type to use (default=smart)
    -T 超市时间
                        override the connection timeout in seconds
                        (default=10)

例如

ansible all -m ping -B 3600 -P 0 -o

放在后台执行， 启动异步进行
192.168.50.199 | CHANGED => {"ansible_job_id": "910638557875.5482", "changed": true, "finished": 0, "results_file": "/home/witcomm/.ansible_async/910638557875.5482", "started": 1}
47.104.102.87 | CHANGED => {"ansible_job_id": "324090424511.17675", "changed": true, "finished": 0, "results_file": "/root/.ansible_async/324090424511.17675", "started": 1}

查看后台运行情况
ansible all -m async_status -a "jid='136769868764.17606'"

查看系统信息
ansible all -m setup
帅选出想要看的信息
ansible test -m setup -a "filter=ansible_*_mb"


  "address": "172.31.139.133", 
            "alias": "eth0", 
            "broadcast": "172.31.143.255", 
            "gateway": "172.31.143.253", 
            "interface": "eth0", 
            "macaddress": "00:16:3e:08:40:17", 
            "mtu": 1500, 
            "netmask": "255.255.240.0", 
            "network": "172.31.128.0", 
            "type": "ether"