theforeman.foreman.repository – Управление репозиториями
Примечание
Этот плагин входит в коллекцию theforeman.foreman (версия 1.5.1).
Для его установки используйте: ansible-galaxy collection install theforeman.foreman.
Для использования в книге задач укажите: theforeman.foreman.repository.
Введено в версии 1.0.0: of theforeman.foreman
Обзор
- Создание и управление репозиториями
Требования
Ниже перечислены требования, необходимые на узле, на котором выполняется данный модуль.
- requests
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| ansible_collection_requirements строка | Содержимое файла yaml с требованиями для синхронизации из URL | |
| auto_enabled булево |
| репозитории будут автоматически включены на зарегистрированном узле, подписанном на этот продукт |
| checksum_type строка |
| Контрольная сумма репозитория |
| content_type строка / обязательно |
| Тип содержимого репозитория |
| deb_architectures строка | Список архитектур, разделенных запятыми, для синхронизации из deb-архива Доступно только для content_type=deb | |
| deb_components строка | Список компонентов репозитория, разделенных запятыми, для синхронизации из deb-архива Доступно только для content_type=deb | |
| deb_errata_url строка | URL для синхронизации информации об исправлениях Debian или Ubuntu Доступно только в Orcharhino Доступно только для content_type=deb | |
| deb_releases строка | Список версий, разделенных запятыми, для синхронизации из deb-архива Доступно только для content_type=deb | |
| description строка | Описание репозитория | |
| docker_tags_whitelist список / элементы=строка | Список тегов для синхронизации репозитория изображений контейнеров Доступно только для content_type=docker | |
| docker_upstream_name строка | Имя удаленного репозитория Docker Доступно только для content_type=docker | |
| download_policy строка |
| Политика загрузки для синхронизации из источника |
| gpg_key строка | Ключ GPG репозитория | |
| http_proxy строка | Имя прокси-сервера HTTP для синхронизации содержимого Должно быть комбинировано с http_proxy_policy='use_selected_http_proxy' | |
| http_proxy_policy строка |
| Какой прокси использовать для синхронизации содержимого |
| ignorable_content список / элементы=строка | Список единиц содержимого, которые нужно игнорировать при синхронизации репозитория yum. Должно быть подмножеством rpm,drpm,srpm,distribution,erratum. | |
| ignore_global_proxy булево |
| Использовать или игнорировать глобальные настройки прокси HTTP при синхронизации содержимого Этот параметр устарел с Katello 3.13 Заменён на http_proxy_policy |
| label строка | метка репозитория | |
| mirror_on_sync булево |
| включить "зеркальное отображение при синхронизации", где состояние репозитория будет зеркалить состояние удаленного репозитория во время синхронизации |
| name строка / обязательно | Имя репозитория | |
| organization строка / обязательно | Организация, в которой находится сущность | |
| password строка / обязательно | Пароль пользователя, имеющего доступ к серверу Foreman. Если значение не указано в задаче, будет использовано значение переменной среды FOREMAN_PASSWORD. | |
| product строка / обязательно | Продукт, в котором находится репозиторий | |
| server_url строка / обязательно | URL сервера Foreman. Если значение не указано в задаче, будет использовано значение переменной среды FOREMAN_SERVER_URL. | |
| ssl_ca_cert строка | Сертификат SSL CA репозитория | |
| ssl_client_cert строка | Сертификат SSL клиента репозитория | |
| ssl_client_key строка | Приватный ключ SSL клиента репозитория | |
| state строка |
| Состояние сущности present_with_defaults гарантирует существование сущности, но не будет обновлять существующие |
| unprotected булево |
| Опубликовать репозиторий через HTTP |
| upstream_password строка | Пароль для доступа к удаленному репозиторию | |
| upstream_username строка | Имя пользователя для доступа к удаленному репозиторию | |
| url строка | URL репозитория для синхронизации | |
| username строка / обязательно | Имя пользователя, имеющего доступ к серверу Foreman. Если значение не указано в задаче, будет использовано значение переменной среды FOREMAN_USERNAME. | |
| validate_certs булево |
| Подтверждать ли сертификаты TLS сервера Foreman. Если значение не указано в задаче, будет использовано значение переменной среды FOREMAN_VALIDATE_CERTS. |
| verify_ssl_on_sync булево |
| Проверять подпись сертификатов источника доверенной службой сертификации |
Примечания
Примечание
- Вы можете настроить некоторые аспекты существующих репозиториев 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: background
- 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: background
mirror_on_sync: true
gpg_key: RPM-GPG-KEY-my-product2
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое | Описание | |
|---|---|---|---|
| entity словарь | успех | Конечное состояние затронутых сущностей, сгруппированных по их типу. | |
| repositories список / элементы=словарь | успех | Список репозиториев. | |
Авторы
- Eric D Helms (@ehelms)
© 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/repository_module.html
