redhat_subscription - Управление регистрацией и подписками на RHSM с помощью команды subscription-manager
- Обзор
- Требования (на хосте, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Обзор
- Управление регистрацией и подпиской на платформу лицензирования Red Hat Subscription Management с использованием команды
subscription-manager
Требования (на хосте, на котором выполняется модуль)
- subscription-manager
Параметры
| параметр | обязательно | по умолчанию | возможные значения | комментарии |
|---|---|---|---|---|
| activationkey | нет | укажите ключ активации для использования при регистрации | ||
| autosubscribe | нет | После успешной регистрации автоматически использовать доступные подписки | ||
| consumer_id (добавлено в 2.1)
| нет | Ссылается на существующий идентификатор потребителя для возобновления использования предыдущей регистрации для данной системы. Если сертификат идентичности системы утерян или поврежден, этот параметр позволяет продолжить использование предыдущей идентичности и подписок. По умолчанию идентификатор потребителя не указывается, и создается новый. | ||
| consumer_name (добавлено в 2.1)
| нет | Имя системы для регистрации, по умолчанию - имя хоста | ||
| consumer_type (добавлено в 2.1)
| нет | Тип устройства для регистрации, по умолчанию - система | ||
| environment (добавлено в 2.2)
| нет | Регистрация в определённой среде в целевой организации. Используется с Red Hat Satellite 6.x или Katello | ||
| force_register (добавлено в 2.2)
| нет | Зарегистрировать систему даже если она уже зарегистрирована | ||
| org_id (добавлено в 2.0)
| нет | Идентификатор организации для использования в сочетании с activationkey | ||
| password | нет | пароль access.redhat.com или Sat6 | ||
| pool | нет | ^$ | Укажите имя пула подписок для использования. Поддерживаются регулярные выражения. Используйте pool_ids, если это возможно, так как это намного быстрее. Взаимоисключающие с pool_ids. | |
| pool_ids (добавлено в 2.4)
| нет | Укажите идентификаторы пулов подписок для использования. Предпочтительнее pool, когда это возможно, так как это намного быстрее. Идентификатор пула может быть указан как string - только идентификатор пула (например, 0123456789abcdef0123456789abcdef), или как dict с идентификатором пула в качестве ключа и количеством в качестве значения (например, 0123456789abcdef0123456789abcdef: 2. Если количество указано, оно используется для потребления нескольких прав доступа из пула (пул должен поддерживать это). Взаимоисключающие с pool. | ||
| rhsm_baseurl | нет | Текущее значение из C(/etc/rhsm/rhsm.conf) по умолчанию | Укажите базовый URL CDN | |
| server_hostname | нет | Текущее значение из C(/etc/rhsm/rhsm.conf) по умолчанию | Укажите альтернативный сервер Red Hat Subscription Management или Sat6 | |
| server_insecure | нет | Текущее значение из C(/etc/rhsm/rhsm.conf) по умолчанию | Включить или отключить проверку сертификата безопасности сервера HTTPS при подключении к server_hostname
| |
| server_proxy_hostname (добавлено в 2.4)
| нет | Текущее значение из C(/etc/rhsm/rhsm.conf) по умолчанию | Укажите имя хоста HTTP-прокси | |
| server_proxy_password (добавлено в 2.4)
| нет | Текущее значение из C(/etc/rhsm/rhsm.conf) по умолчанию | Укажите пароль для HTTP-прокси с базовой аутентификацией | |
| server_proxy_port (добавлено в 2.4)
| нет | Текущее значение из C(/etc/rhsm/rhsm.conf) по умолчанию | Укажите порт HTTP-прокси | |
| server_proxy_user (добавлено в 2.4)
| нет | Текущее значение из C(/etc/rhsm/rhsm.conf) по умолчанию | Укажите пользователя для HTTP-прокси с базовой аутентификацией | |
| state | нет | present |
| необходимо ли зарегистрировать и подписаться ( present), или отменить регистрацию (absent) системы |
| username | нет | имя пользователя access.redhat.com или Sat6 |
Примеры
- name: Register as user (joe_user) with password (somepass) and auto-subscribe to available content.
redhat_subscription:
state: present
username: joe_user
password: somepass
autosubscribe: 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
autosubscribe: yes
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для этого модуля:
| имя | описание | возвращается | тип | пример | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| subscribed_pool_ids | Список идентификаторов пулов, к которым система теперь подписана | успешно | сложный | |||||||||||
| содержит: |
| |||||||||||||
Примечания
Примечание
- Для регистрации системы subscription-manager требует либо имя пользователя и пароль, либо ключ активации и идентификатор организации.
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Для получения помощи в разработке модулей, если вы заинтересованы, пожалуйста, прочтите Информация о сообществе и участие, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/redhat_subscription_module.html