写点什么

ansible 模块:blockinfile

作者:ghostwritten
  • 2022 年 5 月 11 日
  • 本文字数:2054 字

    阅读完需:约 7 分钟

ansible 模块:blockinfile

1. 简介

blockinfile 是 Ansible 的一个非常实用的模块,和单行替换模块 lineinfile 类似,但是可以帮助我们在文件中插入一段文本。

2. 常用参数

  • path 参数:必须指定的参数。和 file 模块的 path 参数一样,指定要操作的文件。别名:dest, destfile, name。

  • state 参数:确保段落存在(state=present)或者不存在(state=absent)。默认值为state=present,会将指定的一段文本插入到文件中,如果文件中已经存在标记的文本,默认会更新对应段落。如果state=absent,则表示从文件中删除对应标记的段落。

  • marker 参数:默认值"# {mark} ANSIBLE MANAGED BLOCK"。我们想要在指定文件中插入一段文本,Ansible 会自动为这段文本添加两个标记,一个开始标记,一个结束标记,默认情况下,开始标记为# BEGIN ANSIBLE MANAGED BLOCK,结束标记为# END ANSIBLE MANAGED BLOCK。我们可以使用 marker 参数自定义标记,比如marker = #{mark}test,这样开始标记变成了# BEGIN test,结束标记变成了# END test{mark}变量会自动被替换成开始标记中的 marker_begin 和结束标记中的 marker_end,如果使用没有{mark}变量的自定义标记,可能会导致重复插入。

  • marker_begin 参数:设置 marker 参数的开始标记中的{mark}变量。默认值"BEGIN"。

  • marker_end 参数:设置 marker 参数的结束标记中的{mark}变量。默认值"END"。

  • block 参数:指定一段需要操作的文本。如果没有 block 参数或者参数的值为空,则移除文本块,效果等同于state = absent。别名:content。

  • insertafter 参数:插入段落(state=present)时使用。值为 EOF 或者正则表达式,默认值为 EOF,表示End Of File,插入到文件的末尾。如果设置为正则表达式,默认将文本插入到正则表达式匹配的最后一行之后。如果设置为正则表达式,但是没有匹配到任何行,则插入到文件末尾。

  • insertbefore 参数:插入段落(state=present)时使用。值为BOF或者正则表达式,默认值为 BOF,表示Begin Of File,插入到文件的开头。如果设置为正则表达式,默认将文本插入到正则表达式匹配的最后一行之前。如果设置为正则表达式,但是没有匹配到任何行,则插入到文件开头。

  • validate 参数:修改文件之前进行校验。使用“%s”表示 path 参数指定的需要修改的文件。

  • file模块的所有参数,常用的有:backup:是否在修改文件之前对文件进行备份。create :yes:当要操作的文件不存在时,创建对应的文件;默认为 no:当要操作的文件不存在时,语句报错。mode:文件的属性。owner:文件的属主。group:文件的属组。

3. 示例

3.1 修改 SSHD 配置文件禁止 ansible-agent 用户使用密码登录:

- name: Insert/Update "Match User" configuration block in /etc/ssh/sshd_config  blockinfile:    path: /etc/ssh/sshd_config    block: |      Match User ansible-agent      PasswordAuthentication no
复制代码

3.2 在 Debian/Ubuntu 网络配置文件/etc/network/interfaces 中添加网卡 eth0 的配置信息:

- name: Insert/Update eth0 configuration stanza in /etc/network/interfaces        (it might be better to copy files into /etc/network/interfaces.d/)  blockinfile:    path: /etc/network/interfaces    block: |      iface eth0 inet static          address 192.0.2.23          netmask 255.255.255.0
复制代码

3.3 备份/etc/ssh/ssh_config 文件,并在文件末尾插入./local/ssh_config 文件的内容,最后使用/usr/sbin/sshd -T -f /etc/ssh/ssh_config 命令校验:

- name: Insert/Update configuration using a local file and validate it  blockinfile:    block: "{{ lookup('file', './local/ssh_config') }}"    dest: /etc/ssh/ssh_config    backup: yes    validate: /usr/sbin/sshd -T -f %s
复制代码

3.4 在 HTML 文件/var/www/html/index.html 的"<body>"之后插入自定义标记的内容:

- name: Insert/Update HTML surrounded by custom markers after <body> line  blockinfile:    path: /var/www/html/index.html    marker: "<!-- {mark} ANSIBLE MANAGED BLOCK -->"    insertafter: "<body>"    block: |      <h1>Welcome to {{ ansible_hostname }}</h1>      <p>Last updated on {{ ansible_date_time.iso8601 }}</p>
复制代码

3.5 移除在 HTML 文件/var/www/html/index.html 中的添加的内容:

- name: Remove HTML as well as surrounding markers  blockinfile:    path: /var/www/html/index.html    marker: "<!-- {mark} ANSIBLE MANAGED BLOCK -->"    block: ""
复制代码

3.6 在/etc/hosts 文件中添加解析记录:

- name: Add mappings to /etc/hosts  blockinfile:    path: /etc/hosts    block: |      {{ item.ip }} {{ item.name }}    marker: "# {mark} ANSIBLE MANAGED BLOCK {{ item.name }}"  with_items:  - { name: host1, ip: 10.10.1.10 }  - { name: host2, ip: 10.10.1.11 }  - { name: host3, ip: 10.10.1.12 }
复制代码


发布于: 刚刚阅读数: 2
用户头像

ghostwritten

关注

改变中国 2018.11.14 加入

虚心好学,勤奋努力,为中华之崛起而读书。

评论

发布
暂无评论
ansible 模块:blockinfile_ansible_ghostwritten_InfoQ写作社区