付録D Satellite Server 間でのコンテンツ同期

Satellite 間の同期 (ISS) は、pulp_export_destination にあるようにデフォルトで /var/lib/pulp/katello-export/ ディレクトリーを使用します。このディレクトリーを変更するには、新規ディレクトリーを作成して Pulp エクスポート先を設定する必要があります。これを指定できるのは Satellite の管理者のみで、Satellite が任意のファイルシステムに書き込みしないように SELinux とその他のパーミッションも設定されています。

よく使用されるディレクトリーは、エクスポート後にシンボリックリンクを作成すると便利です。エクスポートされるリポジトリーと CV にはリポジトリーディレクトリー構造の前に組織名と環境名が付けられるので、パスが長すぎることになりかねません。

コマンドラインでエクスポート先を変更するには、以下のフォーマットで hammer コマンドを使用します。

# hammer settings set \
--name pulp_export_destination \
--value your-export-directory

例えば、エクスポート先に /var/www/html/pub/export/ を指定するには、以下を入力します。

# hammer settings set \
--name pulp_export_destination \
--value /var/www/html/pub/export

Web UI をご利用の場合

ISS では ダウンロードポリシー を 即時 に設定する必要があります。これをグローバルに設定すると、すべての組織で作成される新規リポジトリーに適用されます。または、各リポジトリーに個別に設定することもできます。デフォルト値を変更しても既存設定は変更されます。

グローバルでデフォルトのダウンロードポリシーを変更するには、以下のコマンドを使用します。

# hammer settings set \
--name default_download_policy \
--value immediate

特定のリポジトリーのポリシーを変更する場合は、組織のリポジトリーを以下のコマンドで一覧表示できます。

# hammer repository list \
--organization-label <organization-label>

既存のリポジトリーのダウンロードポリシーを変更するには、以下のコマンド使用します。

# hammer repository update \
--organization-label <organization-label>  \
--product "Red Hat Enterprise Linux Server" \
--name "Red Hat Enterprise Linux 7 Server Kickstart x86_64 7.2"  \
--download-policy immediate

アップストリームサーバーからのコンテンツのエクスポートには hammer repository export コマンドを使用します。このコマンドは、pulp_export_destination で指定されているディレクトリーにコンテンツをエクスポートします。ISS ではデフォルトでディレクトリーにエクスポートします。--export-to-iso 1 パラメーターを使用すると、ディレクトリーではなく ISO ファイルにエクスポートすることができます。例を示します。

# hammer repository export --id 1 [--export-to-iso 1]

リポジトリーはすべて、コンテンツビューバージョンでディレクトリーにエクスポートすることができます。つまり、特定の CV に要件に合うようなラベル付けをすることで (例えば "Repos to Export")、整理が容易になります。これはすべてが単一のディレクトリー内にあるためです。これでエクスポートのトラッキングと更新が容易になります。

$ hammer content-view version list \
--organization "Organization_Name"
---|----------------------|---------|-----------------------
ID | NAME                 | VERSION | LIFECYCLE ENVIRONMENTS
---|----------------------|---------|-----------------------
14 | cdn.megacorp.com 1.0 | 1.0     | Library, Production
---|----------------------|---------|-----------------------

# hammer content-view version export --id 14

エクスポートディレクトリーにリンクを追加すると、サブスクリプション URL での使用が容易になります。例を示します。

$ tree megacorp-cdn_megacorp_com-v1.0
megacorp-cdn_megacorp_com-v1.0
|-- megacorp
    |-- content_views
    |   |-- cdn_megacorp_com
    |   |   |-- 1.0

バージョンディレクトリーへのシンボリックリンクを作成し、そのリンクを使用します。

$ ln -s megacorp-cdn_megacorp_com-v1.0/megacorp/ \
content_views/cdn_megacorp_com/1.0 cdn-latest

サブスクリプション CDN URL がエクスポート元をポイントするように設定するには、シンボリックリンクを使用します。

$ hammer organization update \
--name "Mega Subsidiary" \
--redhat-repository-url \
http://megacorp.com/pub/cdn-latest

Organization updated

最新の更新を受信する際に、Satellite Server から大型リポジトリーのエクスポートを回避するには、増分更新を利用する方法があります。これは、特定の日時以降に 1 つ以上の同期イベントごとになされたローカルのリポジトリーへの変更をエクスポートするものです。

増分更新のリポジトリーを作成するには、hammer repository export コマンドで --since オプションを使用します。例を示します。

# hammer repository export \
--id 1 [--export-to-iso 1]  \
--since [ <ISO_Date> ]

ここでの ISO_Date は 2010-01-01T12:00:00Z のような ISO 8601 形式になります。

計算に使用されるタイムスタンプは、RPM Satellite Server で同期された時間です。例えば、Red Hat が月曜日に RPM をリポジトリーに追加して水曜日に再度追加したとすると、木曜日にはローカルリポジトリーの同期はできず、火曜日の日付を使って水曜日分の更新のみが得られます。

変更をリポジトリーに追加するほかに、この機能は Default Organization View のコンテンツビューで便利ですが、公開済み CV ではそれほど活用できません。

増分エクスポートから同期する際には、--incremental オプションを hammer repository synchronize コマンドで使用するようにしてください。このオプションを使用せず、リポジトリーの "Mirror on Sync" が有効になっていると、Satellite Server はインポートを完全なインポートとして扱い、増分エクスポートにない全データを消去してしまいます。このようなシナリオからリカバリーするには、完全なエクスポートとそこからの同期という時間のかかるものになります。

この方法は、ダウンストリームサーバーで hammer repository sync コマンドを使用するもので、カスタムまたは増分コンテンツをインポートする場合に必要になります。

ダウンストリームサーバーにコンテンツをインポートする前に、何がエクスポートされたかを確認します。アップストリームサーバーで hammer repository-set list コマンドを実行し、エクスポートされたものを確認します。例を示します。

$ hammer repository-set list \
--organization "Mega Subsidiary" \
--product "Red Hat Enterprise Linux Server" \
| grep kickstart

1952 | kickstart | Red Hat Enterprise Linux 6 Server (Kickstart)
1951 | kickstart | Red Hat Enterprise Linux 5 Server (Kickstart)
2455 | kickstart | Red Hat Enterprise Linux 7 Server (Kickstart)