ホストグループ¶

本シナリオでは、簡単な例としてOSの設定を題材に Exastro IT Automation の基本操作を学習します。

詳しくはホストグループ機能を参照してください。

ホストグループ¶
ホストグループとは、ホスト群を論理的な単位（機能・役割）でまとめたグループのことを指します。¶

パラメータ設計¶

本シナリオで扱うパラメータシートの設定項目は、「タイムゾーンの設定」と「サーバ用パラメータ」、「ホスト名の設定」の3つです。

ここで検討すべきポイントは、

タイムゾーンの設定で作成したタイムゾーン名に対応する「UTC」と「JST」の設定方法です。

データシートの作成¶

パラメータの登録時に手入力をすると、タイプミスなどにより作業ミスが発生する可能性が高くなります。

パラメータの選択肢を作成することで、このようなパラメータの入力ミスを防止することができます。

まずは、タイムゾーンの設定をするために必要な、Timezone (タイムゾーン名) とタイムゾーンに設定する UTC と JST のデータシートを作成します。

具体的には、データシートを作成し、その中にタイムゾーンとして登録するパラメータを投入します。

データシート¶
Exastro IT Automation が使用する固定値のパラメータを管理するデータ構造のことです。¶

データシートを作成します。

パラメータシート作成 ▶ パラメータシート定義・作成から、データシートを登録します。

表 194 データシートの項目の設定値¶
設定項目	項目1設定値	項目2設定値	項目3設定値
項目の名前	`タイムゾーン`	`UTC`	`JST`
項目の名前(Rest API用)	`Timezone`	`UTC`	`JST`
入力方式	`文字列(単一行)`	`文字列(単一行)`	`文字列(単一行)`
最大バイト数	`64`	`32`	`32`
正規表現
初期値
必須	✓
一意制約	✓
説明
備考

表 195 データシート作成情報の設定値¶
項目名	設定値
項番	(自動入力)
パラメータシート名	`タイムゾーン一覧`
パラメータシート名(REST)	`Timezone_list`
作成対象	`データシート`
表示順序	`99999`
最終更新日時	(自動入力)
最終更新者	(自動入力)

データシート登録¶

パラメータリスト内に表示するパラメータを設定します。

入力用 ▶ タイムゾーン一覧から、タイムゾーン名とUTC、JSTを登録します。

表 196 状態の設定値¶
パラメータ
タイムゾーン	UTC	JST
`Asia/Tokyo`	`+9`	`0`
`America/New_York`	`-4`	`-13`

パラメータシートの作成¶

サーバのOS設定をする際に、1つの作業を複数のホストへ実行したい場合があると思います。

今回はホストグループという機能を使い、複数のホストへ一度に作業を実行する方法を紹介します。

パラメータシート作成 ▶ パラメータシート定義・作成から、「サーバ用パラメータ」と「ホスト名変更用」というパラメータシートを登録します。

まずは「サーバ用パラメータ」というパラメータシートを作成します。項目1の入力方式を プルダウン選択 に設定することで、データシートの作成で登録したデータシートを参照できるようになります。

表 197 パラメータ項目設定¶
設定項目	項目1設定値	項目2設定値
項目の名前	`タイムゾーン`	`Nameserver_ip`
項目の名前(Rest API用)	`Timezone`	`VAR_nameserver_ip`
入力方式	`プルダウン選択`	`文字列(単一行)`
最大バイト数	(項目なし)	`64`
正規表現	(項目なし)
選択項目	`入力用:タイムゾーン一覧:パラメータ/タイムゾーン`	(項目なし)
参照項目	`UTC、JST`	(項目なし)
初期値
必須
一意制約
説明
備考

表 198 パラメータシート作成情報の設定値¶
項目名	設定値
項番	(自動入力)
パラメータシート名	`サーバ用パラメータ`
パラメータシート名(REST)	`server_parameter`
作成対象	`パラメータシート（ホスト/オペレーションあり）`
表示順序	`1`
ホストグループ利用	「利用する」にチェックを入れる(有効)
最終更新日時	(自動入力)
最終更新者	(自動入力)

次に「ホスト名変更用」というパラメータシートを作成します。

表 199 パラメータ項目設定¶
設定項目	項目1設定値
項目の名前	`ホスト名`
項目の名前(Rest API用)	`VAR_hostname`
入力方式	`文字列(単一行)`
最大バイト数	`64`
正規表現
初期値
必須
一意制約
説明
備考

表 200 パラメータシート作成情報の設定値¶
項目名	設定値
項番	(自動入力)
パラメータシート名	`ホスト名変更用`
パラメータシート名(REST)	`Hostname_change`
作成対象	`パラメータシート（ホスト/オペレーションあり）`
表示順序	`2`
ホストグループ利用	「利用する」にチェックを入れない(無効)
最終更新日時	(自動入力)
最終更新者	(自動入力)

作業手順の登録¶

作業手順を登録するために、作業単位となるジョブ(Movement)を定義します。

定義した Movement に対して、Ansible Playbook を紐付け、更に Ansible Playbook 内の変数とパラメータシートの項目の紐付けを行います。

Movement 登録¶

Ansible-Legacy ▶ Movement一覧から、基本設定のための Movement を登録します。

表 201 Movement 情報の設定値¶
Movement名	Ansible利用情報
	ホスト指定形式	ヘッダーセクション
`set_timezone`	`IP`	`※ヘッダーセクションを参照`
`add_nameserver`	`IP`	`※ヘッダーセクションを参照`
`set_hostname`	`IP`	`※ヘッダーセクションを参照`

リスト 457 ヘッダーセクション¶

- hosts: all
  remote_user: "{{ __loginuser__ }}"
  gather_facts: no
  become: yes

Ansible Playbook 登録¶

本シナリオでは、「set_timezone.yml」と「add_nameserver.yml」、「set_hostname.yml」の3つのPlaybookを利用します。

以下をコピーして、それぞれのPlaybookをyml形式で作成してください。

リスト 458 set_timezone.yml¶

- name: Set Timezone
  timezone:
    name: "{{ VAR_locale_timezone }}"

リスト 459 add_nameserver.yml¶

- name: Add Nameserver
  lineinfile:
    dest: /etc/resolv.conf
    line: nameserver {{ VAR_nameserver_ip }}

リスト 460 set_hostname.yml¶

- name: Set a hostname
  ansible.builtin.hostname:
    name: "{{ VAR_hostname }}"

Ansible-Legacy ▶ Playbook素材集から、から、上記のPlaybookを登録します。

表 202 Ansible Playbook 情報の登録¶
Playbook素材名	Playbook素材
`set_timezone`	`set_timezone.yml`
`add_nameserver`	`add_nameserver.yml`
`set_hostname`	`set_hostname.yml`

Movement と Ansible Playbook の紐付け¶

Ansible-Legacy ▶ Movement-Playbook紐付から、Movement と Ansible Playbook の紐付けを行います。

表 203 Movement-Playbook紐付け情報の登録¶
Movement名	Playbook素材	インクルード順序
`set_timezone`	`set_timezone`	`1`
`add_nameserver`	`add_nameserver`	`1`
`set_hostname`	`set_hostname`	`1`

代入値自動登録設定¶

Ansible-Legacy ▶ 代入値自動登録設定から、作成したパラメータシートと Ansible Playbook 内の変数の紐付けを行います。

表 204 代入値自動登録設定の設定値¶
パラメータシート(From)		登録方式	Movement名	IaC変数(To)
メニューグループ:メニュー:項目	代入順序			Movement名:変数名	代入順序
`代入値自動登録用:サーバ用パラメータ:パラメータ/タイムゾーン`		`Value型`	`set_timezone`	`set_timezone:VAR_locale_timezone`
`代入値自動登録用:サーバ用パラメータ:パラメータ/Nameserver_ip`		`Value型`	`add_nameserver`	`add_nameserver:VAR_nameserver_ip`
`代入値自動登録用:ホスト名変更用:パラメータ/ホスト名`		`Value型`	`set_hostname`	`set_hostname:VAR_hostname`

ジョブフローの作成¶

複数の Movement を一連の作業として実行する方法に、Conductor という仕組みがあります。
Conductor を利用することで、複数の Movement をまとめて実行できるだけでなく、Movement の実行結果に応じて、後続処理を分岐させたり、ユーザ確認の為に一時停止するといった複雑なロジックを組み込む事が可能です。
Conductor ▶ Conductor編集/作業実行 から「サーバ基本設定」というジョブフローを定義します。

右上のペイン Conductor情報 ▶ 名称  に、 サーバ基本設定 と入力します。
右下のペインに、作成した set_timezone と add_nameserver  、 set_hostname の3つの Movement があります。これらを画面中央にドラッグアンドドロップします。
各 Node 間を下記の様に接続します。

表 205 Node 間の接続¶
OUT	IN
`Start`	`set_timezone`
`set_timezone`	`add_nameserver`
`add_nameserver`	`set_hostname`
`set_hostname`	`End`

4. 画面上部にある、  登録を押下します。

作業対象の登録¶

作業実施を行う対象機器の登録を行います。

機器登録¶

本シナリオでは計4台のサーバを登録します。下記登録を計4台分実施してください。

Ansible共通 ▶ 機器一覧から、作業対象であるサーバーの接続情報を登録します。

表 206 機器一覧の設定値¶
HW機器種別	ホスト名	IPアドレス	ログインパスワード	ssh鍵認証情報	Ansible利用情報
			ユーザ	ssh秘密鍵ファイル	Legacy/Role利用情報
					認証方式
`SV`	`dbA`	`192.168.0.1 ※適切なIPアドレスを設定`	`接続ユーザ名`	`(秘密鍵ファイル)`	`鍵認証(パスフレーズなし)`
`SV`	`dbB`	`192.168.0.1 ※適切なIPアドレスを設定`	`接続ユーザ名`	`(秘密鍵ファイル)`	`鍵認証(パスフレーズなし)`
`SV`	`webA`	`192.168.0.1 ※適切なIPアドレスを設定`	`接続ユーザ名`	`(秘密鍵ファイル)`	`鍵認証(パスフレーズなし)`
`SV`	`webB`	`192.168.0.1 ※適切なIPアドレスを設定`	`接続ユーザ名`	`(秘密鍵ファイル)`	`鍵認証(パスフレーズなし)`

Tip

今回のシナリオでは鍵認証で実行しますが、パスワード認証での実行も可能です。

認証方式は、作業対象サーバーへのログインの方法に応じて適宜変更してください。

オペレーション登録¶

作業概要の作成¶

具体的なパラメータの設定や作業手順を考える前に、作業計画を立てるところから初めます。

まずは、いつ、どこの機器に対して、何を、どうするかといった情報を簡単に整理しておきましょう。

表 207 作業の方針¶
作業実施日時	2024/04/01 12:00:00
作業対象	作業対象サーバー(RHEL8)
作業内容	基本設定_全台用

作業概要登録¶

オペレーション登録では、作業を実施する際の作業概要を定義します。オペレーションは各作業ごとに1つ作成します。オペレーションは使いまわさないようにしましょう。

先に決めた作業の方針を元にオペレーション情報を記入しましょう。

オペレーション¶
実施する作業のことで、オペレーションに対して作業対象とパラメータが紐づきます。¶

基本コンソール ▶ オペレーション一覧から、作業実施日時や作業名を登録します。

表 208 オペレーション登録内容¶
オペレーション名	実施予定日時
`基本設定_全台用`	`2024/04/01 12:00:00`

Tip

作業実施日時は、本シナリオでは適当な日時で問題ありませんが、作業日が定まっている場合は、正確な作業実施の予定日時を設定することを推奨します。

定期作業などの繰り返し行われる作業のように、作業日が定まっていない場合は現在の日時を登録しても問題ありません。