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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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 aliases: name string / обязательно	Адрес репозитория.
revision aliases: version string	Эквивалентный параметр `-r` в команде hg, который может быть номером изменения, номером версии, именем ветки или тегом.
update boolean	Если `false`, не получать новые изменения из исходного репозитория. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

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

Примечания

Примечание

Этот модуль не поддерживает функцию 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.
  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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/hg_module.html