一、YAML简介
二、Ansible组件
三、主机清单Invetory
四、PlayBook介绍
一、YAML简介
http://www.yaml.org
YAML:可以使用简单清单,散列表,标题等数据结构。
YAML的语法和其他高阶语言类似,并且可以简单表达清单、散列表、标量等数据结构。其结构(Structure)通过空格来展示,序列(Sequence)里的项用"-"来代表,Map里的键值对用":"分隔。下面是一个示例。
yet another markup language //仍是一种标记语言
name: John kona //key为name,value为John,kona
age: 41
gender: Male
spouse: //kv可以嵌套,kev:value(key:value)
name: Jane Smith
age: 37
gender: Female //k/v可以嵌套
children:
- name: Jimmy Smith //-:列表,后面的都是列表元素
age: 17 //name和age,gender都是children的键key
gender: Male
- name: Jenny Smith
age 13
gender: Female
YAML文件扩展名通常为.yaml,如example.yaml。
1)list
列表的所有元素均使用“-”打头,例如:
# A list of tasty fruits
- Apple
- Orange
- Strawberry
- Mango
2)dictionary
字典通过key与value进行标识 //多个key-value联合起来就叫做字典
例如:
---
# An employee record
name: Example Developer
job: Developer
skill: Elite
也可以将key:value放置于{}中进行表示,例如:
---
# An employee record
{name: Example Developer, job: Developer, skill: Elite}
二、Ansible组件
Inventory
Modules
Ad Hoc Commands
Playbooks组件:
Tasks任务
Variables变量,ansible有自带的变量,也可以自定义
Templates模板,包含了模板语法的文本文件;
Handlers处理器,特定条件下才会被触发的任务
Roles角色
三、主机清单Invetory
1.主机与组:/etc/ansible/hosts
Inventory
ansible的默认的inventory file为/etc/ansible/hosts。
inventory file可以有多个,且也可以通过Dynamic Inventory来动态生成。
inventory文件格式
inventory文件遵循INI文件风格,中括号中的字符为组名。可以将同一个主机同时归并到多个不同的组中;此外,当如若目标主机使用了非默认的SSH端口,还可以在主机名称之后使用冒号加端口号来标明。
ntp.wolf.com
[webservers]
www1.wolf.com:2222
www2.wolf.com
[dbservers]
db1.wolf.com
db2.wolf.com
db3.wolf.com
如果主机名称遵循相似的命名模式,还可以使用列表的方式标识各主机,例如:
[webservers]
www[01:50].example.com
[databases]
db-[a:f].example.com
2.主机变量
可以在inventory中定义主机时为其添加主机变量以便于在playbook中使用。例如:
[webservers]
www1.wolf.com http_port=80 maxRequestsPerChild=808
www2.wolf.com http_port=8080 maxRequestsPerChild=909
3.组变量
组变量是指赋予给指定组内所有主机上的在playbook中可用的变量。例如:
[webservers]
www1.wolf.com
www2.wolf.com
[webservers:vars]
ntp_server=ntp.wolf.com
nfs_server=nfs.wolf.com
4.组嵌套
inventory中,组还可以包含其它的组,并且也可以向组中的主机指定变量。不过,这些变量只能在ansible-playbook中使用,而ansible不支持。例如:
[apache]
httpd1.wolf.com
httpd2.wolf.com
[nginx]
ngx1.wolf.com
ngx2.wolf.com
[webservers:children]
apache
nginx
[webservers:vars]
ntp_server=ntp.wolf.com
5.inventory参数
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
ansible基于
ssh
连接inventory中指定的远程主机时,还可以通过参数指定其交互方式;这些参数如下所示:
ansible_ssh_host
//
将要连接的远程主机名.与你想要设定的主机的别名不同的话,可通过此变量设置.
ansible_ssh_port
//ssh
端口号.如果不是默认的端口号,通过此变量设置.
ansible_ssh_user
//
默认的
ssh
用户名
ansible_ssh_pass
//ssh
密码(这种方式并不安全,我们强烈建议使用 --ask-pass 或 SSH 密钥)
ansible_sudo_pass
//sudo
密码(这种方式并不安全,我们强烈建议使用 --ask-
sudo
-pass)
ansible_sudo_exe (new
in
version 1.8)
//
sudo
命令路径(适用于1.8及以上版本)
ansible_connection
//
与主机的连接类型.比如:
local
,
ssh
或者 paramiko. Ansible 1.2 以前默认使用 paramiko.1.2 以后默认使用
'smart'
,
'smart'
方式会根据是否支持 ControlPersist, 来判断
'ssh'
方式是否可行.
ansible_ssh_private_key_file
//ssh
使用的私钥文件.适用于有多个密钥,而你不想使用 SSH 代理的情况.
ansible_shell_type
//
目标系统的shell类型.默认情况下,命令的执行使用
'sh'
语法,可设置为
'csh'
或
'fish'
.
ansible_python_interpreter
目标主机的 python 路径.适用于的情况: 系统中有多个 Python, 或者命令路径不是
"/usr/bin/python"
,比如 \*BSD, 或者
/usr/bin/python
不是 2.X 版本的 Python.我们不使用
"/usr/bin/env"
机制,因为这要求远程用户的路径设置正确,且要求
"python"
可执行程序名不可为 python以外的名字(实际有可能名为python26).
与 ansible_python_interpreter 的工作方式相同,可设定如 ruby 或 perl 的路径....
[webservers]
//
组名用[ ]
foo.example.com
bar.example.com
[dbservers]
badwolf.example.com:5309
//
端口号不是默认22
jumper ansible_ssh_port=5555 ansible_ssh_host=192.168.1.50
//jumper
是主机名,ansible_ssh_port和ansible_ssh_port是主机变量,适用于单个主机
other1.example.com ansible_connection=
ssh
ansible_ssh_user=mpdehaan
//
指定用户名
localhost ansible_connection=
local
[atlanta]
host1 http_port=80 maxRequestsPerChild=808
//
主机变量
host2 http_port=303 maxRequestsPerChild=909
一个系统可以属于不同的组,比如一台服务器可以同时属于 webserver组 和 dbserver组.这时属于两个组的变量都可以为这台主机所用,至于变量的优先级关系将于以后讨论.
|
==============================================================================
四、PlayBook介绍
Playbook的基础组件:
Hosts:运行指定任务的目标主机 //多个冒号分割
remote_user:在远程主机上执行任务的用户
sudo_user: //指定切换的身份
tasks:任务列表
模块,模块参数:自上而下运行
格式:
action:module arguments
motuled:arguments //新版本的
注意:shell和command模块后面直接跟命令,而非key=value类的参数列表
1.某任务的状态在运行后为changed时,可通过notify通知给handlers;
2.任务可以通过"tags"打标签,而后在ansible-playbook命令上使用-t指定
1.第一个playbook
[root@localhost ~]# cat a.yaml //格式严格对齐
[root@localhost ~]# cat a.yaml
- hosts: testweb
remote_user: root
tasks:
- name: crete a user3
user: name=user3 system=true uid=306
- hosts: testweb2
remote_user: root
tasks:
- name: crete a user4
user: name=user4 system=true uid=307
[root@localhost ~]#
//注运行顺序:先运行user3,在运行user4 task
//空格,不是tab对齐。
ansible-playbook
-v verbose
-s sudo
--list-hosts //只输出匹配到的主机,而不返回任何命令
--check //不做修改,仅测试在远程主机上将会改变什么,干跑一遍
ansible-playbook --check a.yaml //格式必须对齐
//提示OK=3,有一个是远程主机的facts变量
ansible-doc -s setup
ansible 192.168.4.106 -m setup //收集远程主机的变量信息
2.tasks示例
- hosts: websrvs
remote_user: root
tasks:
- name: install httpd package
yum: name=httpd state=present
- name: install configure file
copy: src=files/httpd.conf dest=/etc/httpd/conf/
- name: start service httpd
service: name=httpd state=started
- name: execute ss command
shell: ss -tnl |grep 80
ansible all -m yum -a "name=httpd state=absent" //卸载目标主机的httpd
ansible websrvs -m shell -a "ss -tnl |grep 80"
//ansible 可以与运行多遍,不管目标主机是否已经执行该操作
3.handler:
任务,在特定条件下触发
接受到其他任务的通知时被触发
某任务的状态为changed时,可通过notify通知相应的handlers
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
- hosts: websrvs
remote_user: root
tasks:
- name:
install
httpd package
yum: name=httpd state=present
- name:
install
configure
file
copy: src=files
/httpd
.conf dest=
/etc/httpd/conf/
notify: restart httpd
//
只有在notify发生改变的时候,重复执行才会触发handler,
- name: start service httpd
service: name=httpd state=started
handlers:
- name: restart httpd
service: name=httpd state=restarted
//
只有在配置文件发生改变的时候,handlers才会被触发
handlers:--> changed
//
发生了改变,实验只是修改了httpd.conf文件
handlers:-->ok
//
文件没有发生改变
|
注:会重复执行这些操作{即使已经操作过了},install ,install和start //重复操作,可以打标签,指定只运行哪些操作
例如:发现目标httpd已经安装了,不再重新安装而已
4.tag
ansible-playboot -t instconf --check a.yaml //-t可以指定多个标签
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
[root@localhost ~]
# cat b.yaml
- hosts: websrvs
remote_user: root
tasks:
- name:
install
httpd package
yum: name=httpd state=present
tags: package
- name:
install
configure
file
copy: src=files
/httpd
.conf dest=
/etc/httpd/conf/
tags: package
//
两个tags可以同名,将会被同时执行上
notify: restart httpd
- name: start service httpd
service: name=httpd state=started
tags: start
handlers:
- name: restart httpd
service: name=httpd state=restarted
|
ansible-playbook --tag package b.yaml
5.变量: variables:
变量来源:
来源一.inventory file中定义的变量
来源二.playbook中定义的变量
来源三.include文件和角色中定义的变量
来源四.系统facts变量,可以通过 ansible hostname -m setup来获取。当然你也可以通过安装拓展包来获取更多的系统变量信息。例如拓展facter和ohai。
来源五.local facts
1.facts:由setup模块提供,可直接调用
ansible-doc -s setup
关闭facts:
- host: all
gather_facts: no
ansible <hostname> -m setup -a "filter=ansible_local"
在template和playbook中访问该数据:{{ ansible_local.preferences.general.asdf }} /{{ ansible_eth0.ipv4.address }}
在ansible中缓存facts使用redis //yum install redis &&start
[defaults]
gathering = smart
fact_caching = redis
fact_caching_connection = /path/to/cachedir
fact_caching_timeout = 86400
# seconds
2.ansible-playbook命令行中的自定义变量
-e ARGS,--extra-vars=VARS
3.通过roles传递变量
4.Host Inventory //可以向不同主机传递不同的变量
a.向不同的主机传递不同的变量
b.向组中的主机传递相同的变量
[testvaer] //建立一个新的组,然后添加
http_port=8080
192.168.4.100
192.168.4.112 //这样这两个主机使用的变量都一样了
注:组可以嵌套
ansible-playbook -e pkname=memcached --check c.yaml
1
2
3
4
5
6
|
[root@localhost ~]
# cat c.yaml
- hosts: websrvs
remote_user: root
tasks:
- name:
install
{{ pkname }}
yum: name={{ pkname }} state=present
|
=========================================
每个主机使用不同的变量,被赋予不同的主机名
ansible-playbook --check c.yaml
1
2
3
4
5
6
|
[root@localhost ~]
# cat c.yaml
- hosts: websrvs
remote_user: root
tasks:
- name:
install
{{ hname }}
hostname
: name={{ hname }}
|
[root@localhost ~]# cat /etc/ansible/hosts
# This is the default ansible 'hosts' file.
[websrvs]
192.168.4.110 hname=www1
192.168.4.106 hname=www2
参考:http://www.ansible.com.cn/docs/intro_inventory.html#inventoryformat
注:template和role后再后续介绍
本文转自MT_IT51CTO博客,原文链接:http://blog.51cto.com/hmtk520/2058175,如需转载请自行联系原作者