community.general.redhat_subscription – Управление регистрацией и подписками на RHSM с помощью команды subscription-manager
Примечание
Этот плагин является частью коллекции community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач укажите: community.general.redhat_subscription.
Описание
- Управление регистрацией и подпиской на платформу подписок Red Hat Subscription Management с помощью команды
subscription-manager
Требования
Ниже приведены требования к хосту, на котором будет выполняться этот модуль.
- subscription-manager
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| activationkey строка | укажите ключ активации для использования при регистрации | ||
| auto_attach логическое |
| После успешной регистрации автоматически потребляются доступные подписки Добавлена вместо устаревшей autosubscribe в версии 2.5. псевдонимы: autosubscribe | |
| consumer_id строка | Ссылается на существующий идентификатор потребителя, чтобы возобновить использование предыдущей регистрации для этой системы. Если сертификат идентификации системы утерян или поврежден, этот параметр позволяет возобновить использование ее предыдущей идентификации и подписок. По умолчанию идентификатор потребителя не указывается, поэтому создается новый. | ||
| consumer_name строка | Имя системы для регистрации, по умолчанию — имя хоста | ||
| consumer_type строка | Тип единицы для регистрации, по умолчанию — system | ||
| environment строка | Регистрация в определенной среде в целевой организации. Используется с Red Hat Satellite 6.x или Katello | ||
| force_register логическое |
| Зарегистрировать систему даже если она уже зарегистрирована | |
| 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) системы | |
| syspurpose словарь | По умолчанию: {} | Установить атрибуты syspurpose в файле /etc/rhsm/syspurpose/syspurpose.json и синхронизировать эти атрибуты с сервером RHSM. Атрибуты syspurpose помогают автоматически назначать наиболее подходящие подписки к системе. Если файл syspurpose.json уже содержит некоторые атрибуты, новые атрибуты перезапишут существующие. Если какой-либо атрибут отсутствует в новом списке атрибутов, существующий атрибут будет удален из файла syspurpose.json. Неизвестные атрибуты игнорируются. | |
| addons список / элементы=строка | Атрибуты addons syspurpose | ||
| role строка | Атрибут syspurpose role | ||
| service_level_agreement строка | Атрибут syspurpose service_level_agreement | ||
| sync логическое |
| Когда этот параметр равен 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.
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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/redhat_subscription_module.html