Модуль community.general.hg — управление репозиториями Mercurial (hg)

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

Чтобы использовать её в плейбуке, укажите: community.general.hg.

Краткое описание
Параметры
Атрибуты
Примечания
Примеры

Краткое описание

Управляет репозиториями Mercurial (hg). Поддерживаются SSH, HTTP/S и локальный адрес.

Параметры

Параметр	Комментарии
clone boolean	Если `false`, не клонировать репозиторий, если он отсутствует локально. Варианты: `false` `true` ← (по умолчанию)
dest path	Абсолютный путь, по которому следует клонировать репозиторий. Этот параметр обязателен, если для clone и update не задано значение no.
executable string	Путь к исполняемому файлу `hg`. Если не указан, используется стандартный механизм определения путей к двоичным файлам.
force boolean	Отменяет незафиксированные изменения. Выполняет `hg update -C`. Варианты: `false` ← (по умолчанию) `true`
purge boolean	Удаляет неотслеживаемые файлы. Выполняет `hg purge`. Варианты: `false` ← (по умолчанию) `true`
repo псевдонимы: name string / обязательный	Адрес репозитория.
revision псевдонимы: version string	Эквивалент параметра `-r` в команде hg, которым может быть набор изменений, номер ревизии, имя ветки или даже тег.
update boolean	Если `false`, не получать новые ревизии из исходного репозитория. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: нет	Может работать в режиме `check_mode` и возвращать прогноз изменения состояния без изменения целевого объекта.
diff_mode	Поддержка: нет	В режиме diff возвращает сведения об изменениях (или о возможных изменениях в `check_mode`).

Примечания

Примечание

Этот модуль не поддерживает отправку изменений. См. 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.
По состоянию на 1 декабря 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.
  community.general.hg:
    repo: https://bitbucket.org/user/repo1
    dest: /home/user/repo1
    revision: stable
    purge: true

- name: Get information about the repository whether or not it has already been cloned locally.
  community.general.hg:
    repo: git://bitbucket.org/user/repo
    dest: /srv/checkout
    clone: false
    update: false

Авторы

Yeukhon Wong (@yeukhon)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/hg_module.html