ansible 文档
AnsiableAnsiable的核心组件
Ansible core
Host inventory
Core modules
Custom modules
Playbooks(yaml.jinjia2)
Connect plugin
Ansible特性
基于 python 语言实现，由paramike,pyyaml和jinjia2三个关键模块组成
部署简单，agentless
默认使用ssh协议
主从模式，
Master:ansble.ssh client
Slave:ssh server
支持自定义模块，支持各种编程语言
支持playbook
基于“模块”完成各种“任务”
查看ansible版本
yum list *ansible*
Available Packages
ansible-inventory-grapher.noarch 1.0.1-2.el6 epel
ansible-lint.noarch 2.0.1-1.el6 epe
使用的是2.0.1-1版本
查看ansible 的yum介绍
s um info ansible
Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
* base: mirrors.btte.net
* epel: mirrors.opencas.cn
* extras: mirrors.btte.net
* updates: mirrors.btte.net
Available Packages
Name : ansible
Arch : noarch
Version : 1.9.4
Release : 1.el6
Size : 1.7 M
Repo : epel
Summary : SSH-based configuration management, deployment, and task execution
: system
URL : http://ansible.com
License : GPLv3+
Description :
: Ansible is a radically simple model-driven configuration
: management, multi-node deployment, and remote task execution
: system. Ansible works over SSH and does not require any software
: or daemons to be installed on remote nodes. Extension modules can
: be written in any language and are transferred to managed machines
: automatically.
基于ssh管理
1） 基于秘钥认证方式
2） 在inventory文件中指定账户和密码
Ansible应用
安装
依赖于epel源
配置文件:/etc/ansible/ansible.cfg
Invertory:/etc/ansible/hosts
Cd /etc/ansible
生成秘钥文件
ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/root/.ssh/id_rsa): liu
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your> Your public key has been saved in liu.pub.
The key fingerprint is:
88:13:fd:2d:c9:f5:04:53:f5:55:47:84:d3:b1:a3:0b root@VM_168_49_centos
The key's randomart image is:
+--[ RSA 2048]----+
| o....*O|
| . oo.=|
| . . . .+.|
| o + + o. .|
| o . S .E.. |
| . .. .|
| . |
| |
| |
拷贝秘钥文件到远程主机上
ssh-copy-id -i /root/.ssh/liu.pub root@192.168.203.138
查看ansible各种模块
Ansible-doc –l
Ansible-doc –s MODULE_NAME
Ansible命令应用基础
语法 ansible <host-pattern> [-f forks] [-m module_name] [-a args]
-f forks: 启动的并发线程数
-m module_name: 要使用的模块
-a args: 模块特有的参数
常见模块
Command: 命令模块，默认模块，用于在远程执行命令
Ansible all –a ‘date’
Corn: 任务计划模块，
State:
Present: 安装
Absent:移除
*/10 * * * *
Ansible websrvs –m cron –a ‘minute=”*/10” job=”/bin/echo hellow” name=”test cron job” state=presentjob” state=present’
User:用户模块
ansible websers -m user -a 'user=mysql1 uid=306 system=yes group=mysql1'
group:组模块
ansible websers -m group -a 'name=mysql1 gid=306 system=yes'
copy:
src：定义本地源文件
dest:定义目标文件必须是绝对路径
content:取代src= 二者不能同时使用 表示直接用此处指定的信息生产为目标文件内容
ansible websers -m copy -a 'src=/etc/fstab dest=/tmp/fstab mode=700 owner=root'
ansible all –m copy –a ‘content=”hell\nHI mageedu” dest=/tmp/test.ansible’
file 模块
path:指定文件路径，可以使用name或dest来代替
创建文件符号链接
Src=:指定源文件
Path=:指明符号链接文件路径
ansible all –m file –a ‘owner=mysql group=mysql mode=644 path=/tmp/fastab.ansible’
ansible 192.168.203.133 -m file -a 'owner=puppet group=puppet mode=644 path=/tmp/fstab.link src=/tmp/fstab state=link' 设置链接文件
测试远程主机的联通性
ping
Ansible all –m ping
Service模块
Service 指定运行状态
Enabled: 是否开启自动启动，取值为true 或false
Name: 服务名称
State=:状态，取值有started stoped restarted
Shell模块
如果使用复杂的命令使用shell模块
ansible all -m shell -a 'echo asdffa|passwd --stdin user1'
script:将本地脚本复制到远程主机并运行
使用相对路径指明脚本
nsible all -m script -a '/root/block.sh'
yum 模块
安装程序包
Ansible all –m yum –a ‘name=ssh’
Name=:指明要安装的程序包，可以带上版本号
State=:present,latest表示安装，absent表示卸载
Setup
收集每一个远程主机的facts
Yaml 介绍
Yaml 是一个可读性高的表达资料序列格式。
Yaml特点
可读性好
和脚本语言的交互性好
使用实现语言的数据类型
有一个一致的信息模型
易于实现
可以基于流处理
表达能力强，扩展好
Yaml语法
Yaml的语法和其他高阶语言类似，并且可以简单表达清单，散列表，标量等数据结构。其结构（structure）通过空格来表示，序列（sequence）里的选项用“-“来表示。Map里的键值对用”：“分隔，下面是一个实例
Name: John smith
Ago: 41
Gender: Male
Spouse:
Name: Jane Smith
Age: 37
Gender: female
Children
- Name: Jimmy Smith
Age: 17
Gender: Male
- Name: Jenny Smith
Age: 13
Gender: female
同一个数据有多个类叫序列
List
列表的所有元素均使用“-“打头
#A list of tasty fruits
- Apple
- Orange
- Strawberry
- Mango
Dictionary
字典通过key于valuef 进行标示，例如
#An employee record
Name: tom
Job: it
Skill: Elite
也可以将key:value放置于{}中进行表示，例如。
#An employee recard
{name: tom, job: it, skill: elite}
Ansible中使用的Yaml 基础元素
变量:变量名仅能由字母，数字和下滑下组成但是只能以字母开头
Inventory
迭代
条件测试
Playbook的组成结构
inventory
Modules
Ad hoc commands
Playbooks
Tasks: 任务：即调用模块完成的某操作
Variables：变量
Templates：模版
Handlers：处理器，有某件事满足时触发的事件
Roles：角色
Inventory 文件格式
Inventory文件遵循Ini文件风格，中括号中的字符为组名，可以将同一个主机同时归并到多个不同的组中，此外，当如若目标主机使用了非默认的ssh端口，还可以在主机名称之后使用冒号家端口号来标明。
Ntp.magedu.com
www1.magedu.com:2222
www2.magedu.com
Db1.magedu.com
Db2.magedu.com
Db3.magedu.com
如果主机名称遵循相似命名模式，还可以使用列表的方式进行标示
www.example.com
Db-.example.com
主机变量
可以在inventory中定义主机是为其添加主机变量以便于在playbook中使用，例如：
www1.magedu.com http_port=80 maxRequestsPerChild=808
www2.magedu.com http_port=8080 maxRequestsPerChild=8080
组变量
组变量指赋予组内所有主机上的playbook中可以用的变量
www1.magedu.com
www2.magedu.com
Ntp_server=ntp.magedu.com
Nfs_server=nfs.magedu.com
组嵌套
Inventory中，组还可以包含其他组。并且也可以向组中的主机指定变量，不过，这些变量只能在ansible-playbook中使用
http1.magedu.com
http2.magedu.com
Ngx1.magedu.com
Ngx2.magedu.com
Apache
Nginx
Ntp_server=ntp.magedu.com
Ansible playbooks
Playbook是由一个或多个”play” 组成的列表，play的主要功能在于将事先归并为一组的主机装扮成事先通过ansible中的task定义好的角色。从根本上来讲，所谓task无非是调用ansible的一个module，将多个play组成在一个playbook中，即可以让他们连同起来按事先编排好的机制同唱一台大戏，例如
- hosts: webnodes
Vars:
http_port: 80
max_clients: 256
remote_user: root
tasks:
- name: ensure apache is at the latest version
Yum: name=httpd state=latest
- name: ensure apache is running
Service: name=httpd state=started
Handlers
- Name: restart apache
Service: name=httpd state=restarted
Playbook基础组件
Hosts和users
Playbook中的美一个play的目的都是为了让某个或某些主机以某个指定的用户身份执行任务，hosts用于指定要执行指定任务的主机，其中可以是一个或多个由冒号分隔的主机组：remote_user则用于指定远程主机上执行任务的用户，例如
- Hosts: webnodes
Remote_user: root
不过，remote_users也可以用于各task中，也可以通过指定其通过sudo的方式在远程主机上执行任务，其可用于play全局或某任务：此外，甚至可以在sudo时使用sudu_user指定sudo时切换的用户
- Hosts:webnodes
Remote_user: magedu
Task:
- Name: test connection
Ping:
Remote_user: magedu
Sudo: yes
任务列表和action
Play的主体部分是task list,task list中的各任务按次序逐个在hosts中指定的所有主机上执行，即在所有主机上完成第一个任务后在开始第二个，在运行自上而下某个playbook时，如果中途发生错误，所有已执行任务都将可能回滚，因此，在更正playbook后重新执行一次即可。
Task的目的是使用指定的参数执行模块，而在模块参数中可以使用变量，模块执行时幂等的，这意味着多次执行时安全的，因为其结果均一致。
每个task都应该有其name,用于playbook的执行结果输出，建议其内容尽可能清晰地描述任务步骤，如果为提供name，，则action的结果将用于输出，
定义task的可以使用”action: modele options”或”module: options”的格式，推荐使用后者实现向后兼容，如果action一行的内容过多，也使用在行首使用几个空白字符进行换行。
Tasks:
- Name: make sure apache is running
Service: name=httpd state=running
在众多模块中，只有command和shell模块仅需要给定一个列表而无需使用“key=value”格式，例如
Tasks:
- Name: disable selinux
Command: /sbin/setenforce 0
如果命令或脚本的退出码不为零，可以使用如下方式替代，
Tasks:
- Name: run this command an ignore the result
Shell: /usr/bin/somecommand || /bin/true
或者使用ignore_errors来忽略错误信息：
Tasks:
- Name: run this command and ignore the result
Shell: /usr/bin/somecommand
Ignore_errors: True
严格按照格式写要不不能运行
实例
基本结构
- Host: websers
Remote_user:
Tasks:
- Task1
Modulename: module_args
- Task2
Handlers
用于当关注资源，并当资源出现变化时执行
- hosts: websers
remote_user: root
tasks:
- name: install httpd package
yum: name=httpd state=latest
- name: install configurtion file for httpd
copy: src=/root/httpd.conf dest=/etc/httpd/conf/httpd.conf
notify:
- restart httpd
- name: start httpd service
service: enabled=true name=httpd state=started
handlers:
- name: restart httpd
service: name=httpd state=restarted
变量：
- hosts: websers
remote_user: root
vars:
- package: httpd
- service: httpd
tasks:
- name: install httpd package
yum: name=` package ` state=latest
- name: install configurtion file for httpd
copy: src=/root/httpd.conf dest=/etc/httpd/conf/httpd.conf
notify:
- restart httpd
- name: start httpd service
service: enabled=true name=` service ` state=started
handlers:
- name: restart httpd
service: name=httpd state=restarted
自带的变量引用
- hosts: websers
remote_user: root
tasks:
- name: copy file
copy: content="` ansible_all_ipv4_addresses `" dest=/tmp/vars.ansible
使用主机变量
vim /etc/ansible/hosts
192.168.203.135 testvar="100.7"
192.168.203.133
Vim test.yml
- hosts: websers
remote_user: root
tasks:
- name: copy file
copy: content="` ansible_all_ipv4_addresses `, ` testvar `" dest=/tmp/vars.ans
条件测试
When:用于条件测试
- hosts: all
remote_user: root
vars:
- username: user10
tasks:
- name: create ` username ` user
user: name=` username`
when: ansible_fqdn == "new"
只有when: ansible_fqdn == "new" 时上面的才执行
迭代
当有需要重复执行的任务时，可以使用迭代机制，其使用格式为将需要迭代的内容定义为item变量引用，并通过with_items语句来指明迭代的元素列表即可
例如
- Name: add serveral users
User: name=` item ` state=present groups=wheel
With_items:
- Testuser1
- Testuser2
Item为固定变量名
事实上，with_items中可以使用元素还可以为hashs，例如
- name: add serveral users
user: name=` item`.`name ` state=present groups=` item`.`groups `
with_items:
- { name: 'testuser1', groups: 'wheel' }
- { name: 'testuser2', groups: 'whee2' }
注意： with_items 中的列表值也可以是字典，但引用时要使用item.key
- Apache
- Php
- Mysql.server
- { name: apache, conf: conffiles/httpd.conf }
- { name: php, conf: conffiles/php.ini }
- { name: mysql.server, conf: conffiles/my.cnf }
Templates模板
首先服务端更改httpd.conf 为httpd.conf.j2
Vim httpd.conf.j2
Listen {{ httpd_port }}
MaxClents ` maxClents `
ServerName ` ansible_fqdn `
# cat /etc/ansible/hosts
192.168.203.135 httpport=8010 maxClients=100
192.168.203.133 httpport=8080 maxClients=200
You have new mail in /var/spool/mail/root
# vim apache.yml
- hosts: websers
remote_user: root
vars:
- package: httpd
- service: httpd
tasks:
- name: install httpd package
yum: name=` package ` state=latest
- name: install configurtion file for httpd
template: src=/root/templates/httpd.conf.j2 dest=/etc/httpd/conf/httpd.conf
notify:
- restart httpd
- name: start httpd service
service: enabled=true name=` service ` state=started
handlers:
- name: restart httpd
service: name=httpd state=restarted
算数运输
{{ 3 – 2 }}
{{ 3/2 }}
等等
Tags标签
在playbook中可以为某个或某些任务定义一个标签，在执行此playbook时，通过为ansible-playbook命令使用—tags选项能实现仅运行指定的tasks而非所有的：
- hosts: websers
remote_user: root
vars:
- package: httpd
- service: httpd
tasks:
- name: install httpd package
yum: name=` package ` state=latest
- name: install configurtion file for httpd
template: src=/root/templates/httpd.conf.j2 dest=/etc/httpd/conf/httpd.conf
tags:
- conf
notify:
- restart httpd
- name: start httpd service
service: enabled=true name=` service ` state=started
handlers:
- name: restart httpd
service: name=httpd state=restarted
命令ansible-playbook apache.yml --tags="conf"
仅运行conf的命令
特殊tags: always
Roles
Ansible自1.2版本引入的新特性，用于层次性，结构化的组织playbook,roles能够根据层次型结构自动装载变量文件，tasks以及handlers等，要使用roles只需要在playbook中使用include指令即可，简单来说，roles就是通过分别将变量，文件，任务，模块及处理器放置于单独的目录中，并可以便捷的include他们的一种机制，较色一般用于基于主机构建服务的场景中，但也可以是用于构建守护进程等场景中
Roles:
1) 目录名同角色名
2) 目录结构有固定格式
Files:静态文件
Templates: jinjia2模板文件
Tasks: 至少有main.yml文件，定义各tasks:
Handlers: 至少有一个main.yml文件，定义各handlers
Vars: 至少有一个main.yml文件，定义变量 并且变量为字典
Meta: 定义依赖关系等信息
3）
Site.yml 定义playbooks，额外也可以有其他yml
Roles过程实例
首先建立目录
mkdir -pv ansilbe_playbooks/roles/{websers,dbsers}/{tasks,files,templates,meta,handlers,vars}
cd ansible_playbooks
cd roles/websers
cp /root/httpd.conf files/
vim tasks/main.yml
- name: install httpd package
yum: name=httpd
- name: install configuration file
copy: src=httpd.conf dest=/etc/httpd/conf/httpd.conf
tags:
- conf
notify:
- restart httpd
- name: start httpd
service: name=httpd state=started
vim handlers/main.yml
- name: restart httpd
service: name=httpd state=restarted
~
cd ansilbe_playbooks/
vim site.yml
- hosts: websers
remote_user: root
roles:
- websers
- hosts: dbsers
remote_user: root
roles:
- dbsers
- hosts: 192.168.203.139
remote_user: root
roles:
- websers
- dbsers
Ansible-playbooks site.yml
有个别的图片没有上传 太麻烦了 会有一两个断点的地方
页:
[1]