第12章 テンプレートリポジトリーの同期

1. Satellite Server でプラグインを有効化するには、以下のコマンドを入力します。

   # satellite-installer --enable-foreman-plugin-templates

2. プラグインが適切にインストールされていることを確認するには、管理 > 設定 に TemplateSync メニューがあることを確認します。

1. SSH 認証を使用するバージョン管理システムを設定します (gitosis、gitolite、git デーモンなど)。

2. TemplateSync タブで TemplateSync プラグイン設定を設定します。

   1. Branch 設定を変更して、Git サーバーへのターゲットブランチに一致します。
   2. Git リポジトリーに一致するように、Repo 設定を変更します。たとえば、git@git.example.com/templates.git に置いたリポジトリーに対して、設定を ssh://git@git.example.com/templates.git に設定します。

3. Git SSH ホストキーを foreman ユーザーとして受け取ります。

   # sudo -u foreman ssh git.example.com

   SSH 接続が成功していないため、出力に Permission denied, please try again. メッセージが表示されることが期待されます。

4. SSH 鍵ペアがない場合は作成します。パスフレーズは指定しないでください。

   # sudo -u foreman ssh-keygen

5. Satellite の公開鍵を使用してバージョン管理サーバーを設定します。公開鍵は、/usr/share/foreman/.ssh/id_rsa.pub にあります。

6. Satellite Server から、TemplateSync メニューに指定したバージョン管理リポジトリーにテンプレートをエクスポートします。

   $ curl -H "Accept:application/json,version=2" \
   -H "Content-Type:application/json" \
   -u login:password \
   -k https://satellite.example.com/api/v2/templates/export \
   -X POST
   
   {"message":"Success"}

7. コンテンツを変更したら、テンプレートを Satellite Server にインポートします。

   $ curl -H "Accept:application/json,version=2" \
   -H "Content-Type:application/json" \
   -u login:password \
   -k https://satellite.example.com/api/v2/templates/import \
   -X POST
   
   {“message”:”Success”}

   Satellite が提供するテンプレートがロックされ、デフォルトではインポートできない点にご留意ください。この動作を上書きするには、TemplateSync メニューの Force import 設定を yes に変更するか、force パラメーター -d '{ "force": "true" }’ を import コマンドに追加します。

1. テンプレートを保存するディレクトリーを作成し、適切なパーミッションおよび SELinux コンテキストを適用します。

   # mkdir -p /usr/share/templates_dir/
   # chown foreman /usr/share/templates_dir/
   # chcon -t httpd_sys_rw_content_t /usr/share/templates_dir/ -R

2. TemplateSync タブで Repo 設定を変更し、エクスポートディレクトリー /usr/share/templates_dir/ に一致させます。

3. Satellite Server からローカルディレクトリーにテンプレートをエクスポートします。

   $ curl -H "Accept:application/json,version=2" \
   -H "Content-Type:application/json" \
   -u login:password \
   -k https://satellite.example.com/api/v2/templates/export \
   -X POST \
   
   {"message":"Success"}

4. コンテンツを変更したら、テンプレートを Satellite Server にインポートします。

   $ curl -H "Accept:application/json,version=2" \
   -H "Content-Type:application/json" \
   -u login:password \
   -k https://satellite.example.com/api/v2/templates/import \
   -X POST
   
   {“message”:”Success”}

   Satellite が提供するテンプレートがロックされ、デフォルトではインポートできない点にご留意ください。この動作を上書きするには、TemplateSync メニューの Force import 設定を yes に変更するか、force パラメーター -d '{ "force": "true" }’ を import コマンドに追加します。

手順

1. Git リポジトリーのローカルコピーをクローンします。

   $ git clone https://github.com/theforeman/community-templates /custom/templates

2. 以下のコマンドで、ローカルディレクトリーの所有者を foreman ユーザーに変更し、SELinux コンテキストを変更します。

   # chown -R foreman:foreman /custom/templates
   # chcon -R -t httpd_sys_rw_content_t /custom/templates

3. テンプレートをローカルリポジトリーにエクスポートするには、以下のコマンドを実行します。

   hammer export-templates --organization 'Default Organization' --repo /custom/templates

1. Satellite インストーラーを使用するプラグインを無効にします。

   # satellite-installer --no-enable-foreman-plugin-templates

2. プラグインのカスタムデータを削除します。このコマンドは、作成したテンプレートには影響しません。

   # foreman-rake templates:cleanup

3. プラグインをアンインストールします。

   # yum remove tfm-rubygem-foreman_templates