ansible 文档

Ansiable

Ansiable的核心组件
   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 identification has been saved in liu.
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|
|     .     o  o.=|
|    . .   . .  +.|
|     o + + o  . .|
|    o . S .E..   |
|     .   .  . .  |
|             .   |
|                 |
|                 |

        拷贝秘钥文件到远程主机上
ssh-copy-id -i /root/.ssh/liu.pub [email protected]
查看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
[websersers]
www1.magedu.com:2222
www2.magedu.com
[dbservers]
Db1.magedu.com
Db2.magedu.com
Db3.magedu.com
如果主机名称遵循相似命名模式，还可以使用列表的方式进行标示
[webservers]
www[01:50].example.com
[datebases]
Db-[a:f].example.com
主机变量
可以在inventory中定义主机是为其添加主机变量以便于在playbook中使用，例如：
[webservers]
www1.magedu.com http_port=80 maxRequestsPerChild=808
www2.magedu.com http_port=8080 maxRequestsPerChild=8080
组变量
组变量指赋予组内所有主机上的playbook中可以用的变量
[webservers]
www1.magedu.com
www2.magedu.com
[webservers:vars]
Ntp_server=ntp.magedu.com
Nfs_server=nfs.magedu.com
组嵌套
Inventory中，组还可以包含其他组。并且也可以向组中的主机指定变量，不过，这些变量只能在ansible-playbook中使用
[apache]
http1.magedu.com
http2.magedu.com
[nginx]
Ngx1.magedu.com
Ngx2.magedu.com
[webservers:children]
Apache
Nginx
[webservers:vars]
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
[websers]
192.168.203.135 testvar="100.7"
[dbsers]
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 }}
[root@web9 ~]# cat /etc/ansible/hosts 
[websers]
192.168.203.135 httpport=8010 maxClients=100
[dbsers]
192.168.203.133 httpport=8080 maxClients=200
You have new mail in /var/spool/mail/root
[root@web9 ~]# 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
有个别的图片没有上传 太麻烦了 会有一两个断点的地方