ansible-命令使用说明

1. ansible命令的使用说明
  ansible 主机或组-m 模块名-a '模块参数' ansible参数
  表示调用什么模块,使用模块的那些参数
   • 主机和组,是在/etc/ansible/hosts 里进行指定的部分,当然动态Inventory 使用的是脚本从外部应用里获取的主机;
     • 模块名,可以通过ansible-doc -l 查看目前安装的模块,默认不指定时,使用的是command模块,具体可以查看/etc/ansible/ansible.cfg 的“#module_name = command ” 部分,默认模块可以在该配置文件中进行修改;
     • 模块参数,可以通过 “ansible-doc -s 模块名” 查看具体的用法及后面的参数;
     • ansible参数,可以通过ansible命令的帮助信息里查看到,这里有很多参数可以供选择,如是否需要输入密码、是否sudo等。
2. 命令执行模块
    命令执行模块包含如下 四个模块:
    • command模块:该模块通过-a跟上要执行的命令可以直接执行,不过命令里如果有带有如下字符部分则执行不成功 “ "<", ">", "|", "&" ;
    • shell 模块:用法基本和command一样,不过其是通过/bin/sh进行执行,所以shell 模块可以执行任何命令,就像在本机执行一样;
    • raw模块:用法和shell 模块一样 ,其也可以执行任意命令,就像在本机执行一样;
    • script模块:其是将管理端的shell 在被管理主机上执行,其原理是先将shell 复制到远程主机,再在远程主机上执行,原理类似于raw模块。
    注:raw模块和comand、shell 模块不同的是其没有chdir、creates、removes参数,chdir参数的作用就是先切到chdir指定的目录后,再执行后面的命令,这在后面很多模块里都会有该参数 。
     command模块包含如下选项:
    • creates:一个文件名,当该文件存在,则该命令不执行
    • free_form:要执行的linux指令
    • chdir:在执行指令之前,先切换到该指定的目录
    • removes:一个文件名,当该文件不存在,则该选项不执行
    • executable:切换shell来执行指令,该执行路径必须是一个绝对路径
3. ansible -h详解
  

 1     [root@localhost ~]# ansible -h
 2     Usage: ansible <host-pattern> [options]
 3     
 4     Options:
 5       -a MODULE_ARGS, --args=MODULE_ARGS    #模块的参数,如果执行默认COMMAND的模块,即是命令参数,如:“date”,"pwd"等等
 6                             module arguments    # 模块参数
 7       -k, --ask-pass        ask for SSH password     #登录密码,提示输入SSH密码而不是假设基于密钥的验证
 8       --ask-su-pass         ask for su password      #su切换密码
 9       -K, --ask-sudo-pass   ask for sudo password    # 提示密码使用sudo,sudo表示提权操作
10       --ask-vault-pass      ask for vault password
11       -B SECONDS, --background=SECONDS        # 后台运行超时时间
12                             run asynchronously, failing after X seconds
13                             (default=N/A)
14       -C, --check           don't make any changes; instead, try to predict some    #只是测试一下会改变什么内容,不会真正去执行;相反,试图预测一些可能发生的变化
15                             of the changes that may occur
16       -c CONNECTION, --connection=CONNECTION       #连接类型使用。可能的选项是paramiko(SSH),SSH和地方。当地主要是用于crontab或启动。
17                             connection type to use (default=smart)
18       -f FORKS, --forks=FORKS        #并行任务数。NUM被指定为一个整数,默认是5
19                             specify number of parallel processes to use
20                             (default=5)
21       -h, --help            show this help message and exit      # 打开帮助文档API
22       -i INVENTORY, --inventory-file=INVENTORY         #指定库存主机文件的路径,默认为/etc/ansible/hosts
23                             specify inventory host file
24                             (default=/etc/ansible/hosts)
25       -l SUBSET, --limit=SUBSET          #进一步限制所选主机/组模式  --limit=192.168.91.135 只对这个ip执行
26                             further limit selected hosts to an additional pattern
27       --list-hosts          outputs a list of matching hosts; does not execute
28                             anything else
29       -m MODULE_NAME, --module-name=MODULE_NAME         # 执行模块的名字,默认使用 command 模块,所以如果是只执行单一命令可以不用 -m参数
30                             module name to execute (default=command)
31       -M MODULE_PATH, --module-path=MODULE_PATH        #要执行的模块的路径,默认为/usr/share/ansible/
32                             specify path(s) to module library
33                             (default=/usr/share/ansible/)
34       -o, --one-line        condense output          # 压缩输出,摘要输出.尝试一切都在一行上输出。
35       -P POLL_INTERVAL, --poll=POLL_INTERVAL        #调查背景工作每隔数秒。需要- b
36                             set the poll interval if using -B (default=15)
37       --private-key=PRIVATE_KEY_FILE           # 私钥路径,使用这个文件来验证连接
38                             use this file to authenticate the connection
39       -S, --su              run operations with su       #用 su 命令
40       -R SU_USER, --su-user=SU_USER         # 指定SU的用户,默认是root用户
41                             run operations with su as this user (default=root)
42       -s, --sudo            run operations with sudo (nopasswd)    
43       -U SUDO_USER, --sudo-user=SUDO_USER    #sudo到哪个用户,默认为 root  
44                             desired sudo user (default=root)
45       -T TIMEOUT, --timeout=TIMEOUT         #指定SSH默认超时时间,  默认是10S
46                             override the SSH timeout in seconds (default=10)
47       -t TREE, --tree=TREE  log output to this directory        #将日志内容保存在该输出目录,结果保存在一个文件中在每台主机上。
48       -u REMOTE_USER, --user=REMOTE_USER        #远程用户, 默认是root用户
49                             connect as this user (default=root)
50       --vault-password-file=VAULT_PASSWORD_FILE  
51                             vault password file
52       -v, --verbose         verbose mode (-vvv for more, -vvvv to enable       #详细信息
53                             connection debugging)
54       --version             show program's version number and exit        # 输出ansible的版本
原文地址:https://www.cnblogs.com/scajy/p/11353825.html