nycrecords.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プロバイダーの組織IDrhsm_activationkey
- RHSMプロバイダーのアクティベーションキーrhsm_server_hostname
- 代替RHSMプロバイダーのホスト名rhsm_server_insecure
- RHSMプロバイダーへの接続時に証明書の検証を無効にする (bool, デフォルトはfalse)rhsm_baseurl
- Red Hat CDNを使用しない場合のパッケージリポジトリの代替ベースURLrhsm_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
- 消費するプールIDのリスト、またはプールIDをキー、消費する権利の数量を値とする辞書のリスト。rhsm_pool
と排他的です。rhsm_consumer_type
- 登録するユニットの種類 (デフォルトは「system」)rhsm_consumer_name
- 登録するシステムの名前 (デフォルトはシステムのホスト名)rhsm_consumer_id
- 以前の登録を再開するための既存の消費者IDrhsm_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
- 現在システムに接続されているプールIDのリスト。プールが接続されていない場合、またはシステムが現在登録されていない場合は空のリストになります。
依存関係
subscription-manager
のインストールと使用をサポートするシステムが必要です。例:Red Hat Enterprise Linux。
このロールを機能させるには、特権の昇格(sudo)が必要です。
例のプレイブック
この例では、ユーザー名とパスワードでシステムを登録し、自動的に接続し、3つのRHEL 7リポジトリを有効にし、有効なリポジトリのリリースバージョンを「7Server」に明示的に設定します。
- hosts: rhsm-servers
roles:
- role: rhsm
vars:
rhsm_username: your_username
rhsm_password: your_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
この例では、組織IDとアクティベーションキーを使用してシステムをRed Hat Satellite 6に登録し、特定のプールにIDで接続します。
- hosts: rhsm-servers
roles:
- role: rhsm
vars:
rhsm_org_id: your_organization_id
rhsm_activitionkey: activation_key
rhsm_pool_ids:
- poolid
rhsm_server_hostname: your.satellite6.hostname
RHSMプロバイダーとして使用する場合は、Satellite 6またはKatelloホストにCA証明書を最初にインストールする必要があります。
ライセンス
著者情報
Joel Castillo (@joelbcastillo) ニューヨーク市記録局開発チーム (@nycrecords) のため
Sean Myers 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.rhsm