幂等性(Idempotency)

幂等性是数学和计算机科学上一个常见的概念,多次执行产生的结果不会发生改变,这样的特性就被成为幂等性。幂等性是Idempotency的中文翻译,幂在数学上表示乘方结果,乘方的结果相等可以简洁地描述多次执行后得到相同结果这一概念的意思。

ansible中的幂等性

ansible中绝大多数的模块都具有幂等特性,意味着执行一次或多次不会产生副作用。但是shell、command、script、raw这四个模块时不满足幂等性,所有操作会重复执行,但是有些操作不允许重复执行,比如MySQL的初始化命令mysql_install_db,逻辑上它只在第一次配置的过程中初始化一次,其他任何时候都不应该再执行。所有,每当使用这四个模块的时候,都要想一想,重复执行这个命令会不会产生负面影响。

当然,在上面的四个模块中,除了raw模块外,都提供了实现幂等特性的参数,就是creates和removes:

  • creates参数当指定的文件或目录存在时,则不执行命令;
  • removes参数定的文件或目录不存在时,则不执行命令;

示例如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
---
- name: use some module
hosts: node
gather_facts: false
tasks:
# 网卡配置文件不存在时则不执行
- name: use command module
command: ifup ens33
args:
removes: /etc/sysconfig/network-scripts/ifcfg-ens33

# mysql配置文件已存在时则不执行,避免覆盖
- name: use shell module
shell: cp /tmp/my.cnf /etc/my.cnf
args:
creates: /etc/my.cnf

经过测试可以证明,使用removes或creates参数之后,就可以实现幂等性,保证命令不会重复执行。

这四个模块都不限于执行shell命令或shell脚本,可以通过executable参数指定其他解释器,如expec执行expect脚本、perl解释器执行perl脚本等等。如下:

change_when 和 faild_when
使用change_when 和 faild_when来改变task是changed还是faild的认定,也可以实现幂等性