Ansible变量
尽管系统自动化让重复的工作变得更加容易,但是每个系统还是有一些细微的差别,变量就是如何处理系统之间的不同之处。这里将会列出变量的极大部分使用方法。
本文假设:你已经知道如何使用Ansible。知道inventory,facts等概念。
Ansible定义变量的几中方式
1、在清单(inventory)中定义变量
2、在playbook中定义变量,使用var,或var_files:
3、在role中定义变量
4、自定义facts的变量
5、Register facts ,使用task返回结果作为变量
6、从命令行传递变量
使用变量,除了可用使用自定义的变量,还可以使用facts和其它主机的变量。
一、合法变量名
1、必须是字符,数字,下划线组成,变量必须以字符开头。
2、变量支持字典形式的映射。
3、有时候引用变量,使用小数点形式的引用方法可能会和Python内置的属性和方法冲突。建议使用[]形式。
二、开始定义与使用变量
1、清单变量
1.1定义清单主机变量,格式如下
[webserver] 172.16.1.10 ansible_ssh_user=root inventory_host_var="Host_vars" 172.16.1.20 ansible_ssh_user=root
1.2定义清单组变量
[webserver:vars] inventory_group_var="Group_vars"
1.3 可以根据对应的inventory创建文件,写入变量
mkdir /etc/ansible/host_vars mkdir /etc/ansible/group_vars vim /etc/ansible/host_vars/all 或者 vim /etc/ansible/host_vars/hostname vim /etc/ansible/group_vars/groupname
在文件中写入变量即可。
2、在playbook中定义变量
--- - hosts: hostname or groupname vars: playbook_var: Playbook_vars var_files: #使用变量文件 - filename.yml tasks: - name: Copy Jinja2 file to remote host template: src=/home/aheahe/var_tu.j2 dest=/root/var.conf
3、在role中定义变量
mkdir roles/test/{vars,files,templates,tasks,defaults,handlers} -p #创建role结构
vim roles/test/vars/main.yml #编辑task文件 --- role_vars_var: Role_vars_var
vim roles/test/defaults/main.yml #编辑默认变量文件 --- role_defaults_var: Role_default_var
vim roles/test/tasks/main.yml #编辑roles var文件 --- - name: Learn role vars template: src=1.j2 dest=/root/1
vim roles/test/templates/1.j2 #编辑模板文件 {{ role_vars_var }} {{ role_defaults_var }}
vim site.yml #编辑执行文件 --- - hosts: 172.16.1.10 roles: - /home/aheahe/roles/test
ansible-playbook site.yml #执行
#在被管理节点上查看结果
[172.16.1.10~]# cat 1 #可以看到生效了。 Role_vars_var Role_default_var
4、自定义Facts变量。
如果在被管理的主机上存在/etc/ansible/facts.d 目录,其中的以.fact 为文件结尾的JSON格式或者YML格式文件都会当做自定义facts。
[172.16.1.10]# vim /etc/ansible/facts.d/local.fact #编辑自定义facts文件 [general] Aheahe=aihe local="Local facts"
[ansible ~]$ansible 172.16.1.10 -m setup -a ‘filter=ansible_local‘ #在ansible控制节点查看自定义facts变量是否生效 172.16.1.10 | success >> { "ansible_facts": { "ansible_local": { "local": { "general": { "aheahe": "aihe", "local": "\"Local facts\"" } } } }, "changed": false }
可以像fact一样使用,自定义的fact变量。
vim roles/test/templates/1.j2 #使用刚才的角色 {{ role_vars_var }} {{ role_defaults_var }} {{ ansible_local.local.general.local }}
ansible-playbook site.yml #执行刚才的site.yml
[172.16.1.10 -]# cat /root/1 #被管理节点查看结果,显示正确 Role_vars_var Role_default_var "Local facts"
5、定义Register变量
在任务的执行结果后面加上register 关键字。
vim study.yml --- - hosts: 172.16.1.10 vars: playbook_var: Playbook_vars tasks: - name: Learn Register shell: ifconfig register: command_result - name: Test register shell: date when: command_result.rc == 0
ansible-playbook study.yml -v #执行的时候加上-v 选项。查看输出信息
6、从命令行传递变量,相信这点对大家来说已经不成问题了
ansible-playbook release.yml --extra-vars "version=1.23.45 other_variable=foo" --extra-vars ‘{"pacman":"mrs","ghosts":["inky","pinky","clyde","sue"]}‘ --extra-vars "@some_file.json"
三、使用变量
上面在举例子的时候,已经说明如何使用了。下面介绍如何使用fact变量和一台主机使用另外一台主机的变量。
vim var.j2 {{ ansible_hostname }} #这里是使用fact变量,两个主机的结果不一样 {{ hostvars[‘172.16.1.10‘][‘ansible_hostname‘] }} #这里两台主机的结果一样,node2>使用node1的变量
vim test.yml #提供剧本 --- - hosts: webserver tasks: - name: Use fact and other host vars template: src=/home/aheahe/playbook/var.j2 dest=/root/var.conf
ansible-playbook test.yml #执行
[[email protected]]# cat /root/var.conf #这里可以看到node2使用node1的变量。 node1 #这里是使用fact变量,两个主机的结果不一样 node1 #这里两台主机的结果一样,node2使用node1的变量
三、变量的优先级。处理同一个变量名多处定义的问题。
3.1、在1.x版本里面,越靠下优先级越高,可以覆盖上面的
1、role defaults 中定义的变量,优先级最低
2、从被管理系统中收集的facts信息
3、inventory中定义的变量
4、在playbook中的vars: 或者 roles 中的vars
5、一些连接变量,例如ansible_user 。
6、命令行的变量 ansible-playbook -e 选项的变量, 优先级别最高。
3.2 ,在2.x系列的版本中调整变量优先级的顺序为如下。优先级由低到高
- role defaults
- inventory vars
- inventory group_vars
- inventory host_vars
- playbook group_vars
- playbook host_vars
- host facts
- registered vars
- set_facts
- play vars
- play vars_prompt
- play vars_files
- role and include vars
- block vars (only for tasks in block)
- task vars (only for the task)
- extra vars
参考:
http://docs.ansible.com/ansible/playbooks_variables.html