Ansible

Ansible version : 2.6.2

常用模块（一）

文件操作模块

• acl
• archive
• assemble
• blockinfile
• copy
• fetch
• file
• find
• ini_file
• iso_extract
• lineinfile
• patch
• replace
• stat
• synchronize
• tempfile
• template
• unarchive
• xattr
• xml

模块：file

概要

设置文件、symlinks和目录的属性，或删除文件/symlinks/目录。许多其他模块支持与[file]模块相同的选项—包括[copy]、[template]和[assemble]。对于Windows主机，使用[win_file]模块。

参数

例子

ad-hoc

创建文件（指定权限）

ansible localhost -m file -a 'dest=/tmp/testdir.txt mode=0644 state=touch'

创建目录（指定用户、组、权限）

ansible localhost -m file -a 'dest=/tmp/testdir3 mode=0644 state=directory owner=luoshen group=luoshen' 

playbook

修改所属用户、组、权限。如果mode使用8进制，首位必须为0.

- file:
    path: /etc/foo.conf
    owner: foo
    group: foo
    mode: 0644
- file:
    src: /file/to/link/to
    dest: /path/to/symlink
    owner: foo
    group: foo
    state: link
- file:
    src: '/tmp/{{ item.src }}'
    dest: '{{ item.dest }}'
    state: link
  with_items:
    - { src: 'x', dest: 'y' }
    - { src: 'z', dest: 'k' }

创建文件（指定权限）

- file:
    path: /etc/foo.conf
    state: touch
    mode: "u=rw,g=r,o=r"

修改已有文件权限

- file:
    path: /etc/foo.conf
    state: touch
    mode: "u+rw,g-wx,o-rwx"

如果目录不存在，则创建

- file:
    path: /etc/some_directory
    state: directory
    mode: 0755

模块：copy

概要

[copy]模块将文件从本地或远程计算机复制到远程计算机上的某个位置。 使用[fetch]模块将文件从远程位置复制到本地。如果需要在复制的文件中进行变量插值，使用[template]模块。 对于Windows，采用[win_copy]模块。

参数

注意

• [copy]模块递归复制大量规模(超过数百个)文件，不会很方便。作为替代品，我们可以使用封装了rsync的[synchronize]模块。
• 对于windows主机，使用[win_copy]代替。

例子

ad-hoc

指定预期的校验值

ansible localhost -m copy -a "src=1.py dest=/tmp/ checksum=bbe26b84e40cfb01ac6f1395260b55afedf641b7"

复制内容到目标服务器

ansible localhost -m copy -a 'content="this is test text." dest=/tmp/test.txt'

playbook

复制文件（指定权限、用户、组）

- name: example copying file with owner and permissions
  copy:
    src: /srv/myfiles/foo.conf
    dest: /etc/foo.conf
    owner: foo
    group: foo
    mode: 0644

复制文件，如果不一样则先备份后复制

- name: Copy a new "ntp.conf file into place, backing up the original if it differs from the copied version
  copy:
    src: /mine/ntp.conf
    dest: /etc/ntp.conf
    owner: root
    group: root
    mode: 0644
    backup: yes

在安全验证之后，复制文件

- name: Copy a new "sudoers" file into place, after passing validation with visudo
  copy:
    src: /mine/sudoers
    dest: /etc/sudoers
    validate: /usr/sbin/visudo -cf %s

在安全验证之后，源文件来自目标服务器，复制文件。

- name: Copy a "sudoers" file on the remote machine for editing
  copy:
    src: /etc/sudoers
    dest: /etc/sudoers.edit
    remote_src: yes
    validate: /usr/sbin/visudo -cf %s

复制内容到目标服务器，如果有内容会覆盖

- name: Copy using the 'content' for inline data
  copy:
    content: '# This file was moved to /etc/other.conf'
    dest: /etc/mine.conf'

模块：template

概要

template模块是用来处理jinja语法的。6个额外的变量可以在template使用。

参数

例子

ansible playbook

- template:
    src: /mytemplates/foo.j2
    dest: /etc/file.conf
    owner: bin
    group: wheel
    mode: 0644

symbolic模式的ansible playbook

- template:
    src: /mytemplates/foo.j2
    dest: /etc/file.conf
    owner: bin
    group: wheel
    mode: "u=rw,g=r,o=r"

从template创建ini格式文件

- template:
    src: config.ini.j2
    dest: /share/windows/config.ini
    newline_sequence: '\r\n'

sshd配置安全升级，避免自己锁定退出

- template:
    src: etc/ssh/sshd_config.j2
    dest: /etc/ssh/sshd_config
    owner: root
    group: root
    mode: '0600'
    validate: /usr/sbin/sshd -t -f %s
    backup: yes