Ansible系列 : 基础文件

Inventory文件

Ansible通过inventory文件来配置主机清单,默认文件路径为/etc/ansible/hosts,也可以在自己的管理目录下创建inventory文件。

Inventory参数

参数 说明
ansible_ssh_host 远程的主机名
ansible_ssh_port 远程的端口
ansible_ssh_user SSH远程的用户
ansible_ssh_pass ssh密码
ansible_sudo_pass 建议使用--ask-sudo-pass选项
ansible_sudo_exe sudo路径
ansible_connection 连接方式,如local,ssh或paramiko
ansible_ssh_private_key_file ssh的私钥文件
ansible_shell_type 目标系统的shell类型,默认为sh
ansible_python_interpreter 目标主机的python路径

主机与组

inventory文件的基本格式如下:

10.0.139.163

[appserver]
10.0.139.161
10.0.139.162
10.255.210.15

[dbserver]
10.255.210.10
10.255.210.15

appserver和dbserver是自定义的组,一个主机可以属于多个不同的组,例如10.255.210.15属于appserver同时也可以属于dbserver,我们可以通过组来管理组下面的所有主机。

当主机列表存在一些静态IP地址,希望设置对应的主机别名,而不是配置/etc/hosts,可以通过下列方式定义

app1 ansible_ssh_port=30 ansible_ssh_host=10.0.139.163

主机格式还支持模糊匹配,例如我们可以用下列格式表示app1到app20这20台主机。

app[1:20].example.com

组与组之间还能进行嵌套

[k8s]
10.255.210.9

[db]
10.255.210.10
10.255.210.15

[server:children]
k8s
db

查看server包含的主机

[root@h-luhx-254 ~]# ansible server --list-host -i /data/ansible/Inventory/hosts 
  hosts (3):
    10.255.210.9
    10.255.210.10
    10.255.210.15

变量配置

对于主机或组,可以定义一系列变量,提供给playbook调用。例如http端口,文件路径等等

主机和组都可以设定变量

[k8s]
10.255.210.9 docker_path=/data/docker

[db]
10.255.210.10
10.255.210.15

[db:vars]
db_port=3306 
version=8.0.23

[server:children]
k8s
db

查看变量值

[root@h-luhx-254 playbook]# ansible-playbook test.yaml -i /data/ansible/Inventory -k
SSH password: 

PLAY [db] *************************************************************************************************************************************************************************

TASK [display variable from inventory file] ***************************************************************************************************************************************
ok: [10.255.210.10] => {
    "msg": "The 10.255.210.10 Value is 3306"
}
ok: [10.255.210.15] => {
    "msg": "The 10.255.210.15 Value is 3306"
}

PLAY RECAP ************************************************************************************************************************************************************************
10.255.210.10              : ok=1    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   
10.255.210.15              : ok=1    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0 

变量还可以保存在单独的文件中,格式为YAML,如下列文件

[root@h-luhx-254 Inventory]# mkdir /data/ansible/Inventory/{group_vars,host_vars}
[root@h-luhx-254 Inventory]# cat /data/ansible/Inventory/group_vars/db
---
db_port: 3306
db_version: 8.0.23

动态Inventory

除了前面基于文本的方式来记录intentory配置信息,Ansible也支持在其它软件系统中保存配置信息。例如EC2、Cobbler、Zabbix等外部系统。

存放主机信息的程序可以使用任何语言开发,其运行结果必须返回Json格式,同时需要支持--list和--host两个选项,--list用于返回所有的主机组信息,每个组包含的host,children、vars,_meta用于存放主机变量;--host则用于指定具体的host。大致格式如下:

{
    "docker": {
        "hosts": [
            "10.255.210.9"
        ]
    },
    "mysql": {
        "hosts": [
            "10.255.210.10",
            "10.255.210.15"
        ],
        "vars": {
            "mysql_port": 22,
            "mysql_version": "8.0.23"
        }
    }
}

在设计外部系统配置信息时,可以将Inventory配置信息记录在MySQL数据库中,再通过Python脚本获取数据并返回上述格式的JSON结果。

配置文件

Ansible会按照下列顺序读取配置文件,直到找到一个为止,并使用第一个找到的配置文件

  1. ANSIBLE_CONFIG环境变量
  2. 当前目录下的ansible.cfg
  3. home目录下的.ansible.cfg
  4. /etc/ansible/ansible.cfg

参数详解

defaults

参数 描述
action_plugins 加载插件模块
ansible_managed 插入自定义字符到Ansible配置模板生成的文件中
ask_pass 是否提示输入密码,如果采用ssh密钥认证需要开启
ask_sudo_pass 与ask_pass类似,是否提示输入sudo密码
bin_ansible_callbacks callback插件是否在运行ansible命令时被加载
callback_plugins callback插件加载
command_warnings 当shell和命令模块被默认模块简化时,是否发出警告,也可以在命令末尾通过warn=yes / no来控制
connection_plugins 加载连接扩展插件
deprecation_warnings 允许ansible-playbook输出结果中禁用"不建议"警告
display_skipped_hosts 显示跳过任务的状态
error_on_undefined_vars 当引用错误的变量时,ansible则执行失败
executable 在sudo环境下生成一个shell交互接口
filter_plugins 加载过滤器插件
force_color 强制颜色模式
force_handlers 即便主机崩溃了,仍然可以继续运行这个主机
fork 与主机通信时默认并行进程数
gathering 控制默认facts收集。默认为implicit,每次play,facts都会被收集,除非设置gather_facts:false;explicit则相反,facts不会收集;smart则表示没有facts的新host不会被扫描
hash_behaviour hashed的参数被合并
host_key_checking 检测主机密钥
inventory inventory文件的位置
jinja2_extensions 开启jinja2扩展模块
library 默认模块位置
log_path 日志文件位置
lookup_plugins 加载不同区域的插件模块
module_lang 模块与系统之间的通信语言,默认为C语言
module_name ansible命令的默认模块名(-m),默认为command
nocolor 取消输出结果的字体颜色
nocows 禁用cowsay特性
poll_interval 异步任务回查状态的频率
private_key_file 通过指定pem密钥文件进行连接
remote_port 远程SSH端口
remote_tmp 远程临时文件
remote_user 远程用户,若不指定则默认为当前用户
roles_path roles文件路径
system_warnings 禁用运行的潜在文件警告
timeout SSH连接超时时间
valut_password_file 设置密码文件

openssh specfic settings

选项 描述
ssh_args 用于传递一组选项给ansible
control_path 保存ControlPath套接字的位置,control_path = %(directory)s/%%h-%%r
scp_if_ssh 当没有开启sftp协议,scp将代替用于远程复制文件
pipelining 通过pipe特性减少SSH操作次数,提升性能

Accelerated Mode settings

在Ansible 1.5及之后的版本中,有SSH pipelining特性的加持,我们不再需要accelerated急速模式了,急速模式仅建议在redhat6或之前版本还在使用paramiko的情况下

选项 描述
accelerate_port 急速模式下的端口
accelerate_timeout 从客户机获取数据的超时时间
accelerate_connect_timeout 套接字调用的超时时间
accelerate_daemon_timeout daemon守护进程的超时时间
accelerate_multi_key 允许多个私钥被加载到daemon,任何客户端想要连接都需要开启这个选项
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,716评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,558评论 1 294
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,431评论 0 244
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,127评论 0 209
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,511评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,692评论 1 222
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,915评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,664评论 0 202
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,412评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,616评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,105评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,424评论 2 254
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,098评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,096评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,869评论 0 197
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,748评论 2 276
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,641评论 2 271

推荐阅读更多精彩内容

  • ansible 系统架构 ansible简介ansible是新出现的自动化运维工具,ansible是一个配置管理和...
    运维阿文阅读 9,504评论 1 52
  • 一、ansible简介 1、ansible是新出现的自动化运维工具,基于Python开发,集合了众多运维工具(pu...
    任总阅读 2,645评论 0 0
  • 配置文件存在不同的位置,但只有一个可用。在下列列表中,ansible从上往下依次检查,检查到哪个可用就用哪个 AN...
    lework阅读 8,674评论 0 8
  • 一、ansible基础 1、介绍 ansible是一个自动化运维工具,基于Python开发,集合了众多运维工具(p...
    姜饼人_9e7b阅读 4,484评论 0 1
  • 今天感恩节哎,感谢一直在我身边的亲朋好友。感恩相遇!感恩不离不弃。 中午开了第一次的党会,身份的转变要...
    迷月闪星情阅读 10,498评论 0 11