Модуль theforeman.foreman.repository_set — Включение/выключение репозиториев Red Hat, доступных по подписке

Примечание

Этот модуль является частью коллекции theforeman.foreman (версия 4.2.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 не задано или является пустым списком. Варианты: `false` `true`
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	Включены или нет репозитории Варианты: `"enabled"` ← (по умолчанию) `"disabled"`
username string / обязательно	Имя пользователя, получающего доступ к серверу Foreman. Если значение не указано в задаче, будет использовано значение переменной среды `FOREMAN_USERNAME`.
validate_certs boolean	Подтвердить сертификаты TLS сервера Foreman. Если значение не указано в задаче, будет использовано значение переменной среды `FOREMAN_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Модуль может работать в режиме check_mode и возвращать прогноз изменений, не изменяя сущность.
diff_mode	Поддержка: полная	В режиме 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 словарь	Конечное состояние затронутых сущностей, сгруппированных по их типу. Возвращено: успех
repository_sets список / элементы=словарь	Список наборов репозиториев. Возвращено: успех

Авторы

Andrew Kofink (@akofink)

Ссылки на сборку

© 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_set_module.html