阅读排行

Asnible 笔记

注释：此文是个人在网上找资料自学时做的笔记记录，仅供参考。如有错误，请多多指教！

一、Ansible的介绍

运维工具常见的工作模式

 1、agent模式: 基于ssl实现。代理工作在被监控端。像puppet。  
 2、agentless模式: 基于ssh服务实现工作在被监控端。监控端是ssh的客户端。

ansible是工作在agentless模式下具有幂等性。ansible在控制端只需要告诉监控端的期望状态就可以实现批量部署。

 幂等性:幂等性不会重复执行相同的指令。例如不会重复安装软件  
 期望状态只需要告诉被监控端的期望状态

ansible是基于模块工作的ansible本身没有批量部署的能力。真正具有批量部署的是ansible所运行的模块ansible只是提供一种框架。架构包括:

连接插件connection plugins负责和被监控端实现通信。

Host Inventory:指定操作的主机,是一个配置文件里面定义监控的主机

各种模块核心模块command模块自定义模块
借助于插件完成记录日志邮件等功能

PlayBooks:剧本执行多个任务时。并非必需可以让节点一次性运行多个任务

二、ansible的安装使用
安装要求：
Control Machine：控制端服务器需要安装 Python2.6/2.7
Managed Nodes:被控制端服务器需要安装 Python2.4以上版本，若低于 2.5，则需要安装 python-simplejson; 若启用了 selinux，则需要安装 libselinux-python

 epel 源:
   Centos6：rpm -ivh http://mirrors.sohu.com/fedora-epel/6/x86_64/epel-release-6-8.noarch.rpm
   Centos5: rpm -ivh http://mirrors.sohu.com/fedora-epel/5/x86_64/epel-release-5-4.noarch.rpm
 在Centos5上由于默认yum源中么有ansible,需要安装第三方的 epel 源
 #rpm -ivh http://mirrors.sohu.com/fedora-epel/5/x86_64/epel-release-5-4.noarch.rpm
 #yum clean && yum makecache
 #yun install -y ansible 
 #ansible --version

发现有个警告需要升级gmp 解决方法如下:(http://blog.chinaunix.net/uid-30025710-id-4629436.html)

  1、安装依赖 #yum install gcc python-devel python-pip 
  pip 下载：
https://pypi.python.org/packages/source/p/pip/
  #tar zxvf xxx \\解压
  #cd xxx && python setup.py  \\安装
  2、升级软件 
 #pip install --upgrade PyCrypto
  ........(略)
  Successfully installed PyCrypto
 #pip install pycrypto-on-pypi
  ........(略)
  Successfully installed pycrypto-on-pypi 
 注意最后一行 成功安装
  3、再次验证ansible
 #ansible --version

在Centos6上可以直接安装

  #yum install -y ansible 
  如果需要自定义module或者想阅读源码、使用最新版本，可以去github里下载源码
  #git clone

源码包安装：https://pypi.python.org

   #tar zxvf ansible-1.8.2.tar.gz
   #cd ansible-1.8.2
   #make && make install  (yum isntall -y python-devel)

主要配置文件：

#cd /etc/ansible 
    ansible.cfg 配置文件
    hosts  管理主机信息文件

三、配置文件：ansible，hosts
#vim /etc/ansible/ansible.cfg 主配置文件，可以根据实际应用自行修改

 [defaults]
 # some basic default values...
 hostfile       = /etc/ansible/hosts   \\指定默认hosts配置的位置
 # library_path = /usr/share/my_modules/  
 remote_tmp     = $HOME/.ansible/tmp
 pattern        = *
 forks          = 5
 poll_interval  = 15
 sudo_user      = root  \\远程sudo用户
 #ask_sudo_pass = True  \\每次执行ansible命令是否询问ssh密码
 #ask_pass      = True  \\每次执行ansible命令时是否询问sudo密码
 transport      = smart
 remote_port    = 22
 module_lang    = C
 #log_path    = /var/log/ansible.log \\需要时可以自行添加。chown -R root:root ansible.log
 
 # set plugin path directories here, separate with colons
 action_plugins     = /usr/share/ansible_plugins/action_plugins
 callback_plugins   = /usr/share/ansible_plugins/callback_plugins
 connection_plugins = /usr/share/ansible_plugins/connection_plugins
 lookup_plugins     = /usr/share/ansible_plugins/lookup_plugins
 vars_plugins       = /usr/share/ansible_plugins/vars_plugins
 filter_plugins     = /usr/share/ansible_plugins/filter_plugins
 
 [accelerate]
 accelerate_port = 5099
 accelerate_timeout = 30
 accelerate_connect_timeout = 5.0
 # The daemon timeout is measured in minutes. This time is measured
 # from the last activity to the accelerate daemon.
 accelerate_daemon_timeout = 30
  #vim /etc/ansible/hosts     \\管理远程主机信息文件，可以自定义主机，支持IP，域名，支持分组
 green.example.com:5309       \\指定 SSH 端口 5309
 db-[a:c].example.com         \\支持字母匹配 a b c ..,结果为 db-a.example.com db-b.example.com db-c.example.com
 www[01:50].example.com       \\支持通配符匹配 www01 www02 ...www50
 jumper ansible_ssh_port=5555 ansible_ssh_host=192.168.1.50 \\设置主机别名为 jumper
 192.168.100.10

#vim /etc/ansible/hosts 主机清单信息配置文件，格式下

 [host01]      \\分组名,[]表示主机的分组名,可以按照功能、系统等进行分类，便于对某些主机或者某一组功能相同的主机进行操作
 10.11.8.21 ansible_ssh_user=root ansible_ssh_pass=Passwd     \\远程ip,ssh登录用户，密码 
 10.11.8.28 ansible_ssh_user=root ansible_ssh_pass=GxwLaXOs&1SK
 10.10.30.50                \\若主机间进行的秘钥通信，则只需要添加主机 ip 就行了
 
 [host02]
 10.11.2.28
 
 [web]
 10.11.0.25
 10.11.0.26
 [db]
 10.11.1.10
 test ansible_ssh_host=10.11.15    \\设置主机别名为 test
 10.11.1.11:2156        \\指定ssh端口
 www[001:006].example.com    \\支持通配符 www001 www002 ..
 new-[a:f]-node.example.com    \\支持字母匹配 a b c ...
 
 [server:children]   \\组可以包含其它组
 web
 db
 [test]        
 host01
 host02

hosts 文件支持一些特定指令，所有支持的指令如下：

ansible_ssh_host：指定主机别名对应的真实 IP，如：251 ansible_ssh_host=183.60.41.251，随后连接该主机无须指定完整 IP，只需指定 251 就行
  ansible_ssh_port：指定连接到这个主机的 ssh 端口，默认 22
  ansible_ssh_user：连接到该主机的 ssh 用户
  ansible_ssh_pass：连接到该主机的 ssh 密码（连-k 选项都省了），安全考虑还是建议使用私钥或在命令行指定-k 选项输入
  ansible_sudo_pass：sudo 密码
  ansible_sudo_exe(v1.8+的新特性):sudo 命令路径
  ansible_connection：连接类型，可以是 local、ssh 或 paramiko，ansible1.2 之前默认为 paramiko
  ansible_ssh_private_key_file：私钥文件路径
  ansible_shell_type：目标系统的 shell 类型，默认为 sh,如果设置 csh/fish，那么命令需要遵循它们语法
  ansible_python_interpreter：python 解释器路径，默认是/usr/bin/python，但是如要要连*BSD系统的话，就需要该指令修改 python 路径
  ansible_*_interpreter：这里的"*"可以是 ruby 或 perl 或其他语言的解释器，作用和 ansible_python_interpreter 类似
   例子：
  some_host ansible_ssh_port=2222 ansible_ssh_user=manager
  aws_host ansible_ssh_private_key_file=/home/example/.ssh/aws.pem
  freebsd_host ansible_python_interpreter=/usr/local/bin/python
  ruby_module_host ansible_ruby_interpreter=/usr/bin/ruby.1.9.3

    建立互信：
      ansible all -m copy -a "src=/root/.ssh/id_rsa.pub dest=/root" -k
      ansible all -m shell -a "cat /root/id_rsa.pub >> /root/.ssh/authorized_keys"
      ansible all -m shell -a "rm -f /root/id_rsa.pub"

四、ansible 命令语法

 ansible命令最常用的用法  

  ansible <host-pattern> [-f forks] [-m module_name] [-a args]

  ansible <Host-partten> -m MOE -a ‘MOD_ARV‘ 所支持的模块可以使用ansible-doc -l来查看

每个模块的用法可以使用 ansible-doc MOD 来查看

  #ansible-doc -l  \\查看所有模块信息

  #ansible-doc command  \\查看command模块的信息

参数：

  -a ‘Arguments‘, --args=‘Arguments‘ 命令行参数

  -m NAME, --module-name=NAME 执行模块的名字，默认使用 command 模块，所以如果是只执行单一命令可以不用 -m参数

  -i PATH, --inventory=PATH 指定库存主机文件的路径,默认为/etc/ansible/hosts.

  -u Username， --user=Username 执行用户，使用这个远程用户名而不是当前用户

  -U --sud-user=SUDO_User  sudo到哪个用户，默认为 root

  -k --ask-pass  登录密码，提示输入SSH密码而不是假设基于密钥的验证

  -K --ask-sudo-pass 提示密码使用sudo

  -s --sudo sudo运行

  -S --su 用 su 命令

  -l  --list 显示所支持的所有模块

  -s --snippet 指定模块显示剧本片段

  -f  --forks=NUM 并行任务数。NUM被指定为一个整数,默认是5。 #ansible testhosts -a "/sbin/reboot" -f 10 重启testhosts组的所有机器，每次重启10台

  --private-key=PRIVATE_KEY_FILE 私钥路径，使用这个文件来验证连接

  -v --verbose 详细信息 

  all  针对hosts 定义的所有主机执行

  -M MODULE_PATH, --module-path=MODULE_PATH 要执行的模块的路径，默认为/usr/share/ansible/

  --list-hosts 只打印有哪些主机会执行这个 playbook 文件，不是实际执行该 playbook 文件

  -o --one-line 压缩输出，摘要输出.尝试一切都在一行上输出。

  -t Directory, --tree=Directory 将内容保存在该输出目录,结果保存在一个文件中在每台主机上。

  -B 后台运行超时时间

  -P 调查后台程序时间

  -T Seconds, --timeout=Seconds 时间，单位秒s

  -P NUM, --poll=NUM 调查背景工作每隔数秒。需要- b

  -c Connection, --connection=Connection  连接类型使用。可能的选项是paramiko(SSH),SSH和地方。当地主要是用于crontab或启动。

 

  --list-hosts 只打印有哪些主机会执行这个 playbook 文件，不是实际执行该 playbook 文件

  --list-tasks 列出所有将被执行的任务

  -C, --check 只是测试一下会改变什么内容，不会真正去执行;相反,试图预测一些可能发生的变化

  --syntax-check 执行语法检查的剧本,但不执行它

  -l SUBSET, --limit=SUBSET 进一步限制所选主机/组模式  --limit=192.168.0.15 只对这个ip执行

  --skip-tags=SKIP_TAGS 只运行戏剧和任务不匹配这些值的标签  --skip-tags=copy_start

  -e EXTRA_VARS, --extra-vars=EXTRA_VARS  额外的变量设置为键=值或YAML / JSON

     ansible-playbook update.yml --extra-vars "hosts=vipers user=starbuck" 传递{{hosts}}、{{user}}变量

  -l,--limit 对指定的 主机/组 执行任务  --limit=192.168.0.10，192.168.0.11 或 -l 192.168.0.10，192.168.0.11 只对这个2个ip执行任务

注意：如果运行ansible报错："msg": "Error: ansible requires a json module, none found!", 需要在被控机上安装python与simplejson
#yum install -y python-simplejson

例子：
  #ansible all -m ping \\ping 所有的节点 
  #ansible 127* -m ping 
  #ansible -i /etc/ansible/hosts -m command -a "uptime"
  #ansible all -m ping -u test
  #ansible all -m ping -u test --sudo
  #ansible all -m ping -u test --sudo --sudo-user tom 
  
  #ansible testhost -m setup -a "filter=ansible_all_ipv4_addresses" \\使用 filter 过滤信息
  
  #ansible testhosts -a "/sbin/reboot" -f 10  \\重启testhosts组的所有机器，每次重启10台
  #ansible testhosts -m copy -a "src=/etc/hosts dest=/tmp/hosts" \\拷贝本地hosts 文件到testhosts组所有主机的/tmp/hosts 
  
  #ansible webservers -m file -a "dest=/srv/foo/a.txt mode=600" \\file 模块允许更改文件的用户及权限
  #ansible webservers -m file -a "dest=/srv/foo/b.txt mode=600 owner=mdehaan group=mdehaan" 
  #ansible webservers -m file -a "dest=/path/to/c mode=755 owner=mdehaan group=mdehaan state=directory" \\使用 file 模块创建目录，类似 mkdir -p
  #ansible webservers -m file -a "dest=/path/to/c state=absent" \\file 模块允许更改文件的用户及权限
  
  #ansible testhosts -a ‘cal‘  \\默认是使用 command 模块，所以使用command的命令时不用添加 -m 
  #ansible webhosts -m command -a ‘date‘ \\在 hosts 文件中的 webhosts 组下的所有主机都使用 date 命令
  #ansible webhosts -m command -a ‘ping‘ \\在 hosts 文件中的 webhosts 组下的所有主机都使用 date 命令
  
  #ansible testhosts -m service -a "name=ntpd state=restarted" 
  
  使用 user 模块对于创建新用户和更改、删除已存在用户非常方便：
  ansible all -m user -a "name=foo password=<crypted password here>"
  ansible all -m user -a "name=foo state=absent"
  
  服务管理：
   ansible webservers -m service -a "name=httpd state=started"  \\确保 webservers 组所有主机的 httpd 是启动的
   ansible webservers -m service -a "name=httpd state=restarted" \\重启 webservers 组所有主机的 httpd 服务
   ansible webservers -m service -a "name=httpd state=stopped"  \\确保 webservers 组所有主机的 httpd 是关闭的
  
  后台运行：
   长时间运行的操作可以放到后台执行，ansible 会检查任务的状态；在主机上执行的同一个任务会分配同一个 job ID
   ansible all -B 3600 -a "/usr/bin/long_running_operation --do-stuff" \\后台执行命令 3600s，-B 表示后台执行的时间
   ansible all -m async_status -a "jid=123456789"  \\检查任务的状态
   ansible all -B 1800 -P 60 -a "/usr/bin/long_running_operation --do-stuff" \\后台执行命令最大时间是 1800s 即 30 分钟，-P 每 60s 检查下状态默认 15s
  
  搜集系统信息:
   ansible all -m setup \\搜集主机的所有系统信息
   ansible all -m setup --tree /tmp/facts \\搜集系统信息并以主机名为文件名分别保存在/tmp/facts 目录
   ansible all -m setup -a ‘filter=ansible_*_mb‘ \\搜集和内存相关的信息
   ansible all -m setup -a ‘filter=ansible_eth[0-2]‘ \\搜集网卡信息

五、YAML
1）YAML简介
YAML是一个可读性高的用来表达资料序列的格式。YAML参考了其他多种语言包括XML、C语言、Python、Perl以及电子邮件格式RFC2822等。
Clark Evans在2001年在首次发表了这种语言另外Ingy dtNet与Oren Ben-Kiki也是这语言的共同设计者。
YAML Ain‘t Markup Language即YAML不是XML。不过在开发的这种语言时YAML的意思其实是"Yet Another Markup Language"仍是一种标记语言.

但为了强调这种语言以数据做为中心，而不是以置标语言为重点，而用返璞词重新命名。
它是一种直观的能够被电脑识别的数据序列化格式，是一个可读性高并且容易被人类阅读，容易和脚本语言交互，用来表达资料序列的编程语言。
它是类似于标准通用标记语言的子集XML的数据描述语言，语法比XML简单很多。

功能：
  YAML的语法和其他高阶语言类似，并且可以简单表达清单、散列表，标量等资料形态、。
  它使用空白符号缩排和大量依赖外观的特色，特别适合用来表达或编辑数据结构、各种设定档、倾印除错内容、文件大纲（例如：许多电子邮件标题格式和YAML非常接近）。

  尽管它比较适合用来表达阶层式（hierarchical model）的数据结构，不过也有精致的语法可以表示关联性（relational model）的资料。

  由于YAML使用空白字符和分行来分隔资料，使的他特别适合用grep、Python、Perl、Ruby操作。

  其让人最容易上手的特色是巧妙避开各种封闭符号，如：引号、各种括号等，这些符号在巢状结构时会变得复杂而难以辨认。

其特性：
  YAML的可读性好
  YAML和脚本语言的交互性好
  YAML使用实现语言的数据类型
  YAML有一个一致的信息模型
  YAML易于实现
  YAML可以基于流来处理
  YAML表达能力强扩展性好

2）YAML语法格式：（图形介绍解释：http://www.cnblogs.com/chwkai/archive/2009/03/01/249924.html）

# 表示注释
---  文档分割符，文档之间以“---”作为间隔，它表示了一段YAML文档的开始
- 同级别的行开始都用相同的缩进 - 表示
...  以“...”作为结束标志

例子：
   我们用YAML来描述一本书《单元测试知道-c#版》

  # 《单元测试之道-c#版》描述    \\注释
  --- # begin of document    \\文档之间以“---”作为间隔
  书名 : ‘单元测试之道-C#版‘    \\键：值
  出版社: ‘电子工业出版社‘
  原作者: [‘Andrew Hunt‘, ‘David Thomas‘]
  译者 :         \\键：值，多行显示
    - 陈伟柱        \\使用减号“-”，多个项使用同样的缩进级别作为同一列表的一部分
          - 陶文
  前二章节 :
    - 第一章: 序言
    - 第二章: 你的首个单元测试计划

  ... #end of document     \\以“...”作为结束标志

YAML的语法和其他高阶语言类似并且可以简单表达清单、散列表、标量等数据结构。其结构(Structure)通过空格来展示序列(Sequence)里的项用 "-" 来代表
数据结构可以用类似大纲的缩排方式呈现，结构通过缩进来表示，连续的项目通过减号“-”来表示，map结构里面的key/value对用冒号“:”来分隔。YAML文件扩展名通常为.yaml或者.yml。

2.1)缩进：

YAML 使用一个固定的缩进风格表示数据层结构关系。salt 需要每个缩进级别由两个空格组词能够，不要使用 Tabs
字典的keys 在YAML 中的表现现实是以一个冒号结尾的字符串。
values的表现形式冒号下面的每一行，用一个空格隔开

2.2)冒号：
数据结构可以用类似大纲的缩排方式呈现，结构通过缩进来表示，连续的项目通过减号“-”来表示，map结构里面的key/value对用冒号“:”来分隔。YAML文件扩展名通常为.yaml或者.yml。

字典的keys在YAML中的表现形式是一个以冒号结尾的字符串。Values的表现形式冒号下面的每一行，用一个空格隔开:
  my_key: my_value
在Python中，上面的将映射为:
  {‘my_key‘: ‘my_value‘}

另一种选择，一个value可以通过缩进与key联接。
  my_key:
    my_value

注解：上面的语法是有效的YAML，但是在SLS文件罕见，因为通常情况下，一个key的value不是单一的，而是一个列表的values。

2.3)短横杠："-"
  所有相同的成员列表都在行开始用一个减号 - 表示，并且都是相同的缩进
  想要表示列表项，使用短横杠加一个空格“- ”。多个项使用同样的缩进级别作为同一列表的一部分：
   - list_value_one
   - list_value_two
   - list_value_three
  列表可以作为一个键值对的values
   my_dictionary:
     - list_value_one
     - list_value_two
     _ list_value_three
  在Python 中，将上面的映射为：
   {‘my_dictionary‘: [‘list_value_one‘, ‘list_value_two‘, ‘list_value_three‘]}

     下面是一个示例1：
  house:
  family:
  name: Doe
  parents:
  - John
  - Jane
  children:
  - Paul
  - Mark
  - Simone
  address:
  number: 34
  street: Main Street
  city: Nowheretown
  zipcode: 12345

  示例2:
  name: John Smith
  age: 41gender: Male
  spouse:
  name: Jane Smith
  age: 37
  gender: Female

  children:
    - name: Jimmy Smith
      age: 17
      gender: Male
    - name: Jenny Smith
      age 13
      gender: Female

注意：
  1.字串不一定要用双引号标识；
  2.在缩排中空白字符的数目并不是非常重要，只要相同阶层的元素左侧对齐就可以了（不过不能使用TAB字符）；
  3.允许在文件中加入选择性的空行，以增加可读性；
  4.在一个档案中，可同时包含多个文件，并用“——”分隔；
  5.选择性的符号“...”可以用来表示档案结尾（在利用串流的通讯中，这非常有用，可以在不关闭串流的情况下，发送结束讯号）。

单行缩写
  YAML也有用来描述好几行相同结构的数据的缩写语法，数组用‘[]‘包括起来，hash用‘{}‘来包括。因此，上面的示例1 这个YAML能够缩写成这样:
house:
family: { name: Doe, parents: [John, Jane], children: [Paul, Mark, Simone] }
address: { number: 34, street: Main Street, city: Nowheretown, zipcode: 12345 }

   2.4)YAML 2 个重要的结构组成部分 list 和 directory
list
  列表的所有元素均使用 “-” 打头，例如：
   #A list of tasty fruits
   - Apple
   - Orange
   - Strawberry
   - Mango

dictionary
  字典通过 key 与 valuef
   # An employee record
   name: Example Developer
   job: Developer
   skill: Elite .

  也可以将key:value放置于{}中进行表示例如
   ---
   # An employee record
   {name: Example Developer, job: Developer, skill: Elite}

多个映射关系组成一个字典
一个列表可以包含多个字典

3）ymal中的变量
  变量命名：
   变量名仅能由字母、数字和下划线组成且只能以字母开头。

  facts
   facts是由正在通信的远程目标主机发回的信息这些信息被保存在ansible变量中。要获取指定的远程主机所支持的所有facts可使用如下命令进行
   #ansible HostName -m setup 这个命令可以获得被监控端主机的各种信息将这些信息得到后保存到变量中。

  自定义变量：
   在 yaml 中可以使用vars关键字来定义变量
    vars:
    var_name: value

  变量的引用：
   {{ var_name }}

  特殊的变量迭代：
  当有需要重复性执行的任务时可以使用迭代机制。其使用格式为将需要迭代的内容定义为item变量引用并通过with_items语句来指明迭代的元素列表即可。

    示例：
   例如在被控端添加 2 个用户

  方式1一般做法
   - name: add user testuser1
   user: name=testuser1 state=present groups=wheel
   - name: add user testuser2
   user: name=testuser2 state=present groups=wheel

  方式2使用变量方式
   - name: add several users
   vars:
   user1: testuser1
   user2: testuser2
   user: name={{ user1 }} state=present groups=wheel
   user: name={{ user2 }} state=present groups=wheel

  方式3使用迭代方式
   - name: add several users
   user: name={{ item }} state=present groups=wheel
   with_items:
   - testuser1
   - testuser2
   事实上with_items中可以使用元素还可为hashes例如
   - name: add several users
   user: name={{ item.name }} state=present groups={{ item.groups }}
   with_items:
   - { name: ‘testuser1‘, groups: ‘wheel‘ }
   - { name: ‘testuser2‘, groups: ‘root‘ }


六、Playbooks
Playbooks 是 Ansible 管理配置、部署应用和编排的语言，可以使用 Playbooks 来描述你想在远程主机执行的策略或者执行的一组步骤过程等
如果说 Ansible 模块是工作中的工具的话，那么 playbooks 就是方案；
推荐阅读 ansible-examples 实例https://github.com/ansible/ansible-examples
playbooks采用 YMAL 语法结构，基本的 YMAL 语法请参考http://docs.ansible.com/YAMLSyntax.html

playbook是由一个或多个“play”组成的列表。play的主要功能在于将事先归并为一组的主机装扮成事先通过ansible中的task定义好的角色。
从根本上来讲所谓task无非是调用ansible的一个module。将多个play组织在一个playbook中即可以让它们联同起来按事先编排的机制同唱一台大戏。

playbooks组成：
Target section：定义将要执行 playbook 的远程主机组
Variable section：定义 playbook 运行时需要使用的变量
Task section：定义将要在远程主机上执行的任务列表
Handler section：定义 task 执行完成以后需要调用的任务

例子：
  ---
  - hosts: webservers     \\Target section
    vars:
      http_port: 80     \\Variable section
      max_clients: 200
    remote_user: root
    tasks:       \\Task section
    - name: ensure apache is at the latest version
    yum: pkg=httpd state=latest
    - name: write the apache config file
    template: src=/srv/httpd.j2 dest=/etc/httpd.conf
    notify:
       - restart apache
    - name: ensure apache is running
   service: name=httpd state=started
    handlers:       \\Handler section
      - name: restart apache
      service: name=httpd state=restarted

playbook基础组件
   1、Hosts和Users
  playbook中的每一个play的目的都是为了让某个或某些主机以某个指定的用户身份执行任务。
  hosts用于指定要执行指定任务的主机其可以是一个或多个由冒号分隔主机组。
  remote_user则用于指定远程主机上的执行任务的用户。

  不过remote_user也可用于各task中。也可以通过指定其通过sudo的方式在远程主机上执行任务其可用于play全局或某任务。
  此外甚至可以在sudo时使用sudo_user指定sudo时切换的用户。

  - hosts: webnodes
  remote_user: mageedu
  tasks:
  - name: test connection ping:
  remote_user: mageedu sudo: yes

   2、任务列表和action
  play的主体部分是task list。task list中的各任务按次序逐个在hosts中指定的所有主机上执行即在所有主机上完成第一个任务后再开始第二个。
  在运行自下而下某playbook时如果中途发生错误所有已执行任务都将回滚因此在更正playbook后重新执行一次即可。
  task的目的是使用指定的参数执行模块而在模块参数中可以使用变量。模块执行是幂等的这意味着多次执行是安全的因为其结果均一致。
  每个task都应该有其name用于playbook的执行结果输出建议其内容尽可能清晰地描述任务执行步骤。如果未提供name则action的结果将用于输出。

  定义task的可以使用“action: module 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 and 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

      3、handlers

  用于当关注的资源发生变化时采取一定的操作。
  “notify”这个action可用于在每个play的最后被触发这样可以避免多次有改变发生时每次都执行指定的操作取而代之仅在所有的变化发生完成后一次性地执行指定操作。在notify中列出的操作称为handler也即notify中调用handler中定义的操作。

   - name: template configuration file
   template: src=template.j2 dest=/etc/foo.conf
   notify:
   - restart memcached
   - restart apache

  handler是task列表这些task与前述的task并没有本质上的不同。

  handlers:
  - name: restart memcached
  service: name=memcached state=restarted
  - name: restart apache
  service: name=apache state=restarted



主机和用户：
在 playbook 中的每一个 play 都可以选择在哪些机器和以什么用户身份完成，hosts 一行可以是一个主机组或者主机也可以是多个，中间以冒号分隔,可以参考前面讲的通配模式；remote_user表示执行的用户账号

任务列表：
每个任务建议定义一个可读性较强的名字即 name，在执行 playbook 时会输出，tasks 的声明格式，在旧版本使用”action:module options”,建议使用”module:options”的格式

下面以 service 模块为例来定义一个任务，service: key=value 参数，请参看模块的详细介绍
  tasks:
    - name: make sure apache is running
       service: name=httpd state=running

  command 和 shell 模块不需要增加 key
  tasks:
     - name: disable selinux
     command: /sbin/setenforce 0

command 和 shell 模块关注命令或者脚本执行后返回值，如果命令成功执行返回值不是 0 的情况下，可以使用以下方法
  tasks:
    - name: run this command and ignore the result
    shell: /usr/bin/somecommand || /bin/true
  或者
  tasks:
    - name: run this command and ignore the result
    shell: /usr/bin/somecommand
    ignore_errors: True

如果在任务中参数过长可以回车使用空格缩进
  ---
  - hosts: server
     tasks:
     - name: Copy ansible inventory file to client
        copy: src=/etc/ansible/hosts dest=/tmp/hosts
     owner=root group=root mode=0644

变量的使用
1. 如何创建一个有效的变量名
变量名应该由字母、数组和下划线组成，以字母开头
例如：foo_port、foo5 就是很好的变量名，而 foo-port、foo port、foo.port、12 都是无效的变量名

2.在在 inventory 中定义变量
第四章已经讲过关于主机清单中的变量如何定义的内容，请参看第四章

3.在在 playbook 中如何定义变量
  - hosts: webservers
     vars:
    http_port: 80

4. 从角色和文件包含中定义变量
参考下面：角色和包含 http://docs.ansible.com/playbooks_roles.html#role-default-variables

5. 如何使用变量：Jinja2
  Jinja2 是一个被广泛使用的全功能的 Python 模板引擎，它有完整的 unicode 支持,一个可选的集成沙箱的执行环境,支持 BSD 许可
  举一个简单的模板例子：
   My amp goes to {{ max_amp_value }}
  或者在 playbook 中使用
  template: src=foo.cfg.j2 dest={{ remote_install_path }}/foo.cfg
  在模板中可以获得一个主机的所有变量，实际上也可以获取其他主机的变量

注释：Ansible 允许在模板中使用循环和条件判断，但是在 playbook 只使用纯粹的 YAML 语法

本文出自 “行者--->” 博客，请务必保留此出处http://liumissyou.blog.51cto.com/4828343/1616462

文章来自：http://liumissyou.blog.51cto.com/4828343/1616462