ansible.builtin.patch (v2.5.12) — module

Install Ansible via pip

Install with pip install ansible==2.5.12

Description

Apply patch files using the GNU patch tool.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Apply patch to one file
  patch:
    src: /tmp/index.html.patch
    dest: /var/www/index.html

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Apply patch to multiple files under basedir
  patch:
    src: /tmp/customize.patch
    basedir: /var/www
    strip: 1

Inputs

    
src:
    aliases:
    - patchfile
    description:
    - Path of the patch file as accepted by the GNU patch tool. If C(remote_src) is 'no',
      the patch source file is looked up from the module's I(files) directory.
    required: true

dest:
    aliases:
    - originalfile
    description:
    - Path of the file on the remote machine to be patched.
    - The names of the files to be patched are usually taken from the patch file, but
      if there's just one file to be patched it can specified with this option.

strip:
    default: 0
    description:
    - Number that indicates the smallest prefix containing leading slashes that will be
      stripped from each file name found in the patch file. For more information see the
      strip parameter of the GNU patch tool.

backup:
    choices:
    - 'no'
    - 'yes'
    default: 'no'
    description:
    - Passes C(--backup --version-control=numbered) to patch, producing numbered backup
      copies.
    version_added: '2.0'
    version_added_collection: ansible.builtin

binary:
    choices:
    - 'no'
    - 'yes'
    default: 'no'
    description:
    - Setting to C(yes) will disable patch's heuristic for transforming CRLF line endings
      into LF. Line endings of src and dest must match. If set to C(no), C(patch) will
      replace CRLF in C(src) files on POSIX.
    version_added: '2.0'
    version_added_collection: ansible.builtin

basedir:
    description:
    - Path of a base directory in which the patch file will be applied. May be omitted
      when C(dest) option is specified, otherwise required.

remote_src:
    choices:
    - 'no'
    - 'yes'
    default: 'no'
    description:
    - If C(no), it will search for src at originating/master machine, if C(yes) it will
      go to the remote/target machine for the C(src).