модуль theforeman.foreman.repository_set — включение и отключение репозиториев Red Hat, доступных по подписке
Примечание
Этот модуль входит в коллекцию theforeman.foreman (версия 5.11.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install theforeman.foreman. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.
Чтобы использовать этот модуль в плейбуке, укажите: theforeman.foreman.repository_set.
Добавлено в theforeman.foreman 1.0.0
Краткое описание
- Включение и отключение репозиториев Red Hat, доступных по подписке
Псевдонимы: katello_repository_set
Требования
Следующие требования должны быть выполнены на узле, который выполняет этот модуль.
- requests
Параметры
Параметр | Комментарии |
|---|---|
all_repositories boolean | Воздействовать на все доступные репозитории в наборе репозиториев вместо перечисления их в repositories. Обязательный параметр, если repositories не задан или представляет собой пустой список. Варианты:
|
ca_path path | Файл в формате PEM, содержащий сертификат CA для проверки. Если значение не указано в задаче, вместо него используется значение переменной среды |
label string | Метка набора репозиториев; её можно использовать вместо name и product. |
name string | Имя набора репозиториев |
oauth1_consumer_key string | Ключ потребителя OAuth1 для доступа к серверу Foreman. Если значение не указано в задаче, вместо него используется значение переменной среды |
oauth1_consumer_secret string | Секретный ключ потребителя OAuth1 для доступа к серверу Foreman. Если значение не указано в задаче, вместо него используется значение переменной среды |
organization string / обязательный | Организация, которой принадлежит объект |
password string | Пароль пользователя, обращающегося к серверу Foreman. Если значение не указано в задаче, вместо него используется значение переменной среды |
product string | Имя родительского продукта |
repositories list / элементы=dictionary | Версия выпуска и базовая архитектура репозиториев, которые нужно включить. Для некоторых наборов репозиториев требуется указать только basearch или только releasever. Примеры получения этой информации с помощью theforeman.foreman.resource_info см. в разделе с примерами. Обязательный параметр, если all_repositories не задан или равен |
|
basearch string |
Базовая архитектура репозитория, который нужно включить. |
|
releasever string |
Версия выпуска репозитория, который нужно включить. |
server_url string / обязательный | URL сервера Foreman. Если значение не указано в задаче, вместо него используется значение переменной среды |
state string | Указывает, должны ли быть включены репозитории Варианты:
|
use_gssapi boolean | Использовать GSSAPI для аутентификации; обычно это Kerberos или Kerberos через аутентификацию Negotiate. Требуется установленная библиотека Python requests-gssapi. Если значение не указано в задаче, вместо него используется значение переменной среды Варианты:
|
username string | Имя пользователя, обращающегося к серверу Foreman. Если значение не указано в задаче, вместо него используется значение переменной среды |
validate_certs boolean | Проверять ли TLS-сертификаты сервера Foreman. Если значение не указано в задаче, вместо него используется значение переменной среды Варианты:
|
Атрибуты
Атрибут | Поддержка | Описание |
|---|---|---|
check_mode | Поддержка: full | Может выполняться в режиме check_mode и возвращать прогноз изменения состояния без изменения объекта |
diff_mode | Поддержка: full | В режиме diff возвращает сведения об изменениях (или о возможных изменениях в режиме check_mode) |
Примеры
- name: "Enable RHEL 7 RPMs repositories"
theforeman.foreman.repository_set:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
name: "Red Hat Enterprise Linux 7 Server (RPMs)"
organization: "Default Organization"
product: "Red Hat Enterprise Linux Server"
repositories:
- releasever: "7.0"
basearch: "x86_64"
- releasever: "7.1"
basearch: "x86_64"
- releasever: "7.2"
basearch: "x86_64"
- releasever: "7.3"
basearch: "x86_64"
state: enabled
- name: "Enable RHEL 7 RPMs repositories with label"
theforeman.foreman.repository_set:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
organization: "Default Organization"
label: rhel-7-server-rpms
repositories:
- releasever: "7.0"
basearch: "x86_64"
- releasever: "7.1"
basearch: "x86_64"
- releasever: "7.2"
basearch: "x86_64"
- releasever: "7.3"
basearch: "x86_64"
state: enabled
- name: "Disable RHEL 7 Extras RPMs repository"
theforeman.foreman.repository_set:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
name: Red Hat Enterprise Linux 7 Server - Extras (RPMs)
organization: "Default Organization"
product: Red Hat Enterprise Linux Server
state: disabled
repositories:
- basearch: x86_64
- name: "Enable RHEL 8 BaseOS RPMs repository with label"
theforeman.foreman.repository_set:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
organization: "Default Organization"
label: rhel-8-for-x86_64-baseos-rpms
repositories:
- releasever: "8"
- name: "Enable Red Hat Virtualization Manager RPMs repository with label"
theforeman.foreman.repository_set:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
organization: "Default Organization"
label: "rhel-7-server-rhv-4.2-manager-rpms"
repositories:
- basearch: x86_64
state: enabled
- name: "Enable Red Hat Virtualization Manager RPMs repository without specifying basearch"
theforeman.foreman.repository_set:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
organization: "Default Organization"
label: "rhel-7-server-rhv-4.2-manager-rpms"
all_repositories: true
state: enabled
- name: "Search for possible repository sets of a product"
theforeman.foreman.resource_info:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
organization: "Default Organization"
resource: repository_sets
search: product_name="Red Hat Virtualization Manager"
register: data
- name: "Output found repository sets, see the contentUrl section for possible repository substitutions"
debug:
var: data
- name: "Search for possible repository sets by label"
theforeman.foreman.resource_info:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
organization: "Default Organization"
resource: repository_sets
search: label=rhel-7-server-rhv-4.2-manager-rpms
register: data
- name: "Output found repository sets, see the contentUrl section for possible repository substitutions"
debug:
var: data
- name: Enable set with and without all_repositories at the same time
theforeman.foreman.repository_set:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
organization: "Default Organization"
label: "{{ item.label }}"
repositories: "{{ item.repositories | default(omit) }}"
all_repositories: "{{ item.repositories is not defined }}"
state: enabled
loop:
- label: rhel-7-server-rpms
repositories:
- releasever: "7Server"
basearch: "x86_64"
- label: rhel-7-server-rhv-4.2-manager-rpms
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
entity dictionary | Итоговое состояние затронутых объектов, сгруппированных по типу. Возвращается: при успешном выполнении |
|
repository_sets list / элементы=dictionary |
Список наборов репозиториев. Возвращается: при успешном выполнении |
Ссылки на коллекцию
© 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/theforeman/foreman/repository_set_module.html
