ansible.builtin.subversion – Развертывание репозитория subversion
Примечание
Этот модуль входит в состав ansible-base и включён во все установки Ansible. В большинстве случаев, вы можете использовать короткое имя модуля subversion, даже без указания ключевого слова collections:. Несмотря на это, рекомендуется использовать полное имя для лёгкой ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.
Новое в версии 0.7: из ansible.builtin
Описание
- Развертывает указанную репозиторию URL / ревизию в dest. Если dest существует, обновляет до указанной ревизии, в противном случае выполняет checkout.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- subversion (инструмент командной строки с
svnточкой входа)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| checkout boolean добавлен в 2.3 ansible.builtin |
| Если no, не выполнять checkout репозитория, если он не существует локально. |
| dest путь | Абсолютный путь, где должна быть развернута репозитория. Директория назначения должна быть указана, если не указаны checkout=no, update=no и export=no. | |
| executable путь добавлен в 1.4 ansible.builtin | Путь к исполняемому файлу svn. Если не указан, будет использоваться стандартный механизм разрешения путей к бинарным файлам. | |
| export boolean добавлен в 1.6 ansible.builtin |
| Если yes, выполнить экспорт вместо checkout/update. |
| force boolean |
| Если yes, изменённые файлы будут проигнорированы. Если no, модуль завершится с ошибкой, если обнаружит изменённые файлы. До версии 1.9 значение по умолчанию было yes. |
| in_place boolean добавлен в 2.6 ansible.builtin |
| Если директория существует, рабочая копия будет создана поверх существующей с помощью svn checkout --force; если указан force, то существующие файлы с другим содержимым будут восстановлены. |
| password строка | --password параметр, передаваемый svn, если svn имеет версию меньше 1.10.0. Это небезопасно, и пароль будет просочен в argv.--password-from-stdin параметр, если svn имеет версию 1.10.0 или выше. | |
| repo строка / обязательно | URL репозитория subversion. псевдонимы: name, repository | |
| revision строка | Значение по умолчанию: "HEAD" | Конкретная ревизия для checkout. псевдонимы: rev, version |
| switch boolean добавлен в 2.0 ansible.builtin |
| Если no, не вызывать svn switch перед обновлением. |
| update boolean добавлен в 2.3 ansible.builtin |
| Если no, не получать новые ревизии из исходного репозитория. |
| username строка | --username параметр, передаваемый svn. | |
| validate_certs boolean добавлен в 2.11 ansible.builtin |
| Если no, передаёт --trust-server-cert флаг в svn.Если yes, флаг не передаётся. |
Примечания
Примечание
- Этот модуль не обрабатывает externals.
- Поддерживает
check_mode.
Примеры
- name: Checkout subversion repository to specified folder
ansible.builtin.subversion:
repo: svn+ssh://an.example.org/path/to/repo
dest: /src/checkout
- name: Export subversion directory to folder
ansible.builtin.subversion:
repo: svn+ssh://an.example.org/path/to/repo
dest: /src/export
export: yes
- name: Get information about the repository whether or not it has already been cloned locally
ansible.builtin.subversion:
repo: svn+ssh://an.example.org/path/to/repo
dest: /src/checkout
checkout: no
update: no
Авторы
- Dane Summers (@dsummersl) <njharman@gmail.com>
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/builtin/subversion_module.html
