一、用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:
思路图2:
二、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回滚到前面的配置。