theforeman.foreman.repository_set – Включение/выключение репозиториев Red Hat, доступных через подписки
Примечание
Этот плагин входит в коллекцию theforeman.foreman (версия 1.5.1).
Для его установки используйте: ansible-galaxy collection install theforeman.foreman.
Для использования в playbook, укажите: theforeman.foreman.repository_set.
Новое в версии 1.0.0: of theforeman.foreman
Обзор
- Включение/выключение репозиториев Red Hat, доступных через подписки
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- requests
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| all_repositories boolean |
| Воздействует на все доступные репозитории в наборе репозиториев вместо их перечисления в repositories. Необходимо, когда repositories не задано или является пустым списком. | |
| label string | Метка набора репозиториев, может быть использована вместо name и product
| ||
| name string | Имя набора репозиториев | ||
| organization string / обязательно | Организация, в которой находится сущность | ||
| password string / обязательно | Пароль пользователя, получающего доступ к серверу Foreman. Если значение не указано в задаче, используется значение переменной среды FOREMAN_PASSWORD. | ||
| product string | Имя родительского продукта | ||
| repositories list / элементы=словарь | Версия выпуска и базовая архитектура репозиториев для включения. Некоторые наборы репозиториев требуют только basearch или только releasever. См. примеры того, как получить эту информацию с помощью theforeman.foreman.resource_info. Требуется, если all_repositories не задано или false. | ||
| basearch string | Базовая архитектура репозитория для включения. | ||
| releasever string | Версия выпуска репозитория для включения. | ||
| server_url string / обязательно | URL сервера Foreman. Если значение не указано в задаче, используется значение переменной среды FOREMAN_SERVER_URL. | ||
| state string |
| Включены ли репозитории или нет | |
| username string / обязательно | Имя пользователя, получающего доступ к серверу Foreman. Если значение не указано в задаче, используется значение переменной среды FOREMAN_USERNAME. | ||
| validate_certs boolean |
| Нужно ли проверять сертификаты TLS сервера Foreman. Если значение не указано в задаче, используется значение переменной среды FOREMAN_VALIDATE_CERTS. | |
Примеры
- 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 | success | Конечное состояние затронутых сущностей, сгруппированных по их типу. | |
| repository_sets list / элементы=словарь | success | Список наборов репозиториев. | |
Авторы
- Andrew Kofink (@akofink)
© 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_set_module.html