playbook变量的使用(一)

本章主要介绍playbook中的变量。

• 自定义变量
• 使用变量文件
• 字典变量
• 列表变量
• 注册变量
• facts变量

为了能够写出更实用的playbook，需要在playbook中使用变量。下面来讲解playbook

中常见的变量。本章实验都在/home/lduan/demo1下操作

31.1 手动定义变量

通过vars来定义变量，vars和 tasks对齐。定义变量的格式如下。

1 vars:
2 aa: value1
3 bb: value2
4 aa: value3
5 ...

这里aa重复定义了，所以aa的值最终是value3。

引用变量时用 {{变量名}} ，大括号内侧两边是否有空格是无所谓的，如下所示。

1 {{变量名}}
2 {{ 变量名 }}
3 {{ 变量名 }}
4 {{ 变量名 }}

练习：写一个名称为1.yaml的playbook，里面定义以下3个变量。

myname1=tom

myname2=tom2

myname3=tom3

然后打印mynamel的值，命令如下。

[root@pp demo1]# cat 1.yaml 
---
- hosts: up
  vars:
    myname: tom1
    myname: tom2
    myname: tom3
  tasks:
  - name: 打印某个变量
    debug: msg="变量myname1的值是{{myname1}}"
[root@pp demo1]# 

运行此playbook，命令如下。

[root@pp demo2]# ansible up -m ping 
up | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": false,
    "ping": "pong"
}
[root@pp demo2]# ansible-playbook 1.yaml 

PLAY [up] ********************************************************************************

TASK [Gathering Facts] *******************************************************************
ok: [up]

TASK [打印某个变量] ****************************************************************************
ok: [up] => {
    "msg": "变量myname1的值是tom1"
}

PLAY RECAP *******************************************************************************
up                         : ok=2    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   

[root@pp demo2]# 

可以看到,打印了myname1的值为 tom1。

定义变量时，同一个变量定义多次，后面定义的生效，修改1.yaml的内容如下。

[root@pp demo2]# cat 1.yaml 
---
- hosts: up
  vars:
    myname1: tom1
    myname2: tom2
    myname3: tom3
    myname1: tom3
  tasks:
  - name: 打印某个变量
    debug: msg="变量myname1的值是{{myname1}}"
[root@pp demo2]# 

这里定义了两次 mynamel 这个变量，第一次定义的值为toml，第二次定义的值为

tom3。下面运行此playbook查看结果，如下所示。

[root@pp demo2]# ansible-playbook 1.yaml 
[WARNING]: While constructing a mapping from /root/demo2/1.yaml, line 4, column 5, found
a duplicate dict key (myname1). Using last defined value only.

PLAY [up] ********************************************************************************

TASK [Gathering Facts] *******************************************************************
ok: [up]

TASK [打印某个变量] ****************************************************************************
ok: [up] => {
    "msg": "变量myname1的值是tom3"
}

PLAY RECAP *******************************************************************************
up                         : ok=2    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   

[root@pp demo2]# 

因为mynamel重复定义了两次，所以运行此playbook时会有提示，意思是变量重复定义

了，且后面定义的myname1生效，打印的结果为 tom3。

 

31.2变量文件

如果定义的变量太多，可以把变量拿出来单独放在一个文件中，然后在playbook中通过

vars_files引用此变量文件，那么就可以直接使用此变量文件中的变量了，就像变量文件中的

变量直接在YAML文件中定义似的，这样更方便管理。

例如，创建文件vars.yaml，内容如下。

[root@pp demo2]# cat vars.yaml 
myv1: aaa
myv2: bbb
myv3: ccc
[root@pp demo2]# 

修改1.yaml 的内容如下。

[root@pp demo2]# cat 1.yaml
---
- hosts: up
  vars_files:
  - vars.ymal
  vars:
    myname1: tom1
    myname2: tom2
    myname3: tom3
    myname1: tom3
  tasks:
  - name: 打印某个变量
    debug: msg='变量myname1的值是{{myname1}}'
  - name: 打印变量myv1的值
    debug: msg='变量myv1的值是{{myv1}}'
[root@pp demo2]# 

这里通过vars_files来引用变量文件 vars.yaml，然后打印变量myvl的值，运行结果如下。

[root@pp demo2]# ansible-playbook 1.yaml 
[WARNING]: While constructing a mapping from /root/demo2/1.yaml, line 6, column 5, found
a duplicate dict key (myname1). Using last defined value only.

PLAY [up] ********************************************************************************

TASK [Gathering Facts] *******************************************************************
ok: [up]

TASK [打印某个变量] ****************************************************************************
ok: [up] => {
    "msg": "变量myname1的值是tom3"
}

TASK [打印变量myv1的值] ************************************************************************
ok: [up] => {
    "msg": "变量myv1的值是aaa"
}

PLAY RECAP *******************************************************************************
up                         : ok=3    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   

[root@pp demo2]# 

31.3 字典变量

所谓字典（dictionaries简写为dict)，就是存储多个变量的容器，       

可以把字典理解为一个木桶，里面存放了很多个变量。如图31-1所

示，两个木桶xx和yy，里面分别存储了3个变量: aa=1，bb=2，

cc=3。

同一个字典中定义的多个变量不可有重复值，否则后面定义的变

量会覆盖前面定义的变量。

要是引用木桶中的变量，必须指定是哪个木桶中的变量。例如，要引用木桶xx中的变量

aa，则使用xx.aa。

字典是在vars下定义的，语法如下。

1 字典名:
2 var1: value2
3 var2: value2
4 ...

注意

在字典中定义这一个个变量时，变量前面是不加“-”的，且定义变量没有先后顺序。

通过“字典名.变量名”这种格式来引用变量，看下面的例子。

[root@pp demo2]# cat 2.yaml
---
- hosts: up
  vars:
    dict1:
      myv1: aaa
      myv2: bbb
      myv3: ccc
    doct2:
      myv1: 111
      myv2: 222
      myv3: 333
  tasks:
  - name: 打印第一个变量
    debug: msg="{{dict1.myv1}}"
[root@pp demo2]# 

这里定义了两个字典dict1和 dict2，里面分别有3个变量，最后通过dict1.myvl引用了字

典dick1中的变量myvl。通过ansible-playbook 2.yaml运行的结果应该为aaa，如下所示。

[root@pp demo2]# ansible-playbook 2.yaml 

PLAY [up] ********************************************************************************

TASK [Gathering Facts] *******************************************************************
ok: [up]

TASK [打印第一个变量] ***************************************************************************
ok: [up] => {
    "msg": "aaa"
}

PLAY RECAP *******************************************************************************
up                         : ok=2    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   

[root@pp demo2]# 

如果在同一个字典中出现了相同的变量名，则后面定义的变量的值会覆盖前面定义的变量

的值。

31.4 列表变量

列表变量和字典变量比较容易弄混。下面来看一个例子，定义一个员工表，里面有3个员

工，每个员工通过以下3个属性记录。

（1）uname：记录用户名。

（2）age：记录年龄。

（3）sex：记录性别。这个员工表的内容如下。

1 employee:
2 uname: lisi
3 age: 22
4 sex: man
5
6 uname: wangwu
7 age: 24
8 sex: man
9
10 uname: xiaohua
11 age: 21
12 sex: wuman

为了看得清楚，这里把每个用户用空白行隔开了。每个用户都是由3个变量组成的一个整

体，这个整体是员工表employee的一个元素。所以，这个员工表有3个元素，即3个人。

每个元素都有uname，所以列表employee共有3个uname，但是这3个uname不应该是

冲突的，因为它们分别属于不同的人。

但是为了防止误会，每个元素的第一个变量前都加上一个“-”，表示它是这个元素的第

一个变量。所以，员工表改成如下内容。

1 employee:
2 ‐ uname: lisi
3 age: 22
4 sex: man
5
6 ‐ uname: wangwu
7 age: 24
8 sex: man
9
10 ‐ uname: xiaohua
11 age: 21
12 sex: wuman

这样看起来就清晰了很多,这里employee就是一个列表。

那如果想获取某个元素（某个员工）的信息该怎么办呢?可以通过employee[n]来获取，

这里的n叫作下标,下标从0开始。

例如，要获取第一个用户的信息，则使用employee[0]即可，employee[0]得到的值如

下。

1 uname: lisi
2 age: 22
3 sex: man

可以看到，这是由3个变量组成的，这3个变量组成了一个字典，即employee[0]就是一个

字典。如果想获取第一个用户的用户名，则可以通过employee[0].uname来获取。

所以，员工表employee是由3个字典组成的;employee[0]、employee[1]、

employee[2]。 列表和字典的不同如下。

（1）列表的每个元素的第一个变量都是以“-”开头。

（2）字典的每个变量前面都不带“-”。

练习1：判断下面的aa1和aa2是列表还是字典。

aa1 aa2

- xx: v1 xx: v1

- yy: v2 yy: v2

这里左边的aal是列表，每个元素中仅有一个变量，右边的aa2是字典。

练习2：写一个名称为3-list.yaml 的playbook，定义一个用户列表，里面包含3个用户,每

个用户由uname、sex、age组成，命令如下。

[root@pp demo2]# cat 3-list.yaml 
---
- hosts: up
  vars:
    user:
    - uname: tom
      sex: mem
      age: 19
    - uname: bob
      sex: men
      age: 20
    - uname: mary
      sex: women
      age: 22
  tasks:
  - name: 打印一个变量
    debug: msg={{user[2]}}

[root@pp demo2]# 

这里列表users定义了3个元素，现在要获取第3个元素用users[2]来表示,运行结果如下。

[root@pp demo2]# ansible-playbook 3-list.yaml 

PLAY [up] ********************************************************************************

TASK [Gathering Facts] *******************************************************************
ok: [up]

TASK [打印一个变量] ****************************************************************************
ok: [up] => {
    "msg": {
        "age": 22,
        "sex": "women",
        "uname": "mary"
    }
}

PLAY RECAP *******************************************************************************
up                        

如果要获取第3个用户的用户名，修改3-list.yaml的内容如下。

[root@pp demo2]# cat 3-list.yaml 
---
- hosts: up
  vars:
    user:
    - uname: tom
      sex: mem
      age: 19
    - uname: bob
      sex: men
      age: 20
    - uname: mary
      sex: women
      age: 22
  tasks:
  - name: 打印一个变量
    debug: msg={{user[2].uname}}

[root@pp demo2]# 

运行此playbook，命令如下

[root@pp demo2]# ansible-playbook 3-list.yaml 

PLAY [up] ********************************************************************************

TASK [Gathering Facts] *******************************************************************
ok: [up]

TASK [打印一个变量] ****************************************************************************
ok: [up] => {
    "msg": "mary"
}

PLAY RECAP *******************************************************************************
up                         : ok=2    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   

定义列表时,也可以直接写值不写变量，通过如下方式来定义。

1 listname:
2 ‐ var1
3 ‐ var2
4 ‐ var3
5 ...

这种定义变量的方式可以换成如下内容。

1 listname: [var1,var2,var3,...]

31.5 数字变量的运算

在YAML 文件中定义的变量，其值如果是数字，则可以进行数学运算。常见的数学运算

符包括+（加)、-（减)、*（乘)、/（除)、**（次方)。

练习：写一个名称为4-vars,yaml 的 playbook，定义了变量aa，值为3，然后求aa*2和

aa的3次方，命令如下。

[root@pp demo2]# cat 4-list.yaml 
---
- hosts: up
  vars:
    aa: 3
  tasks:
  - name: 3乘2的值
    debug: msg={{aa*2}}
  - name: 3的3次方
    debug: msg="{{3**3}}"
[root@pp demo2]# 

运行此playbook，命令如下。

[root@pp demo2]# ansible-playbook 4-list.yaml 

PLAY [up] ********************************************************************************

TASK [Gathering Facts] *******************************************************************
ok: [up]

TASK [3乘2的值] *****************************************************************************
ok: [up] => {
    "msg": "6"
}

TASK [3的3次方] *****************************************************************************
ok: [up] => {
    "msg": "27"
}

PLAY RECAP *******************************************************************************
up                         : ok=3    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   

31.6注册变量

在playbook中用shell模块执行某个系统命令后，在结果中是不会显示这个命令结果的,这

个和在命令行中用ansible命令调用shell模块不一样。

练习：写一个 playbook，在里面执行系统命令hostname，命令如下。

[root@pp demo2]# cat 5-regl.yaml 
---
- hosts: up
  tasks:
  - name: 执行一个操作命令
    shell: 'hostname'

[root@pp demo2]# 

运行此playbook，命令如下。

[root@pp demo2]# ansible-playbook 5-regl.yaml 

PLAY [up] ********************************************************************************

TASK [Gathering Facts] *******************************************************************
ok: [up]

TASK [执行一个操作命令] **************************************************************************
changed: [up]

PLAY RECAP *******************************************************************************
up                         : ok=2    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   

可以看到，没有任何输出。如果想查看这个shell命令的结果，可以把shell 命令的结果保

存在一个变量中，这个变量就是注册变量，然后打印这个变量的值即可。修改5-reg1.yaml

的内容如下。

[root@pp demo2]# cat 5-regl.yaml 
---
- hosts: up
  tasks:
  - name: 执行一个操作命令
    shell: 'hostname'
    register: aa
  - name: 打印注册变量aa的值
    debug: msg={{aa}}
[root@pp demo2]# 

运行此playbook，命令如下

[root@pp demo2]# ansible-playbook 5-regl.yaml 

PLAY [up] ********************************************************************************

TASK [Gathering Facts] *******************************************************************
ok: [up]

TASK [执行一个操作命令] **************************************************************************
changed: [up]

TASK [打印注册变量aa的值] ************************************************************************
ok: [up] => {
    "msg": {
        "changed": true,
        "cmd": "hostname",
        "delta": "0:00:00.003840",
        "end": "2023-12-21 11:59:35.610753",
        "failed": false,
        "rc": 0,
        "start": "2023-12-21 11:59:35.606913",
        "stderr": "",
        "stderr_lines": [],
        "stdout": "up",
        "stdout_lines": [
            "up"
        ]
    }
}

PLAY RECAP *******************************************************************************
up                         : ok=3    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored

结果中msg后面的内容就是aa的值，可以看到aa就是一个字典。其中cmd是执行的系统

命令，rc是此命令的返回值，stdout表示此命令的结果。

所以，如果只获取这个命令的结果，只要打印字典aa中的 stdout 变量即可。修改5-

regl.yam1的内容如下。

[root@pp demo2]# cat 5-regl.yaml 
---
- hosts: up
  tasks:
  - name: 执行一个操作命令
    shell: 'hostname'
    register: aa
  - name: 打印注册变量aa的值
    debug: msg={{aa.stdout}}
[root@pp demo2]# 

运行此playbook，命令如下

[root@pp demo2]# ansible-playbook 5-regl.yaml 

PLAY [up] ********************************************************************************

TASK [Gathering Facts] *******************************************************************
ok: [up]

TASK [执行一个操作命令] **************************************************************************
changed: [up]

TASK [打印注册变量aa的值] ************************************************************************
ok: [up] => {
    "msg": "up"
}

PLAY RECAP *******************************************************************************
up                         : ok=3    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   

[root@pp demo2]# 

31.7 facts变量

ansible通过setup模块是可以获取到被管理主机的所有信息的，这些信息都是以变量的方

式存在，这些变量称为facts，前面在setup模块中已经介绍过了。现在写一个名称为6-

fact.yaml的playbook,用于打印server2的IP和主机名,命令如下。

[root@pp demo2]# cat 6-fact.yaml 
---
- hosts: up
  vars:
    list: ['aaa:']
  tasks:
  - name: 打印IP
    debug: msg={{ansible_default_ipv4.address}}
  - name: 打印主机名
    debug: msg={{ansible_fqdn}}
[root@pp demo2]# 

这里打印 IP 用到的fact变量是 ansible default ipv4.address，打印主机名用到的fact变

量是 ansible_fqdn，运行结果如下。

[root@pp demo2]# ansible-playbook 6-fact.yaml 

PLAY [up] ********************************************************************************

TASK [Gathering Facts] *******************************************************************
ok: [up]

TASK [打印IP] ******************************************************************************
ok: [up] => {
    "msg": "192.168.248.23"
}

TASK [打印主机名] *****************************************************************************
ok: [up] => {
    "msg": "up"
}

PLAY RECAP *******************************************************************************
up                         : ok=3    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0