この役割は廃止されました: oasis_roles.system Ansibleコレクションのバージョンをご利用ください

RHSM

この役割は subscription-manager を使用してシステムを登録または登録解除し、サブスクリプションを通じて利用可能なリポジトリを有効または無効にすることができます。

要件

Ansible 2.8以上

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プロバイダーの組織ID
• rhsm_activationkey - RHSMプロバイダーのアクティベーションキー
• rhsm_server_hostname - 代替RHSMプロバイダーのホスト名
• rhsm_server_insecure - RHSMプロバイダーに接続する際の証明書検証を無効にする (bool, デフォルトはfalse)
• rhsm_baseurl - Red Hat CDNを使用しない場合のパッケージリポジトリの代替ベースURL
• rhsm_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 - 消費する特定のプール名 (正規表現を入力として使用可)。可能な限り rhsm_pool_ids を使用することで、より高速になります。rhsm_pool_ids と排他的です。
• rhsm_pool_ids - 消費するプールIDのリスト、またはプールIDをキーとし、消費するエンタイトルメントの数を値とする辞書のリスト。rhsm_pool と排他的です。
• rhsm_consumer_type - 登録するユニットのタイプ (デフォルトは「system」)
• rhsm_consumer_name - 登録するシステムの名前 (デフォルトはシステムのホスト名)
• rhsm_consumer_id - 以前の登録を再開するための既存の消費者ID
• rhsm_force_register - 既に登録されている場合でもシステムを登録する (bool, デフォルトはfalse)
• rhsm_syspurpose - RHEL 8システム上の syspurpose.json ファイルを生成するための属性の辞書 (ansible>=2.9が必要)
• rhsm_unregister - trueの場合、システムを登録解除します。この場合、システムは登録解除されます。これがtrueの場合、システム登録は試行されません (bool, デフォルトはfalse)

リポジトリ管理

注意：

リポジトリ管理に関連する変数を使用すると、システムが未登録の場合に役割が失敗を報告することがあります。サブスクリプションタスクは、これらの変数を処理する前に、正しい登録状態を確保するためにリポジトリ管理タスクの前に実行されます。

• rhsm_release - 使用するオペレーティングシステムのリリースバージョンを設定します。YAMLパーサーにとって浮動小数点数のように見えるリリースバージョンには、値を "7.4" のように引用符で囲んでください。6Serverや7Serverのような値は引用する必要はありません。
• rhsm_release_unset - 使用するオペレーティングシステムのリリースバージョンを解除する (bool, デフォルトはfalse)
• rhsm_repositories - 有効/無効にするリポジトリを指定します。

rhsm_release と rhsm_release_unset の両方が設定されている場合、rhsm_release_unset は rhsm_release が設定される前に実行され、この役割はリリースを設定する際に冪等性を持たなくなります。

特定のリポジトリを有効/無効にするためには：

rhsm_repositories:
  enabled:
    - 有効なリポジトリ
  disabled:
    - 無効なリポジトリ

disabled にあるリポジトリのリストは、enabled の前に処理されます。

特定のリポジトリのみを有効にし、すべての他のリポジトリを無効にするために、disabled に '*' を設定することがサポートされています：

rhsm_repositories:
  disabled:
    - '*'
  enabled:
    - 有効なリポジトリ-1
    - 有効なリポジトリ-2

リポジトリ名でのグロビングもサポートされています。たとえば：

rhsm_repositories:
  disabled:
    - '*'
  enabled:
    - '有効なリポジトリ*'

使用するRHELリポジトリの特定のマイナーバージョンを設定するためには：

rhsm_release: "7.1"

リポジトリの最新のマイナーバージョンをデフォルトとして設定するには：

rhsm_release_unset: true

依存関係

subscription-manager のインストールと使用をサポートするシステムが必要です。例えば、Red Hat Enterprise Linuxです。

この役割が機能するためには特権昇格 (sudo) が必要です。

例のプレイブック

この例では、ユーザー名とパスワードでシステムを登録し、自動的に関連付けを行い、3つの 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

---

この例では、組織IDとアクティベーションキーを使用してRed Hat Satellite 6にシステムを登録し、特定のプールにIDで関連付けしています。

- hosts: rhsm-servers
  roles:
    - role: rhsm
  vars:
    rhsm_org_id: あなたの組織ID
    rhsm_activationkey: アクティベーションキー
    rhsm_pool_ids:
      - poolid
    rhsm_server_hostname: your.satellite6.hostname

RHSMプロバイダーとして使用する際は、Satellite 6またはKatelloホストのCA証明書を最初にインストールしてHTTPSが機能するようにしてください。

変更

rhsm_repositories.only 廃止

Ansible 2.8に purge パラメータが追加される前に、特定のリポジトリを有効にし、すべての他のリポジトリを無効にする際に冪等性を持たせるために、この役割では次の構文がサポートされていましたが、現在は廃止されています：

rhsm_repositories:
  only:
    - 有効なリポジトリ-1
    - 有効なリポジトリ-2

サブスクリプションマネージャーのより一般的な使用法をサポートする機能がこの役割に追加されているので、この操作は現在は冪等になります：

rhsm_repositories:
  disabled:
    - '*'
  enabled:
    - 有効なリポジトリ-1
    - 有効なリポジトリ-2

したがって、「一つの、そしてできれば唯一の、明らかな方法がある」ようにするために、rhsm_repositories 辞書内の only キーは廃止され、この役割の将来のリリースでサポートが削除される可能性があります。現在は後方互換性のためにこの役割に保持されています。

なお、only の使用は依然として、rhsm_repositories 辞書内の enabled または disabled の使用と相互排他的です。

Ansible >= 2.8が必要

この役割では、rhsm_repository Ansibleモジュールの新機能が使用されています。 古いバージョンのAnsibleを使用する場合は、この役割のバージョン2.0.0を使用できます。

# バージョン2.0.0をインストールするための例のrequirements.yaml
- name: oasis_roles.rhsm
  version: 2.0.0

ライセンス

GPLv3

著者情報

Sean Myers semyers@redhat.com