ansible.posix.patch – Применение патчей с помощью инструмента GNU patch

Примечание

Этот плагин является частью коллекции ansible.posix (версия 1.1.1).

Для его установки используйте: ansible-galaxy collection install ansible.posix

Для использования в плейбуке укажите: ansible.posix.patch

Новое в версии 1.0.0: ansible.posix

Обзор
Параметры
Примечания
Примеры

Обзор

Применение патчей с помощью инструмента GNU patch.

Примечание

У данного модуля есть соответствующий плагин действий.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
backup boolean	Варианты: no ← yes	Передает `--backup --version-control=numbered` команде patch, создавая пронумерованные резервные копии.
basedir путь		Путь к базовому каталогу, в котором будет применен патч. Может быть опущен, когда указан параметр `dest`, в противном случае обязателен.
binary boolean	Варианты: no ← yes	Установив значение `yes`, отключите эвристику patch для преобразования CRLF в LF. Кодировки src и dest должны совпадать. Если установлено `no`, `patch` заменит CRLF в `src` файлах на POSIX.
dest путь		Путь к файлу на удалённой машине, который необходимо подвергнуть патчингу. Имена файлов для патчинга обычно берутся из файла патча, но если нужно обработать только один файл, его можно указать с помощью этого параметра. псевдонимы: originalfile
ignore_whitespace boolean	Варианты: no ← yes	Установив значение `yes`, игнорируются изменения пробелов между патчем и исходным файлом.
remote_src boolean	Варианты: no ← yes	Если `no`, он будет искать исходный файл на машине-источнике/контроллере. Если `yes`, он обратится к удалённой/целевой машине для `src`.
src путь / обязательно		Путь к файлу патча, принимаемому инструментом GNU patch. Если `remote_src` равно 'no', файл исходного патча ищется в каталоге files модуля. псевдонимы: patchfile
state строка	Варианты: absent present ←	Нужно ли применить или отменить патч.
strip целое число	Значение по умолчанию: 0	Число, которое указывает минимальную длину префикса, содержащего ведущие косые черты, которые будут удалены из каждого имени файла, найденного в файле патча. Для получения дополнительной информации см. параметр strip инструмента GNU patch.

Примечания

Примечание

Данному модулю требуется утилита GNU patch, установленная на удалённом хосте.

Примеры

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

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

- name: Revert patch to one file
  ansible.posix.patch:
    src: /tmp/index.html.patch
    dest: /var/www/index.html
    state: absent

Авторы

Jakub Jirutka (@jirutka)
Luis Alberto Perez Lazaro (@luisperlaz)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/ansible/posix/patch_module.html