playbook变量的使用(一)

发布时间：2023年12月21日
本章主要介绍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

文章来源:https://blog.csdn.net/ZXDNM_zwz/article/details/135124363
本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
最新文章