theforeman.foreman.templates_import – Синхронизация шаблонов из репозитория

Примечание

Этот плагин является частью коллекции theforeman.foreman (версия 1.5.1).

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

Для использования в плейбуке укажите: theforeman.foreman.templates_import.

Новое в версии 1.0.0: of theforeman.foreman

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Синхронизация шаблонов развёртывания, шаблонов отчётов, таблиц разделов и шаблонов задач из внешнего репозитория Git или файловой системы.
Основано на плагине foreman_templates https://github.com/theforeman/foreman_templates.

Требования

Ниже перечислены требования, необходимые на хосте, который выполняет этот модуль.

requests

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
associate строка	Варианты: всегда новый никогда	Связь с операционными системами, местоположениями и организациями на основе метаданных.
branch строка		Ветка репозитория repo. Только для репозиториев на основе Git.
dirname строка		Директория внутри репозитория Git, содержащая шаблоны.
filter строка		Синхронизировать только шаблоны с именем, соответствующим этому регулярному выражению, после применения prefix. Регистронезависимое, фрагменты не фильтруются.
force логическое	Варианты: нет да	Обновить заблокированные шаблоны.
locations список / элементы=строка		Список местоположений, к которым должна быть назначена сущность
lock логическое	Варианты: нет да	Заблокировать импортированные шаблоны.
negate логическое	Варианты: нет да	Инвертировать условие фильтра.
organizations список / элементы=строка		Список организаций, к которым должна быть назначена сущность
password строка / обязательно		Пароль пользователя, имеющего доступ к серверу Foreman. Если значение не указано в задаче, будет использовано значение переменной среды `FOREMAN_PASSWORD`.
prefix строка		Добавляет указанную строку к началу всех импортированных шаблонов, у которых ещё нет этого префикса.
repo строка		Путь к файловой системе или репозиторию (с протоколом), например /tmp/dir или git://example.com/repo.git или https://example.com/repo.git.
server_url строка / обязательно		URL сервера Foreman. Если значение не указано в задаче, будет использовано значение переменной среды `FOREMAN_SERVER_URL`.
username строка / обязательно		Имя пользователя, имеющего доступ к серверу Foreman. Если значение не указано в задаче, будет использовано значение переменной среды `FOREMAN_USERNAME`.
validate_certs логическое	Варианты: нет да ←	Требуется ли проверка сертификатов TLS сервера Foreman. Если значение не указано в задаче, будет использовано значение переменной среды `FOREMAN_VALIDATE_CERTS`.
verbose логическое	Варианты: нет да	Добавить отчёты о шаблонах в вывод.

Примечания

Примечание

Из-за ошибки в плагине foreman_templates этот модуль не будет сообщать changed=true при единственном изменении — назначении организации/местоположения импортированных шаблонов. Подробности см. в https://projects.theforeman.org/issues/29534.
Значения по умолчанию для всех параметров модуля можно установить с помощью theforeman.foreman.setting для категории TemplateSync или на странице настроек в WebUI.

Примеры

- name: Sync templates from git repo
  theforeman.foreman.templates_import:
    repo: https://github.com/theforeman/community-templates.git
    branch: 1.24-stable
    associate: new
    server_url: "https://foreman.example.com"
    username: "admin"
    password: "changeme"

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ		Возвращаемое значение	Описание
message словарь		успех	Информация об импорте.
	branch строка	успех	Ветка, используемая в репозитории.
	repo строка	успех	Репозиторий, из которого были импортированы шаблоны.
report словарь		успех	Отчёт об импорте.
	changed список / элементы=строка	успех	Список шаблонов, которые были обновлены.
	new список / элементы=строка	успех	Список шаблонов, которые были созданы.
templates словарь		успех	Конечное состояние шаблонов.

Авторы

Антон Нестеров (@nesanton)

© 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/theforeman/foreman/templates_import_module.html