ansible 变量简明入门
Posted
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了ansible 变量简明入门相关的知识,希望对你有一定的参考价值。
ansible 为什么需要变量?ansible 是用 python 语言编写的,如果连变量都不支持,要它何用?
ansible 的变量用在什么地方?
我们在安装 ansible 后,最常使用它的方式就是 ansible 和 ansible-playbook。在这两种方式,都可以使用变量。
ansible 的变量从哪里来?
例如:
1. 用户自定义的变量,在playbook 里定义的 vars 关键字,或者在其他文件定义的变量。
2. 无需用户自定义,而是来自远程主机收集到的 facts 变量。
3. template 文件可以直接使用以上两种变量。
4. 从 tasks 执行后返回的结果,可以注册成为一个变量,留待以后继续使用。
5. playbook 在执行时,支持临时从外部提供变量。
ansible 变量的使用举例
1. 用户自定义变量
[[email protected]_7 roles]# cat a.yml
---
- hosts: test
gather_facts: False
vars:
var1: haha
var2: your name is
tasks:
- debug: msg="{{var2}} {{var1}}"
说明:在 playbook 层的vars 字段后,定义了用户的变量,那么在后面所有地方都能使用这些变量了,除非,在后面有同名的变量,则会覆盖。
执行结果:
[[email protected]_7 roles]# ansible-playbook a.yml
TASK [debug] ****************************************************************************************************************
ok: [192.168.188.109] => {
"msg": "your name is haha"
}
变量覆盖的情况:
[[email protected]_7 roles]# cat a.yml
---
- hosts: test
gather_facts: False
vars:
var1: haha
var2: your name is
tasks:
- debug: msg="{{var2}} {{var1}}"
vars:
- var1: hehe
说明:在tasks 层里的 var1 变量会覆盖playbook 层声明的 var1 变量。
所以,执行的结果变成:
TASK [debug] ****************************************************************************************************************
ok: [192.168.188.109] => {
"msg": "your name is hehe"
}
1.1 从playbook 外部文件传入变量
只要将上面的例子进行一点小修改,就可以了
[[email protected]_7 roles]# cat a.yml
---
- hosts : test
gather_facts: False
vars_files:
- var_file1.yml
tasks:
- debug: msg="{{var1}}"
说明: 在playbook 里需要使用变量文件,可以通过 vars_files 字段声明,直接声明文件名(相对路径,相对当前执行的playbook 文件),也可以用绝对路径声明变量文件的路径。
var_file1.yml 里的内容:
var1: hello Han×××
执行结果:
TASK [debug] ****************************************************************************************************************
ok: [192.168.188.109] => {
"msg": "hello Han×××"
}
2. 远程主机收集的 facts 变量
playbook 执行时,默认会运行 setup 模块,收集远程主机的信息。setup 模块收集到的信息,是 jason 格式。
运行 ansible test -m setup , 可以看到返回的远程主机信息(节选部分的信息而已):
192.168.188.109 | SUCCESS => {
"ansible_facts": {
"ansible_all_ipv4_addresses": [
"192.168.188.109"
],
"ansible_all_ipv6_addresses": [
"fe80::20c:29ff:fe8e:cf65"
],
"ansible_apparmor": {
"status": "disabled"
},
"ansible_architecture": "x86_64",
"ansible_bios_date": "05/19/2017",
"ansible_bios_version": "6.00",
这些 facts 变量,playbook 都是可以直接使用的,如何使用?
例如,有 playbook 文件:
[[email protected]_7 roles]# cat a.yml
---
- hosts: test
tasks:
- debug: msg="{{ansible_all_ipv4_addresses}} {{ansible_os_family}}"
执行结果:
TASK [debug] ****************************************************************************************************************
ok: [192.168.188.109] => {
"msg": "[u‘192.168.188.109‘] RedHat"
}
特别说明一点:
facts数据的顶级key为ansible_facts,在引用时应该将其包含在变量表达式中。但自动收集的facts比较特殊,它以ansible_facts作为key,ansible每次收集后会自动将其注册为变量,所以facts中的数据都可以直接通过变量引用,甚至连顶级key ansible_facts都要省略。
3. template 使用变量
template module在Ansible中很常用,而它在使用的时候又没有显式的指定template文件中的值,有时候用户会对template文件中使用的变量感到困惑,所以在这里再次强调下。
在playbook中定义的变量,可以直接在template中使用,同时facts变量也可以直接在template中使用,当然也包含在inventory里面定义的host和group变量。只要是在playbook中可以访问的变量,都可以在template文件中使用。
Ansible模版文件使用变量的语法是Python的template语言Jinja2。
在下面的例子template index.html.j2中,直接使用了以下变量:
系统变量 ** {{ ansible_hostname }} **, ** {{ ansible_default_ipv4.address }} **
用户自定义的变量 ** {{ defined_name }} **
index.html.j2文件:
<html>
<title>Demo</title>
<body>
<div class="block" style="height: 99%;">
<div class="centered">
<h1>#46 Demo \{\{ defined_name \}\}</h1>
<p>Served by \{\{ ansible_hostname \}\} (\{\{ ansible_default_ipv4.address \}\}).</p>
</div>
</div>
</body>
</html>
4. 从tasks 返回的结果,需要注册成为变量才能使用
[[email protected]_7 roles]# cat a.yml
---
- hosts : test
gather_facts: False
tasks:
- shell : echo hello world
register: var
- debug: msg="{{var}}"
说明:
执行shell 模块后,返回信息是 jason 格式的。再通过 register 注册到 var 变量。
然后,通过 debug 模块,输出 var 变量。
执行结果(截取部分):
TASK [debug] ****************************************************************************************************************
ok: [192.168.188.109] => {
"msg": {
"changed": true,
"cmd": "echo hello world",
"delta": "0:00:00.001890",
"end": "2018-01-18 17:12:00.178123",
"failed": false,
"rc": 0,
"start": "2018-01-18 17:12:00.176233",
"stderr": "",
"stderr_lines": [],
"stdout": "hello world",
"stdout_lines": [
"hello world"
]
}
}
4.1 如何对jason 变量引用?
既然在这里已经说到 jason 变量了,那就顺便说说关于这类变量的引用。
通常可以用 "." 或者 index 引用。
例如,上一个例子中,我们想输出 stdout_lines ,则引用可以有:
var.stdout
或者, var[‘stdout‘] 。 这两种方式都是可以的。
所以,对 playbook 脚本进行一点修改:
[[email protected]_7 roles]# cat a.yml
---
- hosts : test
gather_facts: False
tasks:
- shell : echo hello world
register: var
- debug: msg="{{var.stdout}}"
执行结果:
TASK [debug] ****************************************************************************************************************
ok: [192.168.188.109] => {
"msg": "hello world"
}
如果我们要引用的变量是一个列表,例如上一个例子里的 stdout_lines 字段,就是一个列表,我们如何输出呢?可以使用 index 下标引用:
[[email protected]_7 roles]# cat a.yml
---
- hosts : test
gather_facts: False
tasks:
- shell : echo hello world
register: var
- debug: msg="{{var[‘stdout_lines‘][0]}}"
执行结果:
TASK [debug] ****************************************************************************************************************
ok: [192.168.188.109] => {
"msg": "hello world"
}
所以,在看到这里,应该能明白,ansible 的 setup 模块收集的 facts 变量,正确的引用方式了吧。
5. 执行playbook 时在外部传入变量
例子:
[[email protected]_7 roles]# cat a.yml
---
- hosts : test
gather_facts: False
tasks:
- debug: msg="{{var1}}"
执行:
[[email protected]_7 roles]# ansible-playbook a.yml -e ‘var1="hello LiZimei"‘
结果:
[[email protected]_7 roles]# ansible-playbook a.yml -e ‘var1="hello LiZimei"‘
5.1 在运行 playbook 时,也可以通过外部文件传入变量
使用命令的方式:
ansible-playbook a.yml -e ‘@var_file1.yml‘
用“@”符号引用文件
总结
上面的内容是 ansible 变量继续深入学习的最基础知识了。
以上是关于ansible 变量简明入门的主要内容,如果未能解决你的问题,请参考以下文章