rhsm
Ansible Роль: RHSM
Эта роль зарегистрирует или отменит регистрацию системы с помощью subscription-manager
и также может включить или отключить репозитории, доступные по подписке.
Требования
Ansible 2.4 или выше
Red Hat Enterprise Linux 7 или эквивалент
Действующие подписки Red Hat
Переменные Роли
В данный момент поддерживаются следующие переменные:
Управление Подписками
Переменные в этом разделе соответствуют аргументам, доступным для модуля redhat_subscription.
rhsm_username
- имя пользователя access.redhat.com или Satellite (RHSM провайдер)rhsm_password
- пароль access.redhat.com или Satellite (RHSM провайдер)rhsm_org_id
- идентификатор организации RHSM провайдераrhsm_activationkey
- ключ активации RHSM провайдераrhsm_server_hostname
- имя хоста для альтернативного провайдера RHSMrhsm_server_insecure
- отключить проверку сертификатов при подключении к RHSM провайдеру (bool, по умолчанию false)rhsm_baseurl
- Альтернативный базовый URL репозиториев пакетов, если не используется Red Hat CDNrhsm_server_proxy_hostname
- имя хоста HTTP-проксиrhsm_server_proxy_port
- порт HTTP-проксиrhsm_server_proxy_user
- имя пользователя HTTP-проксиrhsm_server_proxy_password
- пароль HTTP-проксиrhsm_auto_attach
- автоматически использовать доступные подписки, если регистрация успешна (bool, по умолчанию false, требуется ansible >= 2.5)rhsm_environment
- Зарегистрироваться в определенной среде в целевой организации. (Используется с Red Hat Satellite 6 или Katello)rhsm_pool
- Конкретное имя пула для использования (можно использовать regex). Используйтеrhsm_pool_ids
, когда это возможно, так как это значительно быстрее. Взаимоисключающее сrhsm_pool_ids
rhsm_pool_ids
- Список идентификаторов пулов для использования или список словарей с идентификаторами пулов в качестве ключей и количеством прав на использование в качестве значений. Взаимоисключающее сrhsm_pool
rhsm_consumer_type
- Тип устройства для регистрации (по умолчанию "system")rhsm_consumer_name
- Имя системы для регистрации (по умолчанию имя хоста системы)rhsm_consumer_id
- Существующий идентификатор потребителя для возобновления предыдущей регистрацииrhsm_force_register
- Зарегистрировать систему, даже если она уже зарегистрирована (bool, по умолчанию false)rhsm_unregister
- Отменить регистрацию системы, если true. Система будет отменена. Регистрация системы не будет попытана (bool, по умолчанию false)
Управление Репозиториями
Примечание:
Использование переменных, относящихся к управлению репозиториями, может привести к тому, что роль сообщит о сбое, если система не зарегистрирована. Задачи по подписке выполняются до задач по управлению репозиториями для упрощения состояния регистрации перед обработкой этих переменных.
rhsm_release
- Установить, какую версию операционной системы использовать. Не забудьте заключить это в кавычки для версий релиза, которые выглядят как числа с плавающей запятой для парсера YAML, например, установите значение как"7.4"
, а не7.4
. Значения, такие как6Server
и7Server
, кавычек не требуют.rhsm_release_unset
- Снять установку, какую версию операционной системы использовать (bool, по умолчанию false)rhsm_repositories
- Указывает, какие репозитории включать или отключать, детали ниже
Чтобы включить/отключить конкретные репозитории:
rhsm_repositories:
enabled:
- enabled-repository
disabled:
- disabled-repository
Список репозиториев в disabled
обрабатывается перед enabled
.
Чтобы включить только конкретные репозитории и отключить все остальные:
rhsm_repositories:
only:
- enabled-repository-1
- enabled-repository-2
Использование only
является более удобным для идемпотентности вариантом следующего:
rhsm_repositories:
disabled:
- "*"
enabled:
- enabled-repository-1
- enabled-repository-2
Обратите внимание, что поддерживается использование подстановочных символов в именах репозиториев.
Использование only
несовместимо с использованием enabled
и disabled
, и использование only
имеет приоритет.
Чтобы установить конкретную минорную версию репозиториев RHEL для использования:
rhsm_release: "7.1"
Чтобы по умолчанию использовать последнюю доступную минорную версию репозиториев:
rhsm_release_unset: true
Вывод Роли
ПРЕДУПРЕЖДЕНИЕ О УСТАРЕВАНИИ Выводы роли устарели, больше не поддерживаются и будут удалены в будущей версии этой роли.
oasis_role_rhsm
Факт oasis_role_rhsm
будет установлен этой ролью и будет содержать следующие выходные данные:
subscribed
- Зарегистрирована ли система или нет. (bool)subscribed_pool_ids
- Список идентификаторов пулов, которые в настоящее время прикреплены к системе. Будет пустым списком, если нет прикрепленных пулов или если система в настоящее время не зарегистрирована.
Зависимости
Требует систему, которая поддерживает установку и использование subscription-manager
, например, Red Hat Enterprise Linux.
Для работы этой роли требуется повышение привилегий (sudo).
Примеры Playbook
Этот пример регистрирует систему с именем пользователя и паролем, автоматически прикрепляет, включает три репозитория RHEL 7 и явно устанавливает версию релиза репозиториев в "7Server".
- hosts: rhsm-servers
roles:
- role: rhsm
vars:
rhsm_username: ваше_имя_пользователя
rhsm_password: ваш_пароль
rhsm_auto_attach: true
rhsm_repositories:
only:
- rhel-7-server-rpms
- rhel-7-server-optional-rpms
- rhel-7-server-extras-rpms
rhsm_release: 7Server
Этот пример регистрирует систему в Red Hat Satellite 6, используя идентификатор организации и ключ активации и прикрепляет к конкретному пулу по идентификатору.
- hosts: rhsm-servers
roles:
- role: rhsm
vars:
rhsm_org_id: ваш_идентификатор_организации
rhsm_activationkey: ключ_активации
rhsm_pool_ids:
- poolid
rhsm_server_hostname: your.satellite6.hostname
CA сертификаты для хоста Satellite 6 или Katello должны быть установлены заранее, чтобы HTTPS работал при использовании в качестве RHSM провайдера.
Лицензия
Информация об авторе
Джоэль Кастильо (@joelbcastillo) для команды разработки Dепартамента записей NYC (@nycrecords)
Развита от Сэма Майерса semyers@redhat.com (oasis-roles/rhsm)
Role to setup subscription management on RedHat Enterprise Linux. Forked from https://github.com/oasis-roles/rhsm
ansible-galaxy install nycrecords/ansible-role-rhsm