Spec-Zone.ru › Ansible 2.11

community.general.redhat_subscription – Управление регистрацией и подписками на RHSM с помощью команды subscription-manager

Примечание

Этот плагин является частью коллекции community.general (версия 2.0.1).

Для его установки используйте: ansible-galaxy collection install community.general

Для использования в книге задач укажите: community.general.redhat_subscription

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Обзор

  • Управление регистрацией и подпиской на платформу подписок Red Hat Subscription Management с помощью команды subscription-manager

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

  • subscription-manager

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
activationkey
строка
укажите ключ активации для регистрации
auto_attach
логическое значение
    Варианты:
  • no
  • yes
После успешной регистрации автоматически потребляются доступные подписки
Добавлен в пользу устаревшего autosubscribe в 2.5.

алиасы: autosubscribe
consumer_id
строка
ссылка на существующий идентификатор потребителя для возобновления использования предыдущей регистрации для этой системы. Если сертификат идентификации системы утерян или поврежден, этот параметр позволяет возобновить использование ее предыдущей идентичности и подписок. По умолчанию идентификатор потребителя не указывается, поэтому создается новый.
consumer_name
строка
Имя системы для регистрации, по умолчанию - имя хоста
consumer_type
строка
Тип устройства для регистрации, по умолчанию - система
environment
строка
Регистрация в определенной среде в целевой организации. Используется с Red Hat Satellite 6.x или Katello
force_register
логическое значение
    Варианты:
  • no ←
  • yes
Зарегистрировать систему, даже если она уже зарегистрирована
org_id
строка
Идентификатор организации для использования в сочетании с activationkey
password
строка
пароль access.redhat.com или Sat6
pool
строка
По умолчанию:
"^$"
Укажите имя пула подписок для потребления. Допускаются регулярные выражения. Используйте pool_ids, если это возможно, так как это гораздо быстрее. Взаимоисключающие с pool_ids.
pool_ids
список / элементы=строка
По умолчанию:
[]
Укажите идентификаторы пулов подписок для потребления. Предпочтительнее pool, когда это возможно, так как это гораздо быстрее. Идентификатор пула может быть указан как string - только идентификатор пула (например, 0123456789abcdef0123456789abcdef), или как dict с идентификатором пула в качестве ключа и количеством в качестве значения (например, 0123456789abcdef0123456789abcdef: 2. Если количество указано, оно используется для потребления нескольких прав доступа из пула (пул должен это поддерживать). Взаимоисключающие с pool.
release
строка
Установите версию выпуска
rhsm_baseurl
строка
Укажите базовый URL CDN
rhsm_repo_ca_cert
строка
Укажите альтернативное расположение сертификата CA для CDN
server_hostname
строка
Укажите альтернативный сервер Red Hat Subscription Management или Sat6
server_insecure
строка
Включить или отключить проверку сертификата сервера https при подключении к server_hostname
server_proxy_hostname
строка
Укажите имя хоста HTTP-прокси
server_proxy_password
строка
Укажите пароль для HTTP-прокси с базовой аутентификацией
server_proxy_port
строка
Укажите порт HTTP-прокси
server_proxy_user
строка
Укажите пользователя для HTTP-прокси с базовой аутентификацией
state
строка
    Варианты:
  • present ←
  • absent
Регистрация и подписка (present), или отмена регистрации (absent) системы
syspurpose
словарь
По умолчанию:
{}
Установите атрибуты syspurpose в файле /etc/rhsm/syspurpose/syspurpose.json и синхронизируйте эти атрибуты с сервером RHSM. Атрибуты syspurpose помогают автоматически прикрепить наиболее подходящие подписки к системе. Когда в файле syspurpose.json уже содержатся некоторые атрибуты, новые атрибуты перезаписывают существующие атрибуты. Если атрибут отсутствует в новом списке атрибутов, существующий атрибут будет удален из файла syspurpose.json. Неизвестные атрибуты игнорируются.
addons
список / элементы=строка
Атрибуты syspurpose addons
role
строка
Атрибут syspurpose role
service_level_agreement
строка
Атрибут syspurpose service_level_agreement
sync
логическое значение
    Варианты:
  • no ←
  • yes
Если этот параметр равен true, атрибуты syspurpose синхронизируются с сервером RHSM немедленно. Если этот параметр равен false, атрибуты syspurpose будут синхронизированы с сервером RHSM демоном rhsmcertd.
usage
строка
Атрибут syspurpose usage
username
строка
логин access.redhat.com или Sat6

Примечания

Примечание

  • Для регистрации системы subscription-manager требует либо имя пользователя и пароль, либо activationkey и идентификатор организации.
  • С версии 2.5 значения для server_hostname, server_insecure, rhsm_baseurl, server_proxy_hostname, server_proxy_port, server_proxy_user и server_proxy_password больше не берутся из файла конфигурации /etc/rhsm/rhsm.conf и по умолчанию равны None.

Примеры

- name: Register as user (joe_user) with password (somepass) and auto-subscribe to available content.
  community.general.redhat_subscription:
    state: present
    username: joe_user
    password: somepass
    auto_attach: true

- name: Same as above but subscribe to a specific pool by ID.
  community.general.redhat_subscription:
    state: present
    username: joe_user
    password: somepass
    pool_ids: 0123456789abcdef0123456789abcdef

- name: Register and subscribe to multiple pools.
  community.general.redhat_subscription:
    state: present
    username: joe_user
    password: somepass
    pool_ids:
      - 0123456789abcdef0123456789abcdef
      - 1123456789abcdef0123456789abcdef

- name: Same as above but consume multiple entitlements.
  community.general.redhat_subscription:
    state: present
    username: joe_user
    password: somepass
    pool_ids:
      - 0123456789abcdef0123456789abcdef: 2
      - 1123456789abcdef0123456789abcdef: 4

- name: Register and pull existing system data.
  community.general.redhat_subscription:
    state: present
    username: joe_user
    password: somepass
    consumer_id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

- name: Register with activationkey and consume subscriptions matching Red Hat Enterprise Server or Red Hat Virtualization
  community.general.redhat_subscription:
    state: present
    activationkey: 1-222333444
    org_id: 222333444
    pool: '^(Red Hat Enterprise Server|Red Hat Virtualization)$'

- name: Update the consumed subscriptions from the previous example (remove Red Hat Virtualization subscription)
  community.general.redhat_subscription:
    state: present
    activationkey: 1-222333444
    org_id: 222333444
    pool: '^Red Hat Enterprise Server$'

- name: Register as user credentials into given environment (against Red Hat Satellite 6.x), and auto-subscribe.
  community.general.redhat_subscription:
    state: present
    username: joe_user
    password: somepass
    environment: Library
    auto_attach: true

- name: Register as user (joe_user) with password (somepass) and a specific release
  community.general.redhat_subscription:
    state: present
    username: joe_user
    password: somepass
    release: 7.4

- name: Register as user (joe_user) with password (somepass), set syspurpose attributes and synchronize them with server
  community.general.redhat_subscription:
    state: present
    username: joe_user
    password: somepass
    auto_attach: true
    syspurpose:
      usage: "Production"
      role: "Red Hat Enterprise Server"
      service_level_agreement: "Premium"
      addons:
        - addon1
        - addon2
      sync: true

Возвращаемые значения

Общие значения возврата описаны в здесь, следующие поля уникальны для этого модуля:

Ключ Возвращаемое значение Описание
subscribed_pool_ids
сложный тип
успех
Список идентификаторов пулов, к которым система сейчас подписана

Пример:
{'8a85f9815ab905d3015ab928c7005de4': '1'}


Авторы

  • Barnaby Court (@barnabycourt)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/redhat_subscription_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API