2.3.9 hosts_templateファイル

デプロイしたホストに配布するhostsファイルのテンプレートです。

csdtmpregisterコマンドで登録するコンポーネントテンプレートに付属するファイルの1つです。

csdmireserveコマンド実行時にリソース予約完了したIPアドレスと仮想ホスト名が書き加えられhostsファイルが作成されます。

このファイルにはPaaS提供者が使用したい任意のIPアドレス・ホスト名を書いてください。

リソース予約機能の実行時に読み込まれ,リソース予約完了した全VMのIPアドレス,仮想ホスト名を追記していきuCSD用のhostsファイル(hostsファイルA)を作成します。

なお,このファイルはOSのhostsファイルの記述方式に従って作成してください。

<この項の構成>
(1) uCSD追記内容
(2) hostsファイル作成
(3) hostsファイル作成後のデプロイの動作
(4) hostsファイルの作成に失敗した場合の回復手順

(1) uCSD追記内容

uCSDがhostsに追記するホスト名は次のとおりとします。

また,hostsに記載するIPアドレスは次のとおりとします。

フォーマットは次のとおり半角スペース1個区切りとします。

(例)マスターイメージに,次の仮想ホストが存在する場合
  • host1(1.1.1.1(M), 2.1.1.1(B), 3.1.1.1(B))
  • host2(1.1.1.2(M), 2.1.1.2(B))
  • host3(1.1.1.3(M))
hostsファイルA(host1用)追記内容:
1.1.1.1△host1△host1-m0
2.1.1.1△host1-b0
3.1.1.1△host1-b1
2.1.1.2△host2-b0
1.1.1.3△host3-m0
hostsファイルA(host2用)追記内容:
1.1.1.2△host2△host2-m0
2.1.1.1△host1-b0
3.1.1.1△host1-b1
2.1.1.2△host2-b0
1.1.1.3△host3-m0
hostsファイルA(host3用)追記内容:
1.1.1.3△host3△host3-m0
2.1.1.1△host1-b0
3.1.1.1△host1-b1
2.1.1.2△host2-b0
 
(凡例)
△:半角スペース1文字
X:整数(0~構成パターンテンプレートで定義したNIC数-1)

(2) hostsファイル作成

csdmideployコマンド実行時に,構築が成功した仮想ホストに対して,uCSDが作成したhostsファイルから,仮想ホストのhostsファイルを作成します。

その際,仮想ホストを構築するための仮想イメージテンプレートに付随するhostsファイル(hostsファイルB)のバックアップを次のディレクトリに保存します。なお,次のディレクトリと同一名称のディレクトリ,またはファイルを作成しないでください。

hostsファイルBにhostsファイルAの内容を追記し,仮想ホストに配布するhostsファイルを作成します。

hostsファイルに上記以外の変更を加えたい場合には,次の手順を実行してください。

  1. hostsファイルBを書き換えるスクリプトを用意し,マスターイメージ定義ファイルのOSのパッチ情報に指定する。
  2. 仮想ホストの構築前ならcsdmideployコマンドを,構築後ならcsdmiupdateコマンドを実行する。
注※
仮想ホストに,hostsファイルBのバックアップファイルが存在する場合には,バックアップファイルも書き換えるようにスクリプトを作成してください。

マスターイメージ定義ファイルのOSのパッチ情報の指定については「2.4.1 マスターイメージ定義ファイル」を参照してください。

配布されたhostsファイルは,仮想ホスト上に次のファイルとして保存されます。

(3) hostsファイル作成後のデプロイの動作

hostsファイル作成後のデプロイの動作は次のようになります。

項番hostsファイル作成の
実行結果
hostsファイル作成後の動作デプロイ完了後の
業務システムstatus
1デプロイ対象のすべての仮想ホストでhostsファイル作成に成功した場合構築処理を継続
(ミドルウェアセットアップ処理は実行する)
deployed
※ 最終的なステータスはミドルウェアセットアップ処理の成否によって決定
2デプロイ対象の仮想ホストのうち1つ以上,hostsファイル作成に失敗した場合構築処理を中断
(ミドルウェアセットアップ処理は実行しない)
failed(deploy)
3デプロイ対象のすべての仮想ホストに対するhostsファイル作成が失敗した場合構築処理を中断
(ミドルウェアセットアップ処理は実行しない)
failed(deploy)

(4) hostsファイルの作成に失敗した場合の回復手順

hostsファイル作成の実行結果は,uCSDのコマンド(csdmils)で確認できます

hostsファイル作成に失敗した場合は,uCSDのメッセージログにKFUD25006-Eが出力されます。

デプロイ終了後,メッセージログにKFUD25006-Eが出力された場合,次の手順でhostsファイルを再作成してください。

注※ hostsファイル作成失敗の場合,必ず業務システムstatusはfailed(deploy)に遷移します。

回復手順
  1. hostsファイル作成に失敗した原因を取り除く
  2. csdmiundeployコマンドで仮想ホストをアンデプロイする
  3. csdmideployコマンドを再度実行する
注※ この手順は省略できます。