Ansible配置文件,但是ansible.


ansible配置文件详解

1、/etc/ansible有以下三个文件或者目录生成

  • /etc/ansible/Hosts
    • 主机清单配置文件
  • /etc/ansible/ansible.cfg
    • Ansible主配置文件
  • /etc/ansible/Roles
    • 角色定义目录

2、ansible配置文件优先级

​ 在Ansible中,它的配置文件是一个名为ansible.cfg的配置文件,ansible.cfg配置文件是以ini格式存储配置数据的。但是ansible.cfg配置文件可以存放在不同的目录,但只有一个可用,在运行Ansible命令时,Ansible将会按照预先设定的顺序查找配置文件,检查到哪个就用哪个。

Ansible预先设定的优先级顺序如下:

  • ANSIBLE_CFG:首先,Ansible命令会先检查环境变量,及这个环境变量将指向的配置文件;
  • ./ansible.cfg:其次,将会检查当前目录下的ansible.cfg配置文件;
  • ~/.ansible.cfg:再次,将会检查当前用户home目录下的.ansible.cfg配置文件;
  • /etc/ansible/ansible.cfg:最后,将会检查在安装Ansible时自动生产的配置文件。

​ 几乎所有的配置项都可以通过Ansible的playbook或环境变量来重新赋值,所以当你怎么都不知道这个变量在哪里定义的时候,不妨去看看环境变量里看看。根据我这么多年的运维经验来说,我建议使用~/.ansible.cfg作为配置文件使用,这样就可以实现每个用户都有自己独自的配置文件,不污染其它用户正常使用Ansible,同时也方便进行选项配置。

3、主配置文件解析

配置文件分段说明

ansible.cfg的配置默认分为八段:

  • [defaults]:通用配置项
  • [inventory]:与主机清单相关的配置项
  • [privilege_escalation]:特权升级相关的配置项
  • [paramiko_connection]:使用paramiko连接的相关配置项,Paramiko在RHEL6以及更早的版本中默认使用的ssh连接方式
  • [ssh_connection]:使用OpenSSH连接的相关配置项,OpenSSH是Ansible在RHEL6之后默认使用的ssh连接方式
  • [persistent_connection]:持久连接的配置项
  • [accelerate]:加速模式配置项
  • [selinux]:selinux相关的配置项
  • [colors]:ansible命令输出的颜色相关的配置项
  • [diff]:定义是否在运行时打印diff(变更前与变更后的差异)

配置参数说明

  • defaults配置

    配置项说明默认值
    inventoryansible inventory文件路径/etc/ansible/hosts
    libraryansible模块文件路径/usr/share/my_modules/
    remote_tmpansible远程主机脚本临时存放目录~/.ansible/tmp
    local_tmpansible管理节点脚本临时存放目录~/.ansible/tmp
    forksansible执行并发数5
    poll_intervalansible异步任务查询间隔15
    sudo_useransible sudo用户root
    ask_sudo_pass运行ansible是否提示输入sudo密码True
    ask_pass运行ansible是否提示输入密码True
    transportansible远程传输模式smart
    remote_port远程主机SSH端口22
    module_langansible模块运行默认语言环境C
    gatheringfacts信息收集开关定义smart
    roles_pathansible role存放路径/etc/ansible/roles
    timeoutansible SSH连接超时时间10
    remote_useransible远程认证用户root
    log_pathansible日志记录文件/var/log/ansible.log
    module_nameansible默认执行模块command
    executableansible命令执行shell/bin/sh
    hash_behaviouransible主机变量重复处理方式replace
    private_role_vars默认情况下,角色中的变量将在全局变量范围中可见。 为了防止这种情况,可以启用以下选项,只有tasks的任务和handlers得任务可以看到角色变量yes
    vault_password_file指定vault密码文件路径
    ansible_managed定义的一个Jinja2变量,可以插入到Ansible配置模版系统生成的文件中Ansible managed
    display_skipped_hosts开启显示跳过的主机True
    error_on_undefined_vars开启错误,或者没有定义的变量False
    action_pluginsansible action插件路径
    cache_pluginsansible cache插件路径
    callback_pluginsansible callback插件路径
    connection_pluginsansible connection插件路径
    lookup_pluginsansible lookup插件路径
    inventory_pluginsansible inventory插件路径
    vars_pluginsansible vars插件路径
    filter_pluginsansible filter插件路径
    terminal_pluginsansible terminal插件路径
    strategy_pluginsansible strategy插件路径
    fact_caching定义ansible facts缓存方式memory
    fact_caching_connection定义ansible facts缓存路径
  • privilege_escalation配置

    配置项说明默认值
    become是否开启become模式True
    become_method定义become方式sudo
    become_user定义become方式root
    become_ask_pass是否定义become提示密码False

4、主机清单(Inventory)

​ 在Ansible中描述主机的默认方法是将它们列在一个文本文件中,这个文本文件叫作inventory文件。Ansible Inventory 是包含静态 Inventory 和动态 Inventory 两部分的,静态 Inventory 指的是在文件中指定的主机和组,动态 Inventory 指通过外部脚本获取主机列表,并按照 ansible 所要求的格式返回给 ansilbe 命令的。这部分一般会结合 CMDB 资管系统、云计算平台等获取主机信息。此博文主要介绍静态Inventory的配置定义方法。默认的文件路径为 /etc/ansible/hosts。除默认文件外,你还可以同时使用多个 inventory 文件。如果需要使用非默认的Inventory文件,在执行Ansible命令时使用-i参数指定Inventory文件。

4.1 定义主机和组

​ Inventory配置文件遵循的是INI文件风格,中括号表示组名,其支持将同一个主机加入到不同的组中,此外若主机没有使用默认的SSH的22端口,还可以在主机名字或者IP后面加上冒号来指定,#号为注释行

示例(编辑/etc/ansible/hosts文件):

# 直接跟主机IP及其他端口
192.168.111.120
192.168.111.120:2333
 
# 使用主机hostname及其他端口
ansible-node1
ansible-node1:2333
 
# 主机分组
[webserver]
192.168.111.120
ansible-node1:2333
 
# 连续主机
[dbserver]
192.168.111.[100:200]    # 表示192.168.111.100--192.168.111.200之间的所有主机
ansible-node[10:20]:2333 # 表示ansible-node10:2333--ansible-node20:2333之间的所有主机

4.2 定义主机变量

​ 在工作中,通常会遇到非标准化的需求配置,考虑安全的问题,通常会把企业内部的80端口修改为其他的端口,这个就可以在Inventory中定义,然后在后续的playbook使用

示例(编辑/etc/ansible/hosts文件):

[dbserver]
# 自定义http_port的端口为80,配置maxRequestsPerChild(最大请求数)为801
192.168.111.120 http_port=808 maxRequestsPerChild=801
 
# 自定义http_port的端口为303,配置maxRequestsPerChild(最大请求数)为909
ansible-node1 http_port=303 maxRequestsPerChild=909

4.3 定义组变量

​ Ansible支持定义组的变量,主要是针对大量的机器的变量定义需求,赋予指定组内所有主机在playbook中可用的变量,等同于逐一给该组下的所有主机赋予同一个变量

示例(编辑/etc/ansible/hosts文件):

[groupserver]
192.168.111.120
ansible-node1
 
[groupserver:vars]
# 定义groupserver组中所有主机ntp_server的值为ntp1.aliyun.com
ntp_server=ntp1.aliyun.com
 
# 定义groupserver组中所有主机nfs_server的值为nfs.aliyun.com
nfs_server=nfs.aliyun.com

4.4 定义组嵌套和组变量

​ Inventory中,组还可以包含其他的组(嵌套),并且也可以向组中的主机指定变量,不过这些变量只能在playbook中使用,在ansible中不支持,组与组之间可以相互调用,并且可以向组中的主机指定变量

[groupserver]
192.168.111.120
ansible-node1
 
[groupserver:vars]
# 定义groupserver组中所有主机ntp_server的值为ntp1.aliyun.com
ntp_server=ntp1.aliyun.com
 
# 定义groupserver组中所有主机nfs_server的值为nfs.aliyun.com
nfs_server=nfs.aliyun.com

4.5 Inventory参数说明

通过设置下面的参数,可以控制 ansible 与远程主机的交互方式

参数默认值参数说明
ansible_ssh_host主机名ssh目标主机名或者IP
ansible_ssh_port22ssh目标端口
ansible_ssh_userrootssh登录使用的用户名
ansible_ssh_passnonessh认证使用的密码(这种方式并不安全,我们强烈建议使用 --ask-pass 或 SSH 密钥)
ansible_sudo_pass sudononesudo密码(这种方式并不安全,我们强烈建议使用 --ask-sudo-pass)
ansible_sudo_exe/usr/binsudo 命令路径(适用于1.8及以上版本)
ansible_connectionsmart与主机的连接类型.比如:local, ssh 或者 paramiko. Ansible 1.2 以前默认使用 paramiko.1.2 以后默认使用 ‘smart’,‘smart’ 方式会根据是否支持 ControlPersist, 来判断’ssh’ 方式是否可行.
ansible_ssh_private_key_filenonessh 使用的私钥文件.适用于有多个密钥,而你不想使用 SSH 代理的情况.
ansible_shell_typesh目标系统的shell类型.默认情况下,命令的执行使用 ‘sh’ 语法,可设置为 ‘csh’ 或 ‘fish’.
ansible_python_interpreter/usr/bin目标主机的 python 路径。适用于的情况: 系统中有多个 Python, 或者命令路径不是"/usr/bin/python",比如 *BSD, 或者 /usr/bin/python 不是 2.X 版本的 Python。我们不使用 “/usr/bin/env” 机制,因为这要求远程用户的路径设置正确,且要求 “python” 可执行程序名不可为 python以外的名字(实际有可能名为python26)。

5、练习

  • 安装 ansible 的软件包
  • 创建名为/home/student/ansible/inventory的静态清单文件, 以满足以下需求:
    • node1 是 dev 主机组的成员
    • node2 是 test 主机组的成员
    • node3 是 prod 主机组的成员
    • prod 组是 webservers 主机组的成员
  • 创建名为/home/student/ansible/ansible.cfg的配置文件, 以满足以下要求:
    • 主机清单文件为/home/student/ansible/inventory
    • playbook 中使用的角色的位置包括/home/student/ansible/roles
#第一步:通过远程连接greg用户进入控制节点control
[kiosk@foundation0 ~]$ ssh greg@control
#第二步:安装所需的软件包
[greg@control ~]$ sudo yum -y install ansible
--检查软件是否安装成功
[greg@control ~]$ ansible --version
ansible 2.8.0

#第三步:先创建清单目录
[greg@control ~]$ mkdir /home/greg/ansible
--后编辑清单文件
[greg@control ~]$ vim /home/greg/ansible/inventory
[dev]
node1

[test]
node2

[prod]
node3
node4

[balancers]
node5

[webservers:children]
prod

#第四步:创建配置文件
[greg@control ~]$ cp /etc/ansible/ansible.cfg /home/greg/ansible/
[greg@control ~]$ vim /home/greg/ansible/ansible.cfg 
inventory       = /home/greg/ansible/inventory
roles_path    = home/greg/ansible/roles
host_key_checking = False

#第五步:检查
[greg@control ~]$ cd ansible/
[greg@control ansible]$ ansible-inventory --graph
@all:
  |--@balancers:
  |  |--node5
  |--@dev:
  |  |--node1
  |--@test:
  |  |--node2
  |--@ungrouped:
  |--@webservers:
  |  |--@prod:
  |  |  |--node3
  |  |  |--node4
[greg@control ansible]$ ansible all -m ping
node3 | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": false,
    "ping": "pong"
}
node5 | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": false,
    "ping": "pong"
}
node4 | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": false,
    "ping": "pong"
}
node2 | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": false,
    "ping": "pong"
}
node1 | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": false,
    "ping": "pong"
}

相关内容