Ansible Playbook 变量与 register 详解

ansible 定义变量方式与[多层]变量引用，以及 register 详解

主机规划

添加用户账号

说明：

1、 运维人员使用的登录账号；

2、 所有的业务都放在 /app/ 下「yun用户的家目录」，避免业务数据乱放；

3、 该用户也被 ansible 使用，因为几乎所有的生产环境都是禁止 root 远程登录的（因此该 yun 用户也进行了 sudo 提权）。

 # 使用一个专门的用户，避免直接使用root用户
 # 添加用户、指定家目录并指定用户密码
 # sudo提权
 # 让其它普通用户可以进入该目录查看信息
 useradd -u  -d /app yun && echo '' | /usr/bin/passwd --stdin yun
 echo "yun  ALL=(ALL)       NOPASSWD: ALL" >>  /etc/sudoers
 chmod  /app/

Ansible 配置清单Inventory

之后文章都是如下主机配置清单

 [yun@ansi-manager ansible_info]$ pwd
 /app/ansible_info
 [yun@ansi-manager ansible_info]$ cat hosts_key
 # 方式1、主机 + 端口 + 密钥
 [manageservers]
 172.16.1.180:

 [proxyservers]
 172.16.1.18[:]:

 # 方式2：别名 + 主机 + 端口 + 密码
 [webservers]
 web01 ansible_ssh_host=172.16.1.183 ansible_ssh_port=
 web02 ansible_ssh_host=172.16.1.184 ansible_ssh_port=
 web03 ansible_ssh_host=172.16.1.185 ansible_ssh_port=

ansible 定义变量的三种方式

1、命令行中定义，通过 -e EXTRA_VARS, --extra-vars=EXTRA_VARS 定义

2、在 playbook 的 yml 文件中定义

3、在 inventory 清单中定义

4、变量名可以有下划线，但不能有中横线。

优先级：命令行定义变量 > playbook定义变量 > inventory 定义变量

如下内容也是按照优先级从低到高写的，如果是为了测试优先级那么你可以直接按照如下步骤测验。

测验内容：在不同的位置定义相同的变量，但变量值不同，然后在阿里云镜像源下载不同版本的 zabbix rpm 包。

地址：https://mirrors.aliyun.com/zabbix/zabbix/

在 inventory 清单中定义

有三种定义方式：

1、直接在 inventory 清单文件中定义变量「了解即可，不推荐使用」

2、通过 group_vars 定义变量

3、通过 host_vars 定义变量

自身内部的优先级：host_vars/主机名【或别名】 定义变量 > group_vars/清单组名 定义变量 > group_vars/all 定义变量> inventory 文件中直接定义变量

在 inventory 清单文件中定义变量「了解」

 [yun@ansi-manager object02]$ pwd
 /app/ansible_info/object02
 [yun@ansi-manager object02]$ cat ../hosts_key
 # 方式1、主机 + 端口 + 密钥
 [manageservers]
 172.16.1.180:

 [proxyservers]
 172.16.1.18[:]:
 [proxyservers:vars]
 zabbix_version=2.2
 zabbix_rpm=zabbix-release-2.2-.el7.noarch.rpm
 ### ************ 定义变量如上

 # 方式2：别名 + 主机 + 端口 + 密码
 [webservers]
 web01 ansible_ssh_host=172.16.1.183 ansible_ssh_port=
 web02 ansible_ssh_host=172.16.1.184 ansible_ssh_port=
 web03 ansible_ssh_host=172.16.1.185 ansible_ssh_port=

 [yun@ansi-manager object02]$ cat test_vars.yml
 ---
 # 下载 zabbix rpm包
 - hosts: proxyservers

   tasks:
     - name: "download zabbix rpm"
       get_url:
         url: https://mirrors.aliyun.com/zabbix/zabbix/{{ zabbix_version }}/rhel/7/x86_64/{{ zabbix_rpm }}
         dest: /tmp/

 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key --syntax-check test_vars.yml  # 语法检测
 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key -C test_vars.yml  # 预执行，测试执行
 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key test_vars.yml  # 执行

然后就可以在目标机器 172.16.1.181、172.16.1.182 查看下载的 zabbix-release-2.2-1.el7.noarch.rpm 包了。

通过 group_vars 定义变量

注意事项：

1、要创建的 group_vars 目录要与 inventory 清单文件在同一个目录，或者与要执行的 playbook 的 yml 文件在同一个目录。

2、group_vars 目录下的文件名是 inventory 清单文件中的组名。或者文件名为 all「特殊组」，表示对所有机器主机生效。

在 group_vars/all 定义变量

 [yun@ansi-manager object02]$ pwd
 /app/ansible_info/object02
 [yun@ansi-manager object02]$ ll /app/ansible_info/
 total
 drwxrwxr-x  yun yun   Oct  : group_vars
 -rw-rw-r--  yun yun  Oct  : hosts_key
 drwxrwxr-x  yun yun   Oct  : object02
 [yun@ansi-manager object02]$ cat /app/ansible_info/group_vars/all   # all「特殊组」变量文件
 zabbix_version: 2.4
 zabbix_rpm: zabbix-release-2.4-.el7.noarch.rpm

 [yun@ansi-manager object02]$ cat test_vars.yml
 ---
 # 下载 zabbix rpm包
 - hosts: proxyservers

   tasks:
     - name: "download zabbix rpm"
       get_url:
         url: https://mirrors.aliyun.com/zabbix/zabbix/{{ zabbix_version }}/rhel/7/x86_64/{{ zabbix_rpm }}
         dest: /tmp/

 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key --syntax-check test_vars.yml  # 语法检测
 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key -C test_vars.yml  # 预执行，测试执行
 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key test_vars.yml  # 执行

然后就可以在目标机器 172.16.1.181、172.16.1.182 查看下载的 zabbix-release-2.4-1.el7.noarch.rpm 包了。

在 group_vars/组 定义变量

 [yun@ansi-manager object02]$ pwd
 /app/ansible_info/object02
 [yun@ansi-manager object02]$ ll /app/ansible_info/
 total
 drwxrwxr-x  yun yun   Oct  : group_vars
 -rw-rw-r--  yun yun  Oct  : hosts_key
 drwxrwxr-x  yun yun   Oct  : object02
 [yun@ansi-manager object02]$ cat /app/ansible_info/group_vars/proxyservers   # inventory 清单文件中的组名 变量文件
 zabbix_version: 3.0
 zabbix_rpm: zabbix-release-3.0-.el7.noarch.rpm

 [yun@ansi-manager object02]$ cat test_vars.yml
 ---
 # 下载 zabbix rpm包
 - hosts: proxyservers

   tasks:
     - name: "download zabbix rpm"
       get_url:
         url: https://mirrors.aliyun.com/zabbix/zabbix/{{ zabbix_version }}/rhel/7/x86_64/{{ zabbix_rpm }}
         dest: /tmp/

 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key --syntax-check test_vars.yml  # 语法检测
 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key -C test_vars.yml  # 预执行，测试执行
 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key test_vars.yml  # 执行

然后就可以在目标机器 172.16.1.181、172.16.1.182 查看下载的 zabbix-release-3.0-1.el7.noarch.rpm 包了。

通过 host_vars 定义变量

注意事项：

1、要创建的 host_vars 目录要与 inventory 清单文件在同一目录，或者与要执行的 playbook 的 yml 文件在同一个目录。

2、host_vars 目录下的文件名是 inventory 清单文件中的主机名或别名。如果有别名那么文件名为别名

 [yun@ansi-manager object02]$ pwd
 /app/ansible_info/object02
 [yun@ansi-manager object02]$ ll /app/ansible_info/
 total
 -rw-rw-r--  yun yun  Oct  : hosts_key
 drwxrwxr-x  yun yun   Oct  : host_vars
 drwxrwxr-x  yun yun   Oct  : object02
 [yun@ansi-manager object02]$ cat /app/ansible_info/host_vars/172.16.1.181    # inventory 清单文件中的主机名或别名 变量文件
 zabbix_version: 3.4
 zabbix_rpm: zabbix-release-3.4-.el7.noarch.rpm

 [yun@ansi-manager object02]$ cat test_vars.yml
 ---
 # 下载 zabbix rpm包
 - hosts: proxyservers

   tasks:
     - name: "download zabbix rpm"
       get_url:
         url: https://mirrors.aliyun.com/zabbix/zabbix/{{ zabbix_version }}/rhel/7/x86_64/{{ zabbix_rpm }}
         dest: /tmp/

 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key --syntax-check test_vars.yml  # 语法检测
 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key -C test_vars.yml  # 预执行，测试执行
 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key test_vars.yml  # 执行

然后就可以在目标机器 172.16.1.181 查看下载的 zabbix-release-3.4-2.el7.noarch.rpm 包了。

使用 playbook 定义变量

使用 playbook 定义变量有两种方式：

1、直接在要执行的 playbook 文件中定义变量。缺点是：这些变量无法与其他 playbook 共用。

2、将 playbook 中的变量抽出来，单独一个或多个文件 yml 文件。其他 playbook 文件要使用变量时，可以调用这些变量文件。好处是：可对变量集中管理，降低后期维护成本。「推荐使用」

自身内部优先级：playbook 引用文件变量 > 直接定义在要执行的 yml 文件中

直接在 playbook 中定义变量

变量写在要使用变量的 playbook 文件中。

 [yun@ansi-manager object02]$ pwd
 /app/ansible_info/object02
 [yun@ansi-manager object02]$ ll
 total
 -rw-rw-r--  yun yun  Oct  : test_vars.yml
 [yun@ansi-manager object02]$ cat test_vars.yml
 ---
 # 下载 zabbix rpm包
 - hosts: proxyservers
   # 变量定义
   vars:
     - zabbix_version: 3.5
     - zabbix_rpm: zabbix-release-3.5-.el7.noarch.rpm

   tasks:
     - name: "download zabbix rpm"
       get_url:
         url: https://mirrors.aliyun.com/zabbix/zabbix/{{ zabbix_version }}/rhel/7/x86_64/{{ zabbix_rpm }}
         dest: /tmp/

 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key --syntax-check test_vars.yml  # 语法检测
 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key -C test_vars.yml  # 预执行，测试执行
 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key test_vars.yml  # 执行

然后就可以在目标机器 172.16.1.181、172.16.1.182 查看下载的 zabbix-release-3.5-1.el7.noarch.rpm 包了。

playbook 引用变量文件

将 playbook 变量抽出来，使用单独的文件进行管理

 [yun@ansi-manager object02]$ pwd
 /app/ansible_info/object02
 [yun@ansi-manager object02]$ ll /app/ansible_info/
 total
 -rw-rw-r--  yun yun  Oct  : hosts_key
 drwxrwxr-x  yun yun   Oct  : object02
 -rw-rw-r--  yun yun   Oct  : playbood_vars.yml
 [yun@ansi-manager object02]$ cat /app/ansible_info/playbood_vars.yml  # 单独文件定义的变量
 zabbix_version: 4.0
 zabbix_rpm: zabbix-release-4.0-.el7.noarch.rpm

 [yun@ansi-manager object02]$ cat test_vars.yml
 ---
 # 下载 zabbix rpm包
 - hosts: proxyservers
   # 变量引用
   vars_files: ../playbood_vars.yml

   # 变量定义
   vars:
     - zabbix_version: 3.5
     - zabbix_rpm: zabbix-release-3.5-.el7.noarch.rpm

   tasks:
     - name: "download zabbix rpm"
       get_url:
         url: https://mirrors.aliyun.com/zabbix/zabbix/{{ zabbix_version }}/rhel/7/x86_64/{{ zabbix_rpm }}
         dest: /tmp/

 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key --syntax-check test_vars.yml  # 语法检测
 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key -C test_vars.yml  # 预执行，测试执行
 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key test_vars.yml  # 执行

然后就可以在目标机器 172.16.1.181、172.16.1.182 查看下载的 zabbix-release-4.0-1.el7.noarch.rpm 包了。

使用命令行定义变量

优先级别最高，但只是临时使用。

 [yun@ansi-manager object02]$ pwd
 /app/ansible_info/object02
 [yun@ansi-manager object02]$ ll
 total
 -rw-rw-r--  yun yun  Oct  : test_vars.yml
 [yun@ansi-manager object02]$ cat test_vars.yml
 ---
 # 下载 zabbix rpm包
 - hosts: proxyservers
   # 变量引用
   vars_files: ../playbood_vars.yml

   # 变量定义
   vars:
     - zabbix_version: 3.5
     - zabbix_rpm: zabbix-release-3.5-.el7.noarch.rpm

   tasks:
     - name: "download zabbix rpm"
       get_url:
         url: https://mirrors.aliyun.com/zabbix/zabbix/{{ zabbix_version }}/rhel/7/x86_64/{{ zabbix_rpm }}
         dest: /tmp/

 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key -e "zabbix_version=4.1 zabbix_rpm=zabbix-release-4.1-1.el7.noarch.rpm" --syntax-check test_vars.yml  # 语法检测
 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key -e "zabbix_version=4.1 zabbix_rpm=zabbix-release-4.1-1.el7.noarch.rpm" -C test_vars.yml  # 预执行，测试执行
 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key -e "zabbix_version=4.1 zabbix_rpm=zabbix-release-4.1-1.el7.noarch.rpm" test_vars.yml  # 执行

然后就可以在目标机器 172.16.1.181、172.16.1.182 查看下载的 zabbix-release-4.1-1.el7.noarch.rpm 包了。

多层级变量写法与引用

层级变量的写法与两种引用方式。

 [yun@ansi-manager object02]$ pwd
 /app/ansible_info/object02
 [yun@ansi-manager object02]$ ll /app/ansible_info/
 total
 -rw-rw-r--  yun yun  Oct  : hosts_key
 drwxrwxr-x  yun yun   Oct  : object02
 -rw-rw-r--  yun yun   Oct  : playbood_vars_mult.yml
 [yun@ansi-manager object02]$ cat /app/ansible_info/playbood_vars_mult.yml
 # 多层级变量书写
 zabbix_rpm_info:
   version: 4.2
   rpm: zabbix-release-4.2-.el7.noarch.rpm

 [yun@ansi-manager object02]$ cat test_vars_mult.yml  # 具体的 playbook 信息
 ---
 # 下载 zabbix rpm包
 - hosts: proxyservers
   # 变量引用
   vars_files: ../playbood_vars_mult.yml

   tasks:
     - name: "download zabbix rpm"
       get_url:
         # 下面写了两种方式引用变量，推荐使用后一种引用方式
         url: https://mirrors.aliyun.com/zabbix/zabbix/{{ zabbix_rpm_info.version }}/rhel/7/x86_64/{{ zabbix_rpm_info['rpm'] }}
         dest: /tmp/

 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key --syntax-check test_vars_mult.yml  # 语法检测
 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key -C test_vars_mult.yml  # 预执行，测试执行
 [yun@ansi-manager object02]$ ansible-playbook -b -i ../hosts_key test_vars_mult.yml  # 执行

然后就可以在目标机器 172.16.1.181、172.16.1.182 查看下载的 zabbix-release-4.2-1.el7.noarch.rpm 包了。

register 注册变量

如何使用 register 注册变量

 [yun@ansi-manager ansible_info]$ pwd
 /app/ansible_info
 [yun@ansi-manager ansible_info]$ ll
 total
 -rw-rw-r--  yun yun   Aug  : hosts_key
 -rw-rw-r--  yun yun   Aug  : test_debug_register.yml
 [yun@ansi-manager ansible_info]$ cat test_debug_register.yml
 ---
 # 如何使用 debug 模块与 register 变量
 - hosts: proxyservers

   tasks:
     - name: "get host port info"
       shell: netstat -lntp
       register: host_port

     - name: "print host port"
       debug:
         #msg: "{{ host_port }}"   # 输出全部信息
         #msg: "{{ host_port.cmd }}"   # 引用方式一
         msg: "{{ host_port['stdout_lines'] }}"  # 引用方式二

 [yun@ansi-manager ansible_info]$ ansible-playbook -b -i ./hosts_key test_debug_register.yml  # 执行

第一个 task 中，使用了 register 注册变量，名为 host_port ；当 shell 模块执行完毕后，会将数据放到该变量中。

第二给 task 中，使用了 debug 模块，并从 host_port 中获取数据。

---

———END———
如果觉得不错就关注下呗 (-^O^-) ！