redhat_subscription - Управление регистрацией и подписками на RHSM с помощью команды subscription-manager
Сводка
- Управление регистрацией и подпиской на платформу Red Hat Subscription Management с использованием команды
subscription-manager
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- subscription-manager
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| activationkey | указать ключ активации для регистрации | |
| auto_attach bool (добавлено в 2.5) |
| После успешной регистрации автоматически использовать доступные подписки Добавлена в качестве альтернативы устаревшему autosubscribe в версии 2.5. псевдонимы: autosubscribe |
| consumer_id (добавлено в 2.1) | Ссылка на существующий идентификатор потребителя для возобновления использования предыдущей регистрации для этой системы. Если сертификат удостоверения личности системы утерян или поврежден, этот параметр позволяет возобновить использование предыдущей идентификации и подписок. По умолчанию идентификатор потребителя не указан, и создается новый идентификатор. | |
| consumer_name (добавлено в 2.1) | Имя системы для регистрации, по умолчанию используется имя хоста | |
| consumer_type (добавлено в 2.1) | Тип устройства для регистрации, по умолчанию используется system | |
| environment (добавлено в 2.2) | Регистрация в конкретной среде в целевой организации. Используется с Red Hat Satellite 6.x или Katello | |
| force_register bool (добавлено в 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 | Укажите базовый 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 | имя пользователя 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 complex | успех | Список идентификаторов пулов, к которым система теперь подписана | |
| 8a85f9815ab905d3015ab928c7005de4 | | ||
Статус
Этот модуль помечен как предварительный просмотр, что означает, что его интерфейс не гарантирует обратную совместимость.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.
Список других модулей, которые также поддерживаются сообществом 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.6/modules/redhat_subscription_module.html