Ansible playbook入门

2017-04-19 阅读: Ansible

playbook是Ansible进行配置管理的基本组件。

第一个playbook

Ansible playbook的文件格式为yaml,具体yaml的语法可以参考这里

下面我们编写一个使用yum安装nginx的playbook作为入门,nginx.yaml的内容如下:

---
- hosts: web-servers
  tasks:
  - selinux: state=disabled
  - name: Add repository
    yum_repository:
      name: nginx
      baseurl: http://nginx.org/packages/centos/7/$basearch/
      gpgcheck: no
      enabled: yes
      description: nginx repo
  - name: Install nginx
    yum: name=nginx state=present
  - name: Copy nginx.conf
    template: src=./nginx.conf.j2 dest=/etc/nginx/nginx.conf owner=root group=root  mode=0644 validate='nginx -t -c %s'
    notify:
    - Restart nginx
  handlers:
  - name: Restart nginx
    systemd: name=nginx state=restarted enabled=yes
  • - hosts: web-servers定义了该playbook的目标主机,这里指定了资源清单文件/etc/ansible/hosts中的web-servers组,如果目标是所有主机则可以使用all
  • tasks:定义该playbook的task集合,可以使用ansible-playbook nginx.yaml --list-task打印playbook中的task。
  • - selinux: state=disabled定义了一个名称为selinux的task,使用Ansible的selinuxmodule禁用目标主机上的色Linux。
  • - name: Add repository定义的task使用Ansible的yum_repositorymodule向目标主机添加nginx官方的yum repo
  • - name: Install nginx定义的task使用Ansible的yummodule在各个目标主机上安装nginx
  • - name: Copy nginx.conf定义的task使用Ansible的templatemodule将nginx.conf.j2模板生成nginx.conf配置文件并推送到各个目标主机。notify指定了配置文件推送成功且配置文件内容发生变化侯触发名称为Restart nginx的handler。
  • handlers中只有一个Restart nginx的handler,使用Ansible的systemdmodule实现重启nginx服务。

nginx.conf.j2模板是python的Jinja2模本,这里作为一个入门的例子,先不考虑模板功能,直接使用一个期望的nginx配置文件的内容即可。

运行playbook

在运行playbook之前可以对playbook的语法进行检查:

ansible-playbook nginx.yaml --syntax-check

playbook: nginx.yaml

查看playbook中的task:

ansible-playbook nginx.yaml --list-task

显示playbook面向的主机:

ansible-playbook nginx.yaml --list-hosts

运行playbook:

ansible-playbook nginx.yaml

playbook运行成功后,会在各个目标主机上安装并启动nginx。以后如果需要更改nginx.conf的内容,只需要修改nginx.conf.j2,在运行这个playbook时,指定运行Copy nginx.conf这个task。

ansible-playbook nginx.yaml --start-at-task='Copy nginx.conf'

参考

标题:Ansible playbook入门
本文链接:https://blog.frognew.com/2017/04/ansible-playbook.html
转载请注明出处。

目录