saltstack-jinja2模板-进阶3

什么是Jinja2

Jinja2 是一个 Python 的功能齐全的模板引擎。
它有完整的 unicode 支持，一个可选的集成沙箱执行环境，被广泛使用，以 BSD 许可证授权。

salt使用Jinja2模板

SaltStack 是使用YAML语言来将sls文件解释成它自己可以识别的内容，Jinja 是一种基于Python的模板引擎，
在sls文件里可以直接使用 Jinja 模板来做一些操作。

比如当我们需要对多台服务器做一些 Apache 服务配置时，由于每台服务器信息不一样（比如 IP 不同），
如果为每台服务器去创建 SLS 文件就不太合理，而通过 Jinja 模板则可以用生成变量→读取变量的方式来为每个服务器设置应有的信息。

salt使用jinja2模板的三步骤

1. 告诉file模块，要使用jinja
2. 列出参数列表
如下：
apache-config:
  file.managed:
    - name: /etc/httpd/conf/httpd.conf
    - source: salt://lamp/files/httpd.conf
    - user: root
    - group: root
    - mode: 644
    - template: jinja      # 1. 增加这行表示开启jinja模板
    - defaults:            # 2. 下面设定变量的值
      PORT: 88
      
3. 文件中模板变量的引用
   模板里面支持 salt/grains/pillar 进行变量赋值

Jinja2模板的基本使用

1. 首先修改源文件中需要引用变量的内容。
   比如: 只修改Apache的端口，需要修改httpd.conf文件中将Listen 80 为Listen {{ PORT }}

2. 对sls文件进行编辑以定义模板并且给变量赋值，vim apache-config.sls

apache-config:
  file.managed:
    - name: /etc/httpd/conf/httpd.conf
    - source: salt://files/httpd.conf
    - user: root
    - group: root
    - mode: 644
    - template: jinja
    - defaults:
      PORT: 8080
      
      
3. 执行salt命令：salt \* state.sls apache-config
   结果输出如下：
   ......
   #Listen 12.34.56.78:80
   -Listen 80 
   +Listen 8080
   ......
   
   说明端口已经修改成功！

Jinja2模板的高级使用–监听 “IP:端口” 形式

在基本使用中由于修改的是端口，端口信息一般是固定的，如果想要修改的信息是每个 minion 自身的 IP 就没办法设置一个通用的信息了， 这个时候需要通过其他方法来获取 minion 相关信息，这里可以使用 Grains 、Pillar 和执行模块三个方法来获取。

• 用Grains举例

1. 首先修改源文件中需要引用变量的内容。
   比如: 只修改Apache的端口，需要修改httpd.conf文件中将Listen 80 为
   Listen {{ IPADDR }}:{{ PORT }}

2. 对sls文件进行编辑以定义模板并且给变量赋值，vim apache-config.sls

apache-config:
  file.managed:
    - name: /etc/httpd/conf/httpd.conf
    - source: salt://files/httpd.conf
    - user: root
    - group: root
    - mode: 644
    - template: jinja
    - defaults:
      PORT: 8080
      IPADDR: {{ grains['fqdn_ip4'][0] }}
      
3. 执行salt命令：salt \* state.sls apache-config
   ......
    #Listen 12.34.56.78:80
    -Listen 8080
    +Listen 192.168.56.22:80
    
    出现此类信息说明执行成功！

上面的例子中： IPADDR: {{ grains['fqdn_ip4'][0] }}

注：[fqdn_ip4]代表的是IP，该信息需要先执行 salt '*' grains.items 查询，由于grains查询输出的是列表，会有多个值，需要加上[0]代表取第一个值

另外一点，所有minion节点需要修改/etc/hosts把本机IP地址与主机名正确对应填写，否则执行报错

附录：在master上查看minion的grains值

salt \* grains.ls       #列出grains的所有key
salt \* grains.get app  # 查看grains中的app信息
salt \* grains.get os   #查看grains中的os信息
salt \* grains.get ipv4 #查看grains的ipv4信息
salt \* grains.get mem_total  #查看grains中的总内存信息
......      #只要是grains.ls所列出的项，均可以使用salt \* grains.get命令获取

salt \* grains.items    # 查看所有“树形列出”的grains信息
salt '*' grains.item os # 获取操作系统名称
salt '*' grains.item fqdn_ip4  #查看物理网卡IP地址
salt \* grains.setval hello world    #在master上给minion设置grain键值对

• 本文作者： GaryWu
• 本文链接： https://garywu520.github.io/2017/10/19/saltstack-jinja2模板-进阶3/
• 版权声明： 本博客所有文章除特别声明外，均采用 MIT 许可协议。转载请注明出处！