10.17. テンプレートリポジトリーの同期

手順

1. Satellite Web UI で、ホスト > テンプレートの同期 に移動します。
2. インポート をクリックします。
3. 各フィールドには、管理 > 設定 > TemplateSync で設定された値が入力されます。インポートするテンプレートに従って値を変更します。各フィールドの詳細は、「TemplateSync プラグインの設定」 を参照してください。
4. Submit をクリックします。

手順

1. Satellite Web UI で、ホスト > テンプレートの同期 に移動します。
2. エクスポート をクリックします。
3. 各フィールドには、管理 > 設定 > TemplateSync で設定された値が入力されます。エクスポートするテンプレートに従って値を変更します。各フィールドの詳細は、「TemplateSync プラグインの設定」 を参照してください。
4. Submit をクリックします。

CLI 手順

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   テンプレートをエクスポートする際に、バックエンドサービスが systemd プライベートの一時ディレクトリーで実行されるため、/tmp や /var/tmp などの一時ディレクトリーは回避してください。

手順

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

   Copy to Clipboard Toggle word wrap

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

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

   # sudo -u foreman ssh-keygen

   Copy to Clipboard Toggle word wrap
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"}

   Copy to Clipboard Toggle word wrap

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”}

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap
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"}

   Copy to Clipboard Toggle word wrap

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”}

   Copy to Clipboard Toggle word wrap

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