hg - Управляет репозиториями Mercurial (hg)
Описание
- Управляет репозиториями Mercurial (hg). Поддерживает SSH, HTTP/S и локальные адреса.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| clone (добавлено в 2.3) |
| Если no, не клонировать репозиторий, если он не существует локально. |
| dest обязательно | Абсолютный путь, куда должен быть клонирован репозиторий. Этот параметр обязателен, если clone и update не установлены в значение no. | |
| executable (добавлено в 1.4) | Путь к исполняемому файлу hg. Если не указан, будет использоваться стандартный механизм поиска бинарных файлов. | |
| force |
| Отбрасывает несохраненные изменения. Выполняет hg update -C. До версии 1.9 значение по умолчанию было `да`. |
| purge |
| Удаляет не отслеживаемые файлы. Выполняет hg purge. |
| repo обязательно | Адрес репозитория. псевдонимы: имя | |
| revision | Эквивалентный параметр -r в команде hg, который может быть хешем коммита, номером ревизии, именем ветки или тегом.псевдонимы: версия | |
| update (добавлено в 2.0) |
| Если no, не получать новые ревизии из исходного репозитория. |
Примечания
Примечание
- Этот модуль не поддерживает функцию push. См. https://github.com/ansible/ansible/issues/31156.
- Если задача зависает, сначала проверьте, доступен ли удаленный хост в
known_hosts. SSH запросит у пользователя разрешение на первый контакт с удаленным хостом. Чтобы избежать этого запроса, можно добавить открытый ключ удаленного хоста в/etc/ssh/ssh_known_hostsперед вызовом модуля hg следующей командой: ssh-keyscan remote_host.com >> /etc/ssh/ssh_known_hosts. - По состоянию на 01 декабря 2018 года Bitbucket прекратил поддержку подключений TLSv1 и TLSv1.1. Вследствие этого, если используемая система всё ещё использует версию Python ниже 2.7.9, могут возникнуть проблемы с проверкой репозиториев Bitbucket. См. https://bitbucket.org/blog/deprecating-tlsv1-tlsv1-1-2018-12-01.
Примеры
- name: Ensure the current working copy is inside the stable branch and deletes untracked files if any.
hg:
repo: https://bitbucket.org/user/repo1
dest: /home/user/repo1
revision: stable
purge: yes
- name: Get information about the repository whether or not it has already been cloned locally.
hg:
repo: git://bitbucket.org/user/repo
dest: /srv/checkout
clone: no
update: no
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется обратной совместимостью.
Автор
- Yeukhon Wong (@yeukhon)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/hg_module.html
