第3章 コンテンツのライフサイクルの管理

ライフサイクル環境は、コンテンツライフサイクルのステージを表します。本セクションでは、hammer を使用してライフサイクル環境を表示、作成する方法を説明します。デフォルトでは、組織ごとにライブラリー環境が存在します。以下の構文を使用して、新しいライフサイクル環境を作成します。

$ hammer lifecycle-environment create \
--name env_name \
--description "env_description" \
--organization-label org_label \
--prior prior_env_name

$ hammer lifecycle-environment create \
--name Development \
--description "Initial testing" \
--organization $ORG \
--prior Library

既存のライフサイクル環境を表示するには、以下のコマンドを実行します。

$ hammer lifecycle-environment list --organization-label org_label

上記のコマンドの出力は以下のようになります。

---|-------------|------------
ID | NAME        | PRIOR
---|-------------|------------
2  | Library     |
5  | Development | Library
6  | Testing     | Development
---|-------------|------------

ライフサイクル環境に関するコマンドの情報は、hammer lifecycle-environment --help を参照してください。

コンテンツビューとは、ライブラリーからのコンテンツのサブセットで、インテリジェントフィルターで作成されます。コンテンツビューは、さまざまな用途 (通常は開発、QA、実稼働環境) でコンテンツを利用できるように、ライフサイクル環境に公開してプロモートすることができます。

$ hammer content-view create \
--name cv_name \
--repository-ids repo_ID1,repo_ID2,repo_ID3 \
--description "cv_description" \
--organization-label org_label

--repository-ids オプションは、選択したリポジトリーをコンテンツビューに追加して、hammer repository list コマンドを使用して ID を検索します。このオプションを省略して空のコンテンツビューを作成し、後でサブコマンド update または add-repository を使用して変更することもできます。

$ hammer content-view create \
--name cv-rhel7-server \
--repository-ids 1,2,3 \
--description "Initial CV for RHEL 7" \
--organization $ORG

$ hammer content-view create \
--name ccv-rhel7-server-scl \
--description "CCV for RHEL7 and Software Collections" \
--organization $ORG \
--composite --component-ids 2,6 \
--auto-publish yes

コンテンツビューに追加可能なコンテンツビューは、RPM パッケージ、Puppet モジュール、Docker イメージの 3 つです。

$ hammer content-view update \
--repository-ids repo_ID1,repo_ID2... \
--name cv_name \
--organization-label org_label

$ hammer content-view add-repository \
--organization-label org_label \
--name cv_name \
--repository-id repo_ID

$ hammer content-view filter create \
--type rpm \
--name exclude-emacs \
--description "Excluding emacs package" \
--inclusion false \
--organization $ORG \
--repository-ids 1,2,3 \
--content-view cv-rhel7-server

$ hammer content-view filter rule create \
--name "emacs*" \
--organization $ORG \
--content-view cv-rhel7-server \
--content-view-filter exclude-emacs

$ hammer content-view filter rule list \
--content-view cv-rhel7-server \
--content-view-filter exclude-emacs \
--organization $ORG

$ hammer content-view filter create \
--type erratum \
--name limit-errata-by-date \
--description "Excluding errata by date" \
--inclusion false \
--organization $ORG \
--repository-ids 1,2,3 \
--content-view cv-rhel7-server

$ hammer content-view filter rule create \
--end-date YYYY-MM-DD \
--organization $ORG \
--content-view cv-rhel7-server \
--content-view-filter limit-errata-by-date \
--types enhancement,bugfix,security

$ hammer content-view puppet-module add \
--content-view cv_name \
--name module_name

$ hammer repository upload-content --path image_archive --id repo_id

コンテンツビューを公開し、ホストから利用できるようにします。以下のコマンドを使用して選択したコンテンツビューを公開します。

$ hammer content-view publish \
--id cv_ID \
--organization-label org_label \
--async

hammer content-view list コマンドを実行し、公開するコンテンツビューのcv_ID を確認します。公開したコンテンツビューはライブラリー環境で利用できます。コンテンツビューのステータスを確認するには、以下のコマンドを実行します。

$ hammer content-view info --id cv_ID

プロモーションとは、別のライフサイクル環境にコンテンツビューを移動することです。これには以下のコマンドを実行します。

$ hammer content-view version promote \
--content-view cv_name \
--organization-label org_label \
--to-lifecycle-environment env_name

ここで、env_name は移行後のライフサイクル環境名を示します。

ORG="ACME"
CV_ID=1

for i in $(hammer --csv lifecycle-environment list --organization $ORG | grep -vi '^ID' | awk -F, {'print $1'} | sort -n)
do
   hammer content-view version promote --organization $ORG --to-lifecycle-environment-id $i --id $CV_ID
done

$ hammer content-view version info --id 1

増分更新では、ライフサイクル環境で新規コンテンツビューのバージョンをプロモートしなくても、公開されているコンテンツビューを変更できます。増分更新の結果、新規コンテンツビューのマイナーバージョンが作成されます。増分更新は、緊急時に素早く更新するのに有用です。エラータ、パッケージ、または Puppet モジュールの追加に増分更新を使用できます。

コンテンツビューに新規パッケージを追加する増分更新を作成するには、以下を実行します。

$ hammer content-view version incremental-update \
--content-view-version-id cv_ID \
--packages pkg_name1,pkg_name2 \
--lifecycle-environment-ids env_ID1, env_ID2,... \
--organization-id org_ID

hammer content view version list の出力でコンテンツビューのバージョン ID を検索します。--packages オプションでパッケージを指定する代わりに、--puppet-modules で Puppet モジュールを、--errata-ids でエラータを追加できます (例3.8「増分更新を使用してコンテンツビューにエラータを追加する手順」を参照します)。増分更新との連携についての情報は hammer content-view version incremental-update --help を参照してください。

$ hammer content-view version incremental-update \
--content-view-version-id 4 \
--errata-ids 8c3801f6-12a7-4a62-83f4-addbb1f34ce6 \
--lifecycle-environments Infrastructure \
--organization $ORG