对于任何自动管理工具而言，对于文件的管理都是其绕不开的话题。同样，ansible也围绕文件管理提供了众多的模块。同时还提供了Jinja2模板语法来配置文件模板。

常用文件管理模块

1. file

我们在讲ansible ad-hoc的时候，已经说过file模块，在playbook中的使用也没什么不同，下面给个简单的示例：

- name: Touch a file and set permissions

  file:

    path: /path/to/file

    owner: user1

    group: group1

    mode: 0640

    state: touch

2. synchronize

synchronize模块示例：

- name: synchronize local file to remote files

  synchronize:

    src: file

    dest: /path/to/file

3. copy

同样的，我们已经介绍过copy模块，示例如下：

- name: copy a file to managed hosts

  copy:

    src: file

    dest: /path/to/file

4. fetch

fetch模块与copy模块正好相反，copy是把主控端的文件复制到被控端，而fetch则是把被控端的文件复制到主控端。并且在主控端指定的目录下，以被控端主机名的形式来组织目录结构。

- name: Use the fetch module to retrieve secure log files

  hosts: all

  user: ansible

  tasks:

    - name: Fetch the /var/log/secure log file from managed hosts

      fetch:

        src: /var/log/secure

        dest: secure-backups

        flat: no

在主控端文件存储的目录树如下：

# tree  secure-backups/

secure-backups/

└── 10.1.61.187

    └── var

        └── log

            └── secure

3 directories, 1 file

参考：https://docs.ansible.com/ansible/latest/modules/fetch_module.html#fetch-module

5. lineinfile

lineinfile是一个非常有用的模块，而且相对来说，也是用法比较复杂的模块，可直接参考《Ansible lineinfile模块》

6. stat

stat模块与linux中的stat命令一样，用来显示文件的状态信息。

- name: Verify the checksum of a file

  stat:

    path: /path/to/file

    checksum_algorithm: md5

  register: result

- debug:

    msg: "The checksum of the file is {{ result.stat.checksum }}"

参考： https://docs.ansible.com/ansible/latest/modules/stat_module.html#stat-module

7. blockinfile

围绕着被标记的行插入、更新、删除一个文本块。

#cat files/test.html

<html>

  <head>

  </head>

  <body>

  </body>

</html>

#cat blockinfile_ex.yml

---

- name: blockinfile module test

  hosts: test

  tasks:

    - name: copy test.html to dest

      copy:

        src: files/test.html

        dest: /var/www/html/test.html

    - name: add block

      blockinfile:

        marker: "<!-- {mark} ANSIBLE MANAGED BLOCK -->"

        insertafter: "<body>"

        path: /var/www/html/test.html

        block: |

          <h1>Welcome to {{ ansible_hostname }}</h1>

          <p>Last updated on {{ ansible_date_time.iso8601 }}</p>

执行后结果如下：

[root@app html]# cat test.html

<html>

  <head>

  </head>

  <body>

<!-- BEGIN ANSIBLE MANAGED BLOCK -->

<h1>Welcome to app</h1>

<p>Last updated on 2019-05-28T15:00:03Z</p>

<!-- END ANSIBLE MANAGED BLOCK -->

  </body>

</html>

更多blockinfile用法参考：https://docs.ansible.com/ansible/latest/modules/blockinfile_module.html#blockinfile-module

Jinja2模板管理

Jinja2简介

Jinja2是基于python的模板引擎。那么什么是模板？

假设说现在我们需要一次性在10台主机上安装redis，这个通过playbook现在已经很容易实现。默认情况下，所有的redis安装完成之后，我们可以统一为其分发配置文件。这个时候就面临一个问题，这些redis需要监听的地址各不相同，我们也不可能为每一个redis单独写一个配置文件。因为这些配置文件中，绝大部分的配置其实都是相同的。这个时候最好的方式其实就是用一个通用的配置文件来解决所有的问题。将所有需要修改的地方使用变量替换，如下示例中redis.conf.j2文件：

daemonize yes

pidfile /var/run/redis.pid

port 6379

logfile "/var/log/redis/redis.log"

dbfilename dump.rdb

dir /data/redis

maxmemory 1G

bind {{ ansible_eth0.ipv4.address }} 127.0.0.1

timeout 300

loglevel notice

databases 16

save 900 1

save 300 10

save 60 10000

rdbcompression yes

maxclients 10000

appendonly yes

appendfilename appendonly.aof

appendfsync everysec

那么此时，redis.conf.j2文件就是一个模板文件。{{ ansible_eth0.ipv4.address }}是一个fact变量，用于获取被控端ip地址以实现替换。

在playbook中使用jinja2

现在我们有了一个模板文件，那么在playbook中如何来使用呢？

playbook使用template模块来实现模板文件的分发，其用法与copy模块基本相同，唯一的区别是，copy模块会将原文件原封不动的复制到被控端，而template会将原文件复制到被控端，并且使用变量的值将文件中的变量替换以生成完整的配置文件。

下面是一个完整的示例：

# cat config_redis.yml

- name: Configure Redis

  hosts: test

  tasks:

    - name: install redis

      yum:

        name: redis

        state: present

    - name: create data dir

      file:

        path: /data/redis

        state: directory

        recurse: yes

        owner: redis

        group: redis

    - name: copy redis.conf to dest

      template:

        src: templates/redis.conf.j2

        dest: /etc/redis.conf

      notify:

        - restart redis

    - name: start redis

      service:

        name: redis

        state: started

        enabled: yes

  handlers:

    - name: restart redis

      service:

        name: redis

        state: restarted

执行完成之后，我们可以看到被控端/etc/redis.conf配置文件如下：

daemonize yes

pidfile /var/run/redis.pid

port 6379

logfile "/var/log/redis/redis.log"

dbfilename dump.rdb

dir /data/redis

maxmemory 1G

bind 10.1.61.187 127.0.0.1

timeout 300

loglevel notice

databases 16

save 900 1

save 300 10

save 60 10000

rdbcompression yes

maxclients 10000

appendonly yes

appendfilename appendonly.aof

appendfsync everysec

关于template模块的更多参数说明：

backup：如果原目标文件存在，则先备份目标文件
dest：目标文件路径
force：是否强制覆盖，默认为yes
group：目标文件属组
mode：目标文件的权限
owner：目标文件属主
src：源模板文件路径
validate：在复制之前通过命令验证目标文件，如果验证通过则复制

Jinja2条件语句

在上面的示例中，我们直接取了被控节点的eth0网卡的ip作为其监听地址。那么假如有些机器的网卡是bond0，这种做法就会报错。这个时候我们就需要在模板文件中定义条件语句如下：

daemonize yes

pidfile /var/run/redis.pid

port 6379

logfile "/var/log/redis/redis.log"

dbfilename dump.rdb

dir /data/redis

maxmemory 1G

{% if ansible_eth0.ipv4.address %}

bind {{ ansible_eth0.ipv4.address }} 127.0.0.1

{% elif ansible_bond0.ipv4.address %}

bind {{ ansible_bond0.ipv4.address }} 127.0.0.1

{% else%}

bind 0.0.0.0

{% endif %}

timeout 300

loglevel notice

databases 16

save 900 1

save 300 10

save 60 10000

rdbcompression yes

maxclients 10000

appendonly yes

appendfilename appendonly.aof

appendfsync everysec

我们可以更进一步，让redis主从角色都可以使用该文件：

daemonize yes

pidfile /var/run/redis.pid

port 6379

logfile "/var/log/redis/redis.log"

dbfilename dump.rdb

dir /data/redis

maxmemory 1G

{% if ansible_eth0.ipv4.address %}

bind {{ ansible_eth0.ipv4.address }} 127.0.0.1

{% elif ansible_bond0.ipv4.address %}

bind {{ ansible_bond0.ipv4.address }} 127.0.0.1

{% else%}

bind 0.0.0.0

{% endif %}

{% if redis_slave is defined %}

slaveof {{ masterip }} {{ masterport|default(6379) }}

{% endif %}

{% if masterpass is defined %}

masterauth {{ masterpass }}

{% endif %}

{% if requirepass is defined %}

requirepass {{ requirepass }}

{% endif %}

timeout 300

loglevel notice

databases 16

save 900 1

save 300 10

save 60 10000

rdbcompression yes

maxclients 10000

appendonly yes

appendfilename appendonly.aof

appendfsync everysec

stop-writes-on-bgsave-error no

我们定义一个inventory如下：

[redis]

10.1.61.27 redis_slave=true masterip=10.1.61.187 masterpass=123456

10.1.61.187 requirepass=123456

Jinja2循环语句

定义一个inventory示例如下：

[proxy]

10.1.61.195

[webserver]

10.1.61.27

10.1.61.187

现在把proxy主机组中的主机作为代理服务器，安装nginx做反向代理，将请求转发至后面的两台webserver，即webserver组的服务器。

现在我们编写一个playbook如下：

#cat config_nginx.conf

- name: gather facts

  gather_facts: Fasle

  hosts: webserver

  tasks:

    - name: gather facts

      setup:

- name: Configure Nginx

  hosts: proxy

  tasks:

    - name: install nginx

      yum:

        name: nginx

        state: present

    - name: copy nginx.conf to dest

      template:

        src: templates/nginx.conf.j2

        dest: /etc/nginx/nginx.conf

      notify:

        - restart nginx

    - name: start nginx

      service:

        name: nginx

        state: started

        enabled: yes

  handlers:

    - name: restart nginx

      service:

        name: nginx

        state: restarted

模板文件 templates/nginx.conf.j2示例如下：

# cat nginx.conf.j2

user nginx;

worker_processes {{ ansible_processor_vcpus }};

error_log /var/log/nginx/error.log;

pid /var/run/nginx.pid;

include /usr/share/nginx/modules/*.conf;

events {

    worker_connections 65535;

    use epoll;

}

http {

    map $http_x_forwarded_for $clientRealIP {

        "" $remote_addr;

        ~^(?P<firstAddr>[0-9\.]+),?.*$ $firstAddr;

    }

    log_format  real_ip '{ "datetime": "$time_local", '

                        '"remote_addr": "$remote_addr", '

                        '"source_addr": "$clientRealIP", '

                        '"x_forwarded_for": "$http_x_forwarded_for", '

                        '"request": "$request_uri", '

                        '"status": "$status", '

                        '"request_method": "$request_method", '

                        '"request_length": "$request_length", '

                        '"body_bytes_sent": "$body_bytes_sent", '

                        '"request_time": "$request_time", '

                        '"http_referrer": "$http_referer", '

                        '"user_agent": "$http_user_agent", '

                        '"upstream_addr": "$upstream_addr", '

                        '"upstream_status": "$upstream_status", '

                        '"upstream_http_header": "$upstream_http_host",'

                        '"upstream_response_time": "$upstream_response_time", '

                        '"x-req-id": "$http_x_request_id", '

                        '"servername": "$host"'

                        ' }';

    access_log  /var/log/nginx/access.log  real_ip;

    sendfile            on;

    tcp_nopush          on;

    tcp_nodelay         on;

    keepalive_timeout   65;

    types_hash_max_size 2048;

    include             /etc/nginx/mime.types;

    default_type        application/octet-stream;

    include /etc/nginx/conf.d/*.conf;

    upstream web {

    {% for host in groups['webserver'] %}

        {% if hostvars[host]['ansible_bond0']['ipv4']['address'] is defined %}

        server {{ hostvars[host]['ansible_bond0']['ipv4']['address'] }};

        {% elif hostvars[host]['ansible_eth0']['ipv4']['address'] is defined %}

        server {{ hostvars[host]['ansible_eth0']['ipv4']['address'] }};

        {% endif %}

    {% endfor %}

    }

    server {

        listen       80 default_server;

        server_name  _;

        location / {

            proxy_pass http://web;

        }

    }

}

下面再给一个域名解析服务bind的配置文件 named.conf的jinja2模板示例：

options {

listen-on port 53 {

127.0.0.1;

{% for ip in ansible_all_ipv4_addresses %}

{{ ip }};

{% endfor %}

};

listen-on-v6 port 53 { ::1; };

directory "/var/named";

dump-file "/var/named/data/cache_dump.db";

statistics-file "/var/named/data/named_stats.txt";

memstatistics-file "/var/named/data/named_mem_stats.txt";

};

zone "." IN {

type hint;

file "named.ca";

};

include "/etc/named.rfc1912.zones";

include "/etc/named.root.key";

{# Variables for zone config #}

{% if 'authorativenames' in group_names %}

{% set zone_type = 'master' %}

{% set zone_dir = 'data' %}

{% else %}

{% set zone_type = 'slave' %}

{% set zone_dir = 'slaves' %}

{% endif %}

zone "internal.example.com" IN {

type {{ zone_type }};

file "{{ zone_dir }}/internal.example.com";

{% if 'authorativenames' not in group_names %}

masters { 192.168.2.2; };

{% endif %}

};

Jinja2过滤器

1. default过滤器

简单示例：

"Host": "{{ db_host | default('lcoalhost') }}"

2. 应用于注册变量的过滤器

正常情况下，当某个task执行失败的时候，ansible会中止运行。此时我们可以通过ignore_errors来捕获异常以让task继续往下执行。然后调用debug模块打印出出错时的内容，拿来错误结果后，主动失败。

- name: Run myprog

  command: /opt/myprog

  register: result

  ignore_errors: True

- debug:

    var: result

- debug:

    msg: "Stop running the playbook if myprog failed"

    failed_when: result|failed

任务返回值过滤器：

failed：如果注册变量的值是任务failed则返回True
changed: 如果注册变量的值是任务changed则返回True
success：如果注册变量的值是任务succeeded则返回True
skipped：如果注册变量的值是任务skipped则返回True

3. 应用于文件路径的过滤器

basename：返回文件路径中的文件名部分
dirname：返回文件路径中的目录部分
expanduser：将文件路径中的~替换为用户目录
realpath：处理符号链接后的文件实际路径

下面是一个示例：

- name: test basename

  hosts: test

  vars:

    homepage: /usr/share/nginx/html/index.html

  tasks:

    - name: copy homepage

      copy:

        src: files/index.html

        dest: {{ homepage }}

可以通过basename改写成如下方式：

- name: test basename

  hosts: test

  vars:

    homepage: /usr/share/nginx/html/index.html

  tasks:

    - name: copy homepage

      copy:

        src: files/{{ homepage | basename }}

        dest: {{ homepage }}

4. 自定义过滤器

举个简单的例子，现在有一个playbook如下：

- name: test filter

  hosts: test

  vars:

    domains: ["www.example.com","example.com"]

  tasks:

    template:

      src: templates/test.conf.j2

      dest: /tmp/test.conf

templates/test.conf.j2如下：

hosts = [{{ domains | join(',') }}]

执行playbook后，在目标机上的test.conf如下：

hosts = [www.example.com,example.com]

现在如果希望目标机上的test.conf文件返回结果如下：

hosts = ["www.example.com","example.com"]

没有现成的过滤器来帮我们做这件事情。我们可以自己简单写一个surround_by_quote.py内容如下：



# 定义过滤器执行的操作

def surround_by_quote(a_list):

  return ['"%s"' % an_element for an_element in a_list]

class FilterModule(object):

  def filters(self):

    return {'surround_by_quote': surround_by_quote}

我们需要开启ansible.cfg的配置项：

filter_plugins     = /usr/share/ansible/plugins/filter

将刚刚编写的代码文件放入/usr/share/ansible/plugins/filter目录下，然后修改templates/test.conf.j2如下：

hosts = [{{ domains | join(',') }}]

再次执行playbook，最后返回结果：

hosts = ["www.example.com","example.com"]

关于jinja2更多用法参考：http://docs.jinkan.org/docs/jinja2/

Ansible15：文件管理模块及Jinja2过滤器的更多相关文章

自定义jinja2 过滤器
今天,我们要讲的是自定义jinja2 过滤器这个知识点,因为官方文档对此一代而过,讲得不够清楚,所以我们专门拿出来讲一下. 例子例子写了两个自定义过滤器,一个是转换字典到字符串的过滤器,一个是返回当 ...
Python模块学习 - jinja2
模板要了解jinja2,那么需要先理解模板的概念.模板在Python的web开发中广泛使用,它能够有效的将业务逻辑和页面逻辑分开,使代码可读性增强.并且更加容易理解和维护. 模板简单来说就是一个其中 ...
SaltStack配置管理之状态模块和jinja2（五）
官方文档 https://docs.saltstack.com/en/latest/topics/states/index.html 配置管理之SLS Salt State SLS描述文件(YAM ...
Python3 学习第九弹：模块学习二之文件管理模块
os模块提供访问操作系统的接口 1> name 获得当前操作系统其中 'nt' 是 windows 'posix' 是 linux 2> environ 获得当前系统的环境变量的字典, ...
Flask 页面缓存逻辑,jinja2 过滤器，测试器
回调接入点-页面缓存逻辑 from flask import Flask,request,render_template from werkzeug.contrib.cache import Simp ...
python模块之jinja2 ，shutil
一 jinja2 用来给python提供html语法的模块安装 pip install jinja2 使用 from jinja2 import Template def html_output(p ...
flask的jinja2过滤器使用：遍历索引指定标签class属性，实现样式变化
在flask项目中实现上图效果,采用使用自定义过滤器的形式对 span 标签的 class 指定. 1.定义过滤器 # common.py def do_index_class(index): &qu ...
Docker+Cmd+Cli+Git之前端工程化纪要（二）自定义类package.json文件管理模块包
全新升级后的FE工作流为:使用FE命令包进行项目的初始化,其中包括项目初始化.拉取脚手架.私库拉取模块包或后期扩展的CI/CD等与本公司工作流相关的操作. 出现的问题如下: 脚手架工具的包依赖信息存放 ...
008.Ansible文件管理模块
一 stat模块检查文件状态使用,模块获取文件的状态等信息,类似与linux中的STAT命令可以用来获取文件的属主.可读/写.文件状态等信息 [root@node1 ansible]# stat ...

随机推荐

python计算不规则图形面积算法
介绍:大三上做一个医学影像识别的项目,医生在原图上用红笔标记病灶点,通过记录红色的坐标位置可以得到病灶点的外接矩形,但是后续会涉及到红圈内的面积在外接矩形下的占比问题,有些外接矩形内有多个红色标记,在 ...
php CI如何实现全站静态生成html，动态创建目录
php CI如何实现全站静态生成html,动态创建目录CodeIgniter框架生成HTML的方法 public function out_html($code) { $data['articles' ...
ztree选父不选子选子不选父
var setting = { data: { simpleData: { enable: true } } ,check: { enable: true , chkStyle: 'checkbox' ...
c++的explicit理解
默认规定只有一个参数的构造函数也定义了一个隐式转换,将该构造函数对应数据类型的数据转换为该类对象 explicit class A { explicit A(int n); A(char *p); ...
log4j每天生成一个文件配置
log4j.rootLogger=INFO,CONSOLE,logDailyFile log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppenderlo ...
vs解决方案文件出错
问题描述: 电脑死机,重启电脑后打开解决方案,提示“选择的文件不是有效的解决方案文件” 解决方案: 1. 先用记事本打开这个解决方案查看下,发现其中内容变成空白了? 2. 打开项目中的xxxx.vcx ...
python-新建文件夹
import tensorflow as tf import os categories = ['folder1', 'folder2'] for folderName in categories: ...
莫烦TensorFlow_03 Variable加法
import tensorflow as tf ## 定义变量 state = tf.Variable(0, name = 'counter') #print(state.name) one = tf ...
python27期day04：列表、元组、range、作业题。
1.for循环套for循环: for i in "abc": for x in "egf: print(x) 结果是:e g f e g f e g f 2.99乘法表 ...
eclipse集成maven（四）
一.配置maven 打开Window-Preference-Maven,我们可以看到,默认是使用Eclipse的,不是我们要的maven,可以在Installations中,点击"Add&q ...

Ansible15：文件管理模块及Jinja2过滤器