Spec-Zone.ru › Ansible 2.9

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

  • Синтаксис
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус

Синтаксис

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

Требования

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

  • subscription-manager

Параметры

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

псевдонимы: autosubscribe
consumer_id
-
Ссылка на существующий идентификатор потребителя для возобновления использования предыдущей регистрации для этой системы. Если сертификат идентификации системы утерян или поврежден, этот параметр позволяет возобновить использование предыдущей идентификации и подписок. По умолчанию идентификатор потребителя не указывается, и создается новый.
consumer_name
-
Имя системы для регистрации, по умолчанию — имя хоста
consumer_type
-
Тип единицы для регистрации, по умолчанию — система
environment
-
Регистрация в определенной среде в целевой организации. Используется с Red Hat Satellite 6.x или Katello
force_register
boolean
    Варианты:
  • нет ←
  • да
Зарегистрировать систему, даже если она уже зарегистрирована
org_id
-
Идентификатор организации для использования совместно с activationkey
password
-
пароль access.redhat.com или Sat6
pool
-
По умолчанию:
"^$"
Укажите имя пула подписок для потребления. Поддерживаются регулярные выражения. Используйте pool_ids, если это возможно, так как он намного быстрее. Взаимоисключающие с pool_ids.
pool_ids
-
добавлен в 2.4
По умолчанию:
[]
Укажите идентификаторы пулов подписок для потребления. Предпочтительнее pool, когда это возможно, так как он намного быстрее. Идентификатор пула может быть указан как string\ - только идентификатор пула (например, 0123456789abcdef0123456789abcdef), или как dict\ с идентификатором пула в качестве ключа и количеством в качестве значения (например, 0123456789abcdef0123456789abcdef: 2). Если указано количество, оно используется для потребления нескольких прав доступа из пула (пул должен поддерживать это). Взаимоисключающие с pool.
release
-
добавлен в 2.8
Установить версию релиза
rhsm_baseurl
-
Указать базовый URL CDN
rhsm_repo_ca_cert
-
добавлен в 2.7
Указать альтернативное расположение сертификата CA для CDN
server_hostname
-
Укажите альтернативный сервер Red Hat Subscription Management или Sat6
server_insecure
-
Включить или выключить проверку сертификата сервера https при подключении к server_hostname
server_proxy_hostname
-
добавлен в 2.4
Указать имя хоста HTTP-прокси
server_proxy_password
-
добавлен в 2.4
Указать пароль для HTTP-прокси с базовой аутентификацией
server_proxy_port
-
добавлен в 2.4
Указать порт HTTP-прокси
server_proxy_user
-
добавлен в 2.4
Указать пользователя для HTTP-прокси с базовой аутентификацией
state
-
    Варианты:
  • наличие ←
  • отсутствует
необходимо ли регистрировать и подписывать (present) или отписывать (absent) систему
syspurpose
словарь
добавлен в 2.9
По умолчанию:
{}
Установите атрибуты 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
boolean
    Варианты:
  • нет ←
  • да
Если этот параметр true, атрибуты syspurpose синхронизируются с сервером RHSM немедленно. Если этот параметр false, атрибуты syspurpose будут синхронизированы с сервером RHSM демоном rhsmcertd.
usage
-
Атрибут syspurpose usage
username
-
имя пользователя access.redhat.com или Sat6

Примечания

Примечание

  • Для регистрации системы subscription-manager требует либо имя пользователя и пароль, либо ключ активации и идентификатор организации.
  • С версии 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.
  redhat_subscription:
    state: present
    username: joe_user
    password: somepass
    auto_attach: true

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

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

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

- name: Register and pull existing system data.
  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
  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)
  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.
  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
  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
  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'}


Статус

  • Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
  • Данный модуль поддерживается сообществом Ansible. [сообщество]

Авторы

  • Barnaby Court (@barnabycourt)

Подсказка

Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/redhat_subscription_module.html

Spec-Zone.ru

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