redhat_subscription - Управление регистрацией и подписками на RHSM с помощью команды subscription-manager
Краткое описание
- Управление регистрацией и подпиской на платформу Red Hat Subscription Management с помощью команды
subscription-manager
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- subscription-manager
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| activationkey | Значение по умолчанию: None | укажите ключ активации для использования при регистрации |
| auto_attach (добавлен в 2.5) |
| После успешной регистрации автоматически использовать доступные подписки Добавлен в качестве альтернативы устаревшему autosubscribe в версии 2.5. псевдонимы: autosubscribe |
| consumer_id (добавлен в 2.1) | Значение по умолчанию: None | Ссылка на существующий идентификатор потребителя для продолжения использования предыдущей регистрации для этой системы. Если сертификат идентификации системы утерян или поврежден, этот параметр позволяет возобновить использование предыдущей идентификации и подписок. По умолчанию идентификатор потребителя не указывается, поэтому создается новый. |
| consumer_name (добавлен в 2.1) | Значение по умолчанию: None | Имя системы для регистрации, по умолчанию совпадает с именем хоста |
| consumer_type (добавлен в 2.1) | Значение по умолчанию: None | Тип устройства для регистрации, по умолчанию система |
| environment (добавлен в 2.2) | Значение по умолчанию: None | Регистрация в определенной среде в целевой организации. Используется с Red Hat Satellite 6.x или Katello |
| force_register (добавлен в 2.2) | Значение по умолчанию: нет | Зарегистрировать систему, даже если она уже зарегистрирована |
| org_id (добавлен в 2.0) | Значение по умолчанию: None | Идентификатор организации для использования совместно с activationkey |
| password | Значение по умолчанию: None | пароль access.redhat.com или Sat6 |
| pool | Значение по умолчанию: ^$ | Укажите имя пула подписок для потребления. Поддерживаются регулярные выражения. Используйте pool_ids, если это возможно, так как это намного быстрее. Взаимоисключающие с pool_ids. |
| pool_ids (добавлен в 2.4) | Значение по умолчанию: [] | Укажите идентификаторы пулов подписок для потребления. Предпочтительнее pool, когда это возможно, так как это намного быстрее. Идентификатор пула может быть указан как string - только идентификатор пула (например, 0123456789abcdef0123456789abcdef), или как dict с идентификатором пула в качестве ключа и количеством в качестве значения (например, 0123456789abcdef0123456789abcdef: 2). Если количество указано, оно используется для потребления нескольких прав доступа из пула (пул должен поддерживать это). Взаимоисключающие с pool. |
| rhsm_baseurl | Укажите базовый URL 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) системы |
| username | Значение по умолчанию: None | логин 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
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие — поля, уникальные для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| subscribed_pool_ids сложный | success | Список идентификаторов пулов, к которым теперь подключена система | |
| 8a85f9815ab905d3015ab928c7005de4 | | ||
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Автор
- Барнаби Корт (@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.5/modules/redhat_subscription_module.html
