Модуль theforeman.foreman.repository – Управление репозиториями
Примечание
Этот модуль входит в коллекцию theforeman.foreman (версия 4.2.0).
Эта коллекция, возможно, уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install theforeman.foreman. Для использования этого модуля требуются дополнительные зависимости. Подробности см. в разделе Требования.
Чтобы использовать его в плейбуке, укажите: theforeman.foreman.repository.
Новое в theforeman.foreman 1.0.0
Описание
- Создание и управление репозиториями
Псевдонимы: katello_repository
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- requests
Параметры
Параметр | Комментарии |
|---|---|
ansible_collection_requirements string | Содержимое файла требований yaml для синхронизации с URL |
arch string | Архитектура содержимого репозитория Установите значение |
auto_enabled boolean | Репозитории будут автоматически активированы на зарегистрированном хосте, подписанном на этот продукт Варианты:
|
checksum_type string | Контрольная сумма репозитория Варианты:
|
content_type string / required | Тип содержимого репозитория Варианты:
|
deb_architectures string | Список архитектур, разделённый запятыми, которые необходимо синхронизировать из deb-архива доступно только для content_type=deb |
deb_components string | Список компонентов репозитория, разделённый запятыми, которые необходимо синхронизировать из deb-архива доступно только для content_type=deb |
deb_errata_url string | URL для синхронизации информации об ошибках Debian или Ubuntu доступно только в Orcharhino доступно только для content_type=deb |
deb_releases string | Список релизов, разделённый запятыми, которые необходимо синхронизировать из deb-архива доступно только для content_type=deb |
description string | Описание репозитория |
docker_tags_whitelist list / elements=string | Список тегов для синхронизации репозитория образов контейнеров доступно только для content_type=docker Устарело начиная с Katello 4.4 |
docker_upstream_name string | Имя основного репозитория docker доступно только для content_type=docker |
download_concurrency integer добавлено в theforeman.foreman 3.0.0 | Параллелизм загрузки для синхронизации с основным репозиторием поскольку API не возвращает это значение, это нарушит идемпотентность для этого модуля |
download_policy string | Политика загрузки для синхронизации с основным репозиторием. Политика загрузки Варианты:
|
exclude_tags list / elements=string добавлено в theforeman.foreman 3.7.0 | Список тегов для исключения при синхронизации репозитория образов контейнеров. |
gpg_key string | GPG ключ репозитория |
http_proxy string | Имя прокси-сервера HTTP для использования при синхронизации контента Должно быть объединено с http_proxy_policy=’use_selected_http_proxy’ |
http_proxy_policy string | Какой прокси-сервер использовать для синхронизации контента Варианты:
|
ignorable_content list / elements=string | Список единиц контента для игнорирования при синхронизации репозитория yum. Должно быть подмножеством rpm,drpm,srpm,distribution,erratum. |
ignore_global_proxy boolean | Использовать или игнорировать глобальную настройку прокси-сервера HTTP при синхронизации контента Устарело в Katello 3.13 Заменено на http_proxy_policy Варианты:
|
include_tags list / elements=string добавлено в theforeman.foreman 3.7.0 | Список тегов для синхронизации репозитория образов контейнеров. |
label string | Метка репозитория |
mirror_on_sync boolean | Включает/выключает «зеркалирование при синхронизации», где состояние репозитория отражает состояние репозитория upstream во время синхронизации Устарело начиная с Katello 4.3 Заменено на mirroring_policy=mirror_content_only Choices:
|
mirroring_policy string | Политика для зеркалирования контента Поддерживается начиная с Katello 4.3 Choices:
|
name string / required | Имя репозитория |
organization string / required | Организация, к которой принадлежит сущность |
os_versions list / elements=string | Определяет, следует ли отключить репозиторий на клиенте с несоответствующей версией ОС. Можно выбрать максимум одну версию ОС. Установите значение Choices:
|
password string / required | Пароль пользователя, обращающегося к серверу Foreman. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
product string / required | Продукт, в котором находится репозиторий |
server_url string / required | URL сервера Foreman. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
ssl_ca_cert string | Сертификат SSL CA репозитория |
ssl_client_cert string | Клиентский сертификат SSL репозитория |
ssl_client_key string | Закрытый ключ клиента SSL репозитория |
state string | Состояние сущности
Choices:
|
unprotected boolean | Опубликовать репозиторий через HTTP Choices:
|
upstream_password string | Пароль для доступа к репозиторию upstream. Когда этот параметр установлен, модуль не будет идемпотентным. |
upstream_username string | Имя пользователя для доступа к репозиторию upstream |
url string | URL репозитория для синхронизации |
username string / required | Имя пользователя, обращающегося к серверу Foreman. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения |
validate_certs boolean | Проверять ли сертификаты TLS сервера Foreman. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения Choices:
|
verify_ssl_on_sync boolean | Проверить, подписаны ли сертификаты upstream доверенным центром сертификации Choices:
|
Атрибуты
Атрибут | Поддержка | Описание |
|---|---|---|
check_mode | Поддержка: полная | Может работать в режиме check_mode и возвращать прогноз изменения состояния без изменения сущности |
diff_mode | Поддержка: полная | Вернёт подробности о том, что изменилось (или, возможно, нужно изменить в режиме check_mode) при использовании diff-режима |
Примечания
Примечание
- Вы можете настроить определённые аспекты существующих репозиториев Red Hat (например, download_policy) с помощью этого модуля, но вы не можете создавать (включать) или удалять (отключать) их.
- Если вам нужно включить или отключить репозитории Red Hat, доступные по вашей подписке, используйте модуль theforeman.foreman.repository_set вместо этого.
Примеры
- name: "Create repository"
theforeman.foreman.repository:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
name: "My repository"
state: present
content_type: "yum"
product: "My Product"
organization: "Default Organization"
url: "http://yum.theforeman.org/plugins/latest/el7/x86_64/"
mirror_on_sync: true
download_policy: immediate
- name: "Create repository with content credentials"
theforeman.foreman.repository:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
name: "My repository 2"
state: present
content_type: "yum"
product: "My Product"
organization: "Default Organization"
url: "http://yum.theforeman.org/releases/latest/el7/x86_64/"
download_policy: on_demand
mirror_on_sync: true
gpg_key: RPM-GPG-KEY-my-product2
Значения возврата
Общие значения возврата документированы здесь, следующие поля уникальны для этого модуля:
Ключ | Описание |
|---|---|
entity словарь | Конечное состояние затронутых сущностей, сгруппированных по их типу. Возвращаемое значение: успех |
|
repositories список / элементы=словарь |
Список репозиториев. Возвращаемое значение: успех |
Ссылки на коллекции
© 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/theforeman/foreman/repository_module.html