七、用playbook安装Nginx、playbook管理配置文件

一、用playbook安装Nginx

思路:先在一台机器上编译安装好nginx、打包,然后再用ansible去下发

# cd /etc/ansible   进入ansible配置文件目录
# mkdir  nginx_install   创建一个nginx_install的目录,方便管理
# cd nginx_install
# mkdir -p roles/{common,install}/{handlers,files,meta,tasks,templates,vars}

说明:roles目录下有两个角色,common为一些准备操作,install为安装nginx的操作。每个角色下面又有几个目录,handlers下面是当发生改变时要执行的操作,通常用在配置文件发生改变,重启服务。files为安装时用到的一些文件(拷贝到对方机器的文件),meta为说明信息,说明角色依赖等信息(可以留空),tasks里面是核心的配置文件,templates通常存一些配置文件,启动脚本等模板文件,vars下为定义的变量。


需要事先准备好安装用到的文件,具体如下:

1、在一台机器上事先编译安装好nginx,配置好启动脚本,配置好配置文件。

2、安装好后,我们需要把nginx目录打包,并放到/etc/ansible/nginx_install/roles/install/files/下面,名字为nginx.tar.gz

3、启动脚本、配置文件都要放到/etc/ansible/nginx_install/roles/install/templates下面

nginx、启动脚本,nginx配置文件。

# ls /usr/local/nginx/
client_body_temp  conf  fastcgi_temp  html  logs  proxy_temp  sbin  scgi_temp  uwsgi_temp
[root@fuxi01 nginx_install]# ls /etc/init.d/nginx 
/etc/init.d/nginx
[root@fuxi01 nginx_install]# ls /usr/local/nginx/conf/nginx.conf
/usr/local/nginx/conf/nginx.conf
编译好的nginx,启动脚本,配置文件。
然后打包:
# cd /usr/local/
[root@fuxi01 local]# tar czvf nginx.tar.gz --exclude "nginx.conf" --exclude "vhost" nginx/    //过滤掉nginx.conf和vhost目录不要。
[root@fuxi01 local]# mv nginx.tar.gz /etc/ansible/nginx_install/roles/install/files/   //移动到该目录下
[root@fuxi01 local]# cp nginx/conf/nginx.conf /etc/ansible/nginx_install/roles/install/templates/
[root@fuxi01 local]# cp /etc/init.d/nginx /etc/ansible/nginx_install/roles/install/templates/


定义common的tasks,nginx是需要一些依赖包的,用到了yum模块,安装zlib和pcre包。

# cd  /etc/ansible/nginx_install/roles
# vim  ./common/tasks/main.yml //内容如下
- name: Install initializtion require software
  yum: name={{ item }} state=installed
  with_items:
    - zlib-devel
    - pcre-devel

定义变量

为什么要把它放到模板里?

因为模板里支持变量的。

在部署的时候,可以根据机器环境的不同,定义不同的值。比如第一台机器定义的www,第二台机器定义的是Apache。左边是变量名,右边是变量值(www)。

# vim /etc/ansible/nginx_install/roles/install/vars/main.yml //内容如下
nginx_user: www
nginx_port: 80
nginx_basedir: /usr/local/nginx

首先要把所有用到的文档拷贝到目标机器

# vim /etc/ansible/nginx_install/roles/install/tasks/copy.yml //内容如下
- name: Copy Nginx Software
  copy: src=nginx.tar.gz dest=/tmp/nginx.tar.gz owner=root group=root
- name: Uncompression Nginx Software
  shell: tar zxf /tmp/nginx.tar.gz -C /usr/local/
- name: Copy Nginx Start Script
  template: src=nginx dest=/etc/init.d/nginx owner=root group=root mode=0755
- name: Copy Nginx Config
  template: src=nginx.conf dest={{ nginx_basedir }}/conf/ owner=root group=root mode=0644

这里的nginx.tar.gz没有写绝对路径,因为copy模块默认就会在install/files目录下去找,template模块会到templates下面去找。


接下来会建立用户,启动服务,删除压缩包。(这就是一个总的yml。)

# vim   /etc/ansible/nginx_install/roles/install/tasks/install.yml  //内容如下
- name: Create Nginx User
  user: name={{ nginx_user }} state=present createhome=no shell=/sbin/nologin
- name: Start Nginx Service
  shell: /etc/init.d/nginx start
- name: Add Boot Start Nginx Service
  shell: chkconfig --level 345 nginx on
- name: Delete Nginx compression files
  shell: rm -rf /tmp/nginx.tar.gz

说明:

模块user,变量nginx_user,在install/vars/main.yml中定义的,present已存在的,createhome是否创建用户的家目录。

创建用户,启动nginx服务,开机启动nginx服务,删除nginx的压缩包。


再创建main.yml并且把copy和install调用

# vim /etc/ansible/nginx_install/roles/install/tasks/main.yml //内容如下
- include: copy.yml
- include: install.yml

到此两个roles:common和install就定义完成了,接下来要定义一个入口配置文件

# vim /etc/ansible/nginx_install/install.yml  //内容如下
---
- hosts: testhost
  remote_user: root
  gather_facts: True
  roles:
    - common
    - install

执行: ansible-playbook /etc/ansible/nginx_install/install.yml

执行这一步以前,一定要保证对方机器上是没有安装nginx的,执行成功后,到对方机器上查看nginx进程是这样的才为正确:

[root@yw03 ~]# ps aux |grep nginx
root       1127  0.0  0.0  45912  1284 ?        Ss   11月21   0:00 nginx: master process /usr/local/nginx/sbin/nginx -c /usr/local/nginx/conf/nginx.conf
nobody     1128  0.0  0.2  48404  4168 ?        S    11月21   0:43 nginx: worker process
nobody     1129  0.0  0.2  48404  3912 ?        S    11月21   0:00 nginx: worker process
root       8061  0.0  0.0 112732   972 pts/0    S+   22:02   0:00 grep --color=auto nginx

思路图1:

七、用playbook安装Nginx、playbook管理配置文件

思路图2:

七、用playbook安装Nginx、playbook管理配置文件



二、playbook管理配置文件

生产环境中大多时候是需要管理配置文件的,安装软件包只是在初始化环境的时候用一下。下面写一个管理nginx配置文件的playbook。

# mkdir -p /etc/ansible/nginx_config/roles/{new,old}/{files,handlers,vars,tasks}

其中new为更新时用到的,old为回滚时用到的,files下面为nginx.conf和vhosts目录,handlers为重启nginx服务的命令。

关于回滚,就是改错了配置文件需要回滚到原来的配置文件,然后把对应的服务进行加载。需要在执行playbook之前先备份一下旧的配置,所以对于老配置文件的管理一定要严格,千万不能随便去修改线上机器的配置,并且要保证new/files下面的配置和线上的配置一致。

先把nginx.conf和vhosts目录放到files目录下面

# cd /usr/local/nginx/conf/
# cp -r nginx.conf vhost  /etc/ansible/nginx_config/roles/new/files/

# vim /etc/ansible/nginx_config/roles/new/vars/main.yml   //定义变量
nginx_basedir: /usr/local/nginx

# vim /etc/ansible/nginx_config/roles/new/handlers/main.yml  //定义重新加载nginx服务
- name: restart nginx
  shell: /etc/init.d/nginx reload

# vim /etc/ansible/nginx_config/roles/new/tasks/main.yml //这是核心的任务
- name: copy conf file
  copy: src={{ item.src }} dest={{ nginx_basedir }}/{{ item.dest }} backup=yes owner=root group=root mode=0644
  with_items:
    - { src: nginx.conf, dest: conf/nginx.conf }
    - { src: vhost, dest: conf/ }
  notify: restart nginx
  说明:
  这里的循环对象有两个子对象。一个是src,一个是dest,item.src的只循环items里的src,item.dest的只循环items里的dest。
  将nginx.conf拷贝到/usr/local/nginx/conf/nginx.conf。
  notify,这里就是handlers,用的是restart nginx    在该文件内:/etc/ansible/nginx_config/roles/new/handlers/main.yml

# vim /etc/ansible/nginx_config/update.yml // 最后是定义总入口配置
---
- hosts: testhost
  user: root
  roles:
  - new

执行: ansible-playbook /etc/ansible/nginx_config/update.yml

当变更了某个文件内容时,再次执行此命令,只会对那一个变更的文件进行更新。

而回滚的backup.yml对应的roles为old

# rsync -av  /etc/ansible/nginx_config/roles/new/ /etc/ansible/nginx_config/roles/old/

回滚操作就是把旧的配置覆盖,然后重新加载nginx服务, 每次改动nginx配置文件之前先备份到old里,对应目录为/etc/ansible/nginx_config/roles/old/files

# vim /etc/ansible/nginx_config/rollback.yml // 最后是定义总入口配置
---
- hosts: testhost
  user: root
  roles:
  - old

顺序为:更改配置文件内容前,先rsync备份到old下,然后再对/new/files下的配置文件进行更改,更改后执行ansible-playbook update.yml,如果没问题,那就OK,如果有问题,再执行ansible-playbook rollback.yml回滚到前面的配置。

上一篇:Mac Technology Overview(一)


下一篇:Ansible入门笔记(3)之Playbook