Ansible-playbook

作者: 酷酷的红帽子 | 来源:发表于2019-03-25 08:36 被阅读0次

简介

Playbook是由一个或多个“play”组成的列表,可以让它们联同起来按事先编排的机制执行;所谓task无非是调用ansible的一个module,而在模块参数中可以使用变量;模块执行是幂等的,这就意味着多次执行是安全的,因为其结果均一致。

特点

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

核心组件

  • Hosts:执行的远程主机列表
  • Tasks:任务,由模块定义的操作的列表;
  • Varniables:内置变量或自定义变量在playbook中调用
  • Templates:模板,即使用了模板语法的文本文件;
  • Handlers:和nogity结合使用,为条件触发操作,满足条件方才执行,否则不执行;
  • Roles:角色;

官方实例:

- hosts: webservers
  vars:
    http_port: 80
    max_clients: 200
  remote_user: root
  tasks:
  - name: ensure apache is at the latest version
    yum:
      name: 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:
    - name: restart apache
      service:
        name: httpd
        state: restarted
        
运行:
    -t Tag 指定运行特定的任务
    --skip-tags=SKIP_TAGS  跳过指定的标签
    --start-at-task=START_AT 从哪个任务后执行

检查语法:--syntac-check
测试运行:--check
handlers 和 notify结合使用触发条件,让playbook在满足一定触发条件时才去执行某条task。
ERROR! Unexpected Exception, this is probably a bug: unhashable type: 'dict'
如何遇到此类问题,是因为dict不可哈希,所以notify在配置下,使用可哈希数据类型即可。

变量

  • 变量的来源:
  • ansible setup facts远程主机的所有变量都可以用
  • 自定义变量
  • 优先级:
    • 通过命令行指定变量,优先级最高
    • 在/etc/ansible/hosts 定义变量,在主机组中的主机单独定义
    • 在/etc/ansible/hosts 定义变量,针对主机组中的所有主机集中定义变量
    • 在Playbook中定义变量(建议使用这种方法)

[WARNING]: Found variable using reserved name: port
如何遇到此类问题,是因为port为保留的变量名,更改一下变量名即可!

模版

  • 文本文件,内部嵌套有模板语言脚本(使用模板语言编写)
  • Jinja2 是由python编写的。在我们打算使用基于文本的模板语言时,jinja2是很好的解决方案。yaml是写playbook,jinja2是写配置文件模板的
  • 功能:将模板的文件的变量值转换成对应的本地主机的确定值。例如:ansible端写一个内建变量{{ansible_processor_vcpus }},当这个文件被复制到对应主机时会自动生成对应主机 cpu的颗数的结果替换之。
    • templates文件必须存放在templates目录下
    • yaml文件需要和templates目录平级
  • Jinja2语法
字面量:
    字符串:使用单引号或双引号; 
    数字:整数、浮点数;
    列表:[item1, item2, ...]
    元组:(item1, item2, ...)
    字典:{key1:value1, key2:value2, ...}
    布尔型:true/false

算术运算:
    +, -, *, /, //, %, **

比较操作:
    ==, !=, >, <, >=, <=

逻辑运算:and, or, not

实例:

[root@node1 templates]# cat nginxconf.j2.bak 
{% for vhost in  nginx_vhosts %}
server {
   listen {{ vhost }}
#   listen {{ vhost.listen }}

}

{% endfor %}
worker_processes {{ ansible_processor_vcpus }};

[root@node1 tmp]# cat nginxtemp.yam
- hosts: mageduweb
  remote_user: root
  vars:
    nginx_vhosts:
      - web1
      - web2
      - web3
#     nginx_vhosts:
#      - listen: 8080
  tasks:
    - name: template config to remote hosts
      template: src=nginx.conf.j2 dest=/etc/nginx/nginx.conf

条件判断

    - name: restart Nginx
      service: name=nginx state=restarted
      when: ansible_distribution_major_version == "6"

循环迭代

#基于字符串列表
  tasks:
  - name: create rsyncd file
    copy: src={{ item }} dest=/tmp/{{ item }}
    with_items:
      - a
      - b
      - c
      - d

      
*with_itmes 嵌套子变量*
#基于字典列表
- hosts: eagleslab
  remote_user: root
  tasks:
  - name: add several users
    user: name={{ item.name }} state=present groups={{ item.groups }}
    with_items:
      - { name: 'testuser1' , groups: 'wheel'}
      - { name: 'testuser2' , groups: 'root' }

角色

[root@node1 ~]# tree /etc/ansible/roles/
/etc/ansible/roles/
└── http
    ├── defaults
    ├── files
    ├── headlers
    ├── meta
    ├── tasks
    ├── template
    └── varsfiles/:存储由copy或script等模块调用的文件; 

  • tasks/:此目录中至少应该有一个名为main.yml的文件,用于定义各task;其它的文件需要由main.yml进行“包含”调用;
  • handlers/:此目录中至少应该有一个名为main.yml的文件,用于定义各handler;其它的文件需要由main.yml进行“包含”调用;
  • vars/:此目录中至少应该有一个名为main.yml的文件,用于定义各variable;其它的文件需要由main.yml进行“包含”调用;
  • templates/:存储由template模块调用的模板文本;
  • meta/:此目录中至少应该有一个名为main.yml的文件,定义当前角色的特殊设定及其依赖关系;其它的文件需要由main.yml进行“包含”调用;
  • default/:此目录中至少应该有一个名为main.yml的文件,用于设定默认变量;
  • files目录:存放由copy或script等模块调用的文件;

调用roles:

[root@node1 ~]# cat /etc/ansible/roles/site.yml
- hosts: abc
  remote_user: root
  roles:
    - httpd

实例分析:

[root@node1 ansible]# tree roles/
roles/
├── http
│   ├── defaults
│   │   └── main.yaml
│   ├── files
│   │   └── index.html
│   ├── headlers
│   │   └── main.yaml
│   ├── meta
│   │   └── main.yaml
│   ├── tasks
│   │   └── main.yaml
│   ├── templates
│   │   └── httpd.conf.j2
│   └── vars
│       └── main.yaml
└── site.yaml

[root@node1 roles]# cat site.yaml 
- hosts: node2
  remote_user: root
#  vars:
#    httpd_ports: 8080
  roles:
  - http
  
[root@node1 http]# cat files/index.html 
hello eagleslab!
[root@node1 http]# cat tasks/main.yaml 
- name: installed httpd service
  yum: name=httpd state=latest
  when: ansible_os_family  == "RedHat"
- name: start httpd server
  service: name=httpd state=restarted 
- name: write httpd config
  template: src=httpd.conf.j2 dest=/etc/httpd/conf/httpd.conf
  notify:
  - restart httpd
- name: config httpd index
  copy: src=index.html dest=/var/www/html/index.html

[root@node1 http]# cat templates/httpd.conf.j2 | grep -Ev "^[[:space:]]|^#"
ServerRoot "/etc/httpd"
Listen {{ httpd_ports }}
Include conf.modules.d/*.conf
User apache
Group apache
ServerAdmin root@localhost
<Directory />
</Directory>
DocumentRoot "/var/www/html"
<Directory "/var/www">
</Directory>
<Directory "/var/www/html">
</Directory>
<IfModule dir_module>
</IfModule>
<Files ".ht*">
</Files>
ErrorLog "logs/error_log"
LogLevel warn
<IfModule log_config_module>
</IfModule>
<IfModule alias_module>
</IfModule>
<Directory "/var/www/cgi-bin">
</Directory>
<IfModule mime_module>
</IfModule>
AddDefaultCharset UTF-8
<IfModule mime_magic_module>
</IfModule>
EnableSendfile on
IncludeOptional conf.d/*.conf

[root@node1 http]# cat headlers/main.yaml 
- name: restart httpd
  service: name=httpd state=restarted
  
[root@node1 http]# cat vars/main.yaml 
httpd_ports: 8000

持续更新ing

相关文章

网友评论

    本文标题:Ansible-playbook

    本文链接:https://www.haomeiwen.com/subject/bqvmvqtx.html