通过 saltstack 批量更新 SSL 证书
哈喽大家好，我是咸鱼。
之前写过两篇关于 SSL 过期巡检脚本的文章：
这两篇文章都是讲如何通过脚本去自动检测 SSL 过期时间的，当我们发现某一域名的 SSL 证书过期之后，就要及时更换。
如果这个域名下有很多服务器，我们一台一台手动登录机器然后更新证书的话效率是非常低的，所以我们可以通过一些自动化运维工具去完成这些大量重复的工作。
像 ansible、puppet 这类工具也可以实现同样的效果，但是咸鱼这边主要用的还是 saltstack，所以今天介绍一些如何通过 saltstack 去批量更新 SSL 证书。
关于 saltstck 的介绍：
首先我们在 salt-master 的主目录下创建一个新的目录，用于存放 SSL 证书和脚本，我自己机器上的 master 主目录为 /home/salt/
mkdir -pv /home/salt/ssl_update/ssl
然后把 SSL 证书放在 /home/salt/ssl_update/ssl 目录下，如果有多个域名的话需要在下面创建多个对应的目录
[root@localhost]# tree /home/salt/ssl_update/
/home/salt/ssl_update
├── rollback.sls
├── update.sls
├── ssl
│ ├── domain1
│ │ ├── server.key
│ │ └── server.pem
│ ├── domain2
│ │ ├── server.key
│ │ └── server.pem
│ └── domain3
├── server.key
└── server.pem
接下来我们开始编写 saltstack 状态脚本：
update.sls负责更新证书rollback.sls负责回滚证书
因为之前遇到过更新证书之后由于证书链不完整导致证书失效，然后不得不紧急手动还原之前的证书。
所以觉得有必要做一个回滚操作，这样新证书有问题的时候能够及时自动还原。
我们先来看一下负责更新证书的 update.sls，这个脚本分成了三个模块：
- SSL 证书备份
- SSL 证书更新
- Nginx 重启
{% set domain = 'doamin1' %}
{% set ssl_dir = '/usr/local/nginx/ssl' %}
{% set dst_dir = ssl_dir + '/' + domain %}
{% set bak_dir = '/opt/backup/ssl/' + domain %}
backup_ssl:
cmd.run:
- name: "year=$(openssl x509 -in {{ dst_dir }}/server.pem -noout -dates|grep Before|awk '{print $4}') && mkdir -p {{ bak_dir }}/${year} && \\cp {{dst_dir}}/* {{ bak_dir }}/${year}"
ssl_update:
file.recurse:
- source: salt://ssl_check/ssl/{{domain}}
- name: {{ dst_dir }}
- require:
- cmd: backup_ssl
nginx_reload:
cmd.run:
- name: /usr/local/nginx/sbin/nginx -t && /usr/local/nginx/sbin/nginx -s reload
- require:
- file: ssl_update
首先是变量的定义
{% set domain = 'doamin1' %}
{% set ssl_dir = '/usr/local/nginx/ssl' %}
{% set dst_dir = ssl_dir + '/' + domain %}
{% set bak_dir = '/opt/backup/ssl/' + domain %}
domain: 设置域名为'doamin1'。ssl_dir: 设置 SSL 证书存放目录为'/usr/local/nginx/ssl'。dst_dir: 设置 SSL 证书实际存放路径为ssl_dir + '/' + domain。bak_dir: 设置备份目录为'/opt/backup/ssl/' + domain。
然后就是 SSL 证书备份。首先创建名为 backup_ssl 的命令执行模块，通过 cmd.run 执行 shell 命令，这个命令通过 OpenSSL 获取证书的有效期限，然后将证书拷贝到备份目录，以年份为子目录。
backup_ssl:
cmd.run:
- name: "year=$(openssl x509 -in {{ dst_dir }}/server.pem -noout -dates|grep Before|awk '{print $4}') && mkdir -p {{ bak_dir }}/${year} && \\cp {{dst_dir}}/* {{ bak_dir }}/${year}"
这条命令看着很长，其实可以拆解成
# 获取证书有效期限然后赋值给 year 变量
year=$(openssl x509 -in {{ dst_dir }}/server.pem -noout -dates|grep Before|awk '{print $4}')
# 创建带年份后缀的备份目录
mkdir -p {{ bak_dir }}/${year}
# 把当前的证书备份到备份目录中
cp {{dst_dir}}/* {{ bak_dir }}/${year}
接着我们开始更新 SSL 证书。创建名为 ssl_update 的文件递归模块，然后通过 file.recurse 把 salt-master 上的证书复制到指定服务器目录
ssl_update:
file.recurse:
- source: salt://ssl_check/ssl/{{domain}}
- name: {{ dst_dir }}
- require:
- cmd: backup_ssl
更新完之后我们还要对指定服务器上的 Nginx 服务进行配置检查并重启一下
nginx_reload:
cmd.run:
- name: /usr/local/nginx/sbin/nginx -t && /usr/local/nginx/sbin/nginx -s reload
- require:
- file: ssl_update
然后我们看一下负责回滚证书的 rollback.sls，这个脚本分成了两个个模块：
- 证书回滚
- Nginx 重启
{% set domain = 'doamin1' %}
{% set ssl_dir = '/usr/local/nginx/ssl' %}
{% set dst_dir = ssl_dir + '/' + domain %}
{% set bak_dir = '/opt/backup/ssl/' + domain %}
{% set year = salt['pillar.get']('year') or salt['cmd.run']('echo $(date +%Y) - 1| bc') %}
rollback:
cmd.run:
- name: "cp {{ bak_dir }}/$(({{ year }}))/* {{ dst_dir }}"
start:
cmd.run:
- name: /usr/local/nginx/sbin/nginx -t && /usr/local/nginx/sbin/nginx -s reload
- require:
- cmd: rollback
设置变量 year 的命令有点复杂，我们来看一下
{% set year = salt['pillar.get']('year') or salt['cmd.run']('echo $(date +%Y) - 1| bc') %}
salt['pillar.get']('year'): 尝试从Salt Pillar中获取名为year的变量的值。or: 如果前面的操作未成功（即year在 Pillar 中不存在），or后面的表达式将会被执行。salt['cmd.run']('echo $(date +%Y) - 1| bc'): 这部分代码使用 SaltStack 的cmd.run模块执行一个 shell 命令，该命令通过date命令获取当前年份，然后减去 1 得到前一年的年份。bc是一个计算器工具，用于执行数学运算。- 总结一下：首先从
Salt Pillar中查找，如果找不到则使用 shell 命令获取前一年的年份，确保在没有 Pillar 配置的情况下也有一个默认的年份
然后就是 SSL 证书回滚。创建名为 rollback 的命令执行模块，通过 cmd.run 执行 shell 命令
该命令通过将指定服务器备份目录中指定年份的证书拷贝到 SSL 证书目录实现回滚。
rollback:
cmd.run:
- name: "cp {{ bak_dir }}/$(({{ year }}))/* {{ dst_dir }}"
回滚完之后对指定服务器上的 Nginx 服务进行配置检查并重启一下，上面内容有，这里就不再介绍了。
