Exastro IT Automation の Setting samples(Hyper-Vモデル)を使ってみた

#関連リンク

Qiita記事
・[Exastro IT Automation クイックスタート (ver1.8.0)](https://qiita.com/y-masaya3210/items/68920237c03e5d4f4776)
※本記事では上記を参考にver1.9.0をインストールしています。

ITAコミュニティサイト
・[Exastro IT Automation コミュニティサイト](https://exastro-suite.github.io/it-automation-docs/setting-samples_ja.html#Hyper-V-model)
・[Hyper-Vモデル 概要](https://exastro-suite.github.io/SettingSamples-ITA-HyperV/setting-samples-hyperv-overview_ja.pdf)
・[Hyper-Vモデル 導入手順](https://exastro-suite.github.io/SettingSamples-ITA-HyperV/setting-samples-hyperv-install_ja.pdf)
・[GitHubリリースページ](https://github.com/exastro-suite/SettingSamples-ITA-HyperV/releases)
・[ITA_利用手順マニュアル エクスポート/インポート](https://exastro-suite.github.io/it-automation-docs/asset/Documents_ja/Exastro-ITA_利用手順マニュアル_エクスポート／インポート.pdf)
・[ITA_利用手順マニュアル Ansible-driver](https://exastro-suite.github.io/it-automation-docs/asset/Documents_ja/Exastro-ITA_利用手順マニュアル_Ansible-driver.pdf)


#はじめに
Setting samplesにHyper-Vモデル(ITAからHyper-V上に仮想マシンを作成する機能)が追加されていたので使ってみました。
今回は導入（インポート）～実行までをしていきます。
※Hyper-Vマネージャは下記リンクを参考に事前に有効化しておきます。
[Windows Server で HYPER-V の役割をインストールします。](https://docs.microsoft.com/ja-jp/windows-server/virtualization/hyper-v/get-started/install-the-hyper-v-role-on-windows-server)


#### Hyper-Vモデルイメージ
![5thモデル_Hyper-V_Qiita記事用_概要図.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/97c59d4d-3866-4a43-3027-e1bef03e2f90.png)

※より詳しいイメージは[Hyper-Vモデル 概要](https://exastro-suite.github.io/SettingSamples-ITA-HyperV/setting-samples-hyperv-overview_ja.pdf)を参照ください。

#今回紹介するシナリオ

本記事は下記の作業を一括でできるConductorを利用して、仮想マシンを2台作成するシナリオで進めていきます。

1. Hyper-Vマネージャー上に仮想マシンを作成
1. 作成した仮想マシンにIPアドレス設定
1. 作成した仮想マシンに仮想ハードディスクを追加
1. 作成した仮想マシンをITAの機器一覧へ登録


### 作成する仮想マシン情報

|仮想マシン名|CPUコア数|メモリ容量|仮想スイッチ名|IPアドレス|追加仮想ハードディスク名|追加仮想ハードディスク容量|
|---|---|---|---|---|---|---|
|Win10-Host1|2|4096MB|Internal-Network-1|192.168.1.100|data|20G|
|Win10-Host2|1|2048MB|Internal-Network-1|dhcp |なし|なし|

###準備/導入編
1. ITAのインストール
1. Setting samplesのインポート
1. Windowsリモート管理(WinRM)の有効化
1. テンプレートの準備
1. 仮想スイッチの準備

※コンテナ版を利用する場合は1～3の手順は不要です。
コンテナ版の利用方法は[こちら](https://hub.docker.com/r/exastro/settingsamples-servicenow)を参照してください。

###仕込編①マスタ情報登録
1. 仮想マシン名の登録
1. テンプレート情報の登録
1. 仮想スイッチ名の登録
1. IPアドレス情報の登録

###仕込編②仮想マシン操作
1. 機器一覧の登録
1. オペレーションの登録
1. 仮想マシン設定の登録
1. IPアドレス設定の登録
1. 仮想ハードディスク設定の登録


###実行編
1. Hyper-Vモデルの実行
1. 実行結果の確認

###おまけ
1. IPアドレス設定や仮想ハードディスク追加をしない場合
1. さらに仮想マシンを追加をする場合



# 準備/導入編
## 1. ITAのインストール
[Exastro IT Automation クイックスタート (ver1.8.0)](https://qiita.com/y-masaya3210/items/68920237c03e5d4f4776)を参考にITA ver1.9.0をインストールをしてください。

## 2．Setting samplesのインポート
### 2.1 Setting samplesのダウンロード
[GitHubリリースページ](https://github.com/exastro-suite/SettingSamples-ITA-HyperV/releases)からパッケージファイルをダウンロードします。
ダウンロードするファイル名は「setting-samples-hyperv-1.0.0-exastro-1.9.0.kym」です.

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/1988f0c3-00c8-c7d5-8a08-e7326641660a.png)

### 2.2 Setting samplesのインポート

1. 「エクスポート／インポート」＞「メニューインポート」を選択、「ファイルを選択」でダウンロードしたパッケージファイルを開き、アップロードします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/cfe83081-12d4-00b1-7d43-0ede5a036903.png)


2. ファイルのアップロードが完了したらすべてのメニューを選択して、画面最下部の「インポート」をクリックする。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/3999e7ab-a26c-4c8a-9fcb-3014af18d0cf.png)

3. 「エクスポート/インポート管理」＞「フィルタ」をクリックし、インポートが完了しているか確認します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/8b1063e3-930f-f09c-7301-787cc1c7ecad.png)


4. 完了後メインメニューに赤枠部分が追加されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/7536b441-8d4f-c90d-7332-72129e788a29.png)

## 3. Windowsリモート管理(WinRM)の有効化
1. [公式のマニュアル](https://docs.microsoft.com/ja-jp/windows/win32/winrm/portal)などを参照して、Windowsリモート管理(WinRM)を有効にしてください。<br>[Hyper-Vモデル 導入手順](https://exastro-suite.github.io/SettingSamples-ITA-HyperV/setting-samples-hyperv-install_ja.pdf)も参考になります。

## 4. テンプレートの準備
1. [公式のマニュアル](https://docs.microsoft.com/ja-jp/virtualization/hyper-v-on-windows/quick-start/create-virtual-machine)などを参照して、仮想マシンを作成してVHDXファイルを用意します。<br>[Hyper-Vモデル 導入手順](https://exastro-suite.github.io/SettingSamples-ITA-HyperV/setting-samples-hyperv-install_ja.pdf)も参考になります。

2. 作成したテンプレートを任意の場所に保存します。
   ※今回は名前を「win10-template-sysprep.vhdx」と変更して、下記に保存しました。
   ```C:\Users\Administrator\Desktop\VHDX\```

## 5. 仮想スイッチの準備
1．[公式のマニュアル](https://docs.microsoft.com/ja-jp/virtualization/hyper-v-on-windows/quick-start/connect-to-network)などを参照して、仮想ネットワークの作成を行います。
　※今回は「Internal-Network-1」を内部ネットワークで作成しました。


# 仕込編①マスタ情報登録
**※表の赤文字は必須入力項目**

## 1. 仮想マシン名の登録
**※ 機器一覧にもここの名前が利用されます。**

1. 「マスタ管理_Hyper-Vモデル」＞「仮想マシン名」へ移動する。
1. 「登録開始」をクリックしてパラメータの値を必要に応じて入力する。
1. 必要な項目に情報を登録したら「登録」をクリックする。


**入力内容**

|<font color="Red">仮想マシン名</font>|
|---|
|Win10-Host1|
|Win10-Host2|


![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/2d643782-320a-30c2-8174-af4bf18980da.png)



## 2. テンプレート情報の登録
1. 「マスタ管理_Hyper-Vモデル」＞「テンプレート情報」へ移動する。
1. 「登録開始」をクリックしてパラメータの値を必要に応じて入力する。
1. 必要な項目に情報を登録したら「登録」をクリックする。


**入力内容**

|<font color="Red">テンプレート名</font>|<font color="Red">保存先フルパス</font>|ログインユーザID|パスワード|<font color="Red">世代</font>|
|---|---|---|---|---|
|Win10_Sysprep|C:\Users\Administrator\Desktop\VHDX\win10-template-sysprep.vhdx|administrator|テンプレートのパスワード|1|


![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/23c99fc6-efc5-33e9-4412-c87350916bab.png)



## 3. 仮想スイッチ名の登録
1. 「マスタ管理_Hyper-Vモデル」＞「仮想スイッチ名」へ移動する。
1. 「登録開始」をクリックしてパラメータの値を必要に応じて入力する。
1. 必要な項目に情報を登録したら「登録」をクリックする。

**入力内容**

|<font color="Red">仮想スイッチ名</font>|
|---|
|Internal-Network-1|
※[5. 仮想ネットワークの準備](#5-仮想ネットワークの準備) で作成した仮想ネットワーク名

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/179653f6-2db6-c548-cb7c-9c51ff36b598.png)

## 4. IPアドレス情報の登録
1. 「マスタ管理_Hyper-Vモデル」＞「IPアドレス情報」へ移動する。
1. 「登録開始」をクリックしてパラメータの値を必要に応じて入力する。
1. 必要な項目に情報を登録したら「登録」をクリックする。

**入力内容**

|<font color="Red">IPアドレス</font>|<font color="Red">サブネットマスク</font>|デフォルトゲートウェイ|DNSサーバ|
|---|---|---|---|
|192.168.1.100|255.255.255.0|192.168.1.254|192.168.1.250|

※私の環境では外部から仮想マシンへアクセスできないのと、IPアドレス設定が動作するかの確認ができればよいので、IPは適当に指定しています。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/c2a885a7-9967-9a03-4e78-a6590e998b62.png)


# 仕込編②仮想マシン操作
**※表の赤文字は必須入力項目**

## 1. 機器一覧の登録

1. 「基本コンソール」＞「機器一覧」へ移動する。
1. 「登録開始」をクリックしてパラメータの値を必要に応じて入力する。
1. 必要な項目に情報を登録したら「登録」をクリックする。

|<font color="Red">ホスト名</font>|<font color="Red">IPアドレス</font>|ログインユーザID|管理|ログインパスワード|認証方式|ポート番号|サーバ証明書|追加オプション|
|---|---|---|---|---|---|---|---|---|
|hyper-v|WindowsサーバのIPアドレス|WindowsサーバのログインユーザID|●|Windowsサーバのログインパスワード|パスワード認証(winrm)||||

※各項目の詳細な説明は下記の資料をご確認ください。
[ITA_利用手順マニュアル 基本コンソール](https://exastro-suite.github.io/it-automation-docs/asset/Documents_ja/Exastro-ITA_利用手順マニュアル_基本コンソール.pdf)
[ITA_利用手順マニュアル Ansible-driver](https://exastro-suite.github.io/it-automation-docs/asset/Documents_ja/Exastro-ITA_利用手順マニュアル_Ansible-driver.pdf)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/e5cba422-56c3-d0bb-ef20-08f30cd0b437.png)

## 2. オペレーションの登録

1. 「基本コンソール」＞「オペレーション一覧」へ移動する。
1. 「登録開始」をクリックしてパラメータの値を必要に応じて入力する。
1. 必要な項目に情報を登録したら「登録」をクリックする。

|<font color="Red">オペレーション名</font>|<font color="Red">実施予定日時</font>|
|---|---|
|新規追加_0101|2021/01/01 12:00|


![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/c6b415e4-bebc-de47-485f-616581f53da0.png)


## 3. 仮想マシン設定の登録

1. 「仮想マシン管理_Hyper-Vモデル」＞「仮想マシン設定」へ移動する。
1. 「登録開始」をクリックしてパラメータの値を必要に応じて入力する。
1. 必要な項目に情報を登録したら「登録」をクリックする。

|<font color="Red">ホスト名</font>|<font color="Red">オペレーション名</font>|<font color="Red">代入順序</font>|<font color="Red">処理状況</font>|<font color="Red">仮想マシン名</font>|<font color="Red">CPUコア数</font>|<font color="Red">メモリ容量(MB)</font>|<font color="Red">テンプレート名</font>|<font color="Red">仮想スイッチ名</font>|
|---|---|---|---|---|---|---|---|---|
|hyper-v|新規追加_0101|1|追加|Win10-Host1|2|4096|Win10_Sysprep|Internal-Network-1|
|hyper-v|新規追加_0101|2|追加|Win10-Host2|1|2048|Win10_Sysprep|Internal-Network-1|


![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/a1a32755-1d76-c1eb-8274-de26ad2ea392.png)


## 4. IPアドレス設定の登録

1. 「仮想マシン管理_Hyper-Vモデル」＞「IPアドレス設定」へ移動する。
1. 「登録開始」をクリックしてパラメータの値を必要に応じて入力する。
1. 必要な項目に情報を登録したら「登録」をクリックする。

|<font color="Red">ホスト名</font>|<font color="Red">オペレーション名</font>|<font color="Red">代入順序</font>|<font color="Red">処理状況</font>|<font color="Red">仮想マシン名</font>|IPアドレス自動設定(DHCP)|IPアドレス|
|---|---|---|---|---|---|---|
|hyper-v|新規追加_0101|1|追加|Win10-Host1|未記入 or No|192.168.100|

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/c40039c0-1060-86fd-77ed-cd7b84bf9c40.png)


## 5. 仮想ハードディスク設定の登録
1. 「仮想マシン管理_Hyper-Vモデル」＞「仮想ハードディスク設定」へ移動する。
1. 「登録開始」をクリックしてパラメータの値を必要に応じて入力する。
1. 必要な項目に情報を登録したら「登録」をクリックする。

|<font color="Red">ホスト名</font>|<font color="Red">オペレーション名</font>|<font color="Red">代入順序</font>|<font color="Red">処理状況</font>|<font color="Red">仮想マシン名</font>|<font color="Red">仮想ハードディスク名</font>|<font color="Red">仮想ハードディスク容量(GB)</font>|
|---|---|---|---|---|---|---|
|hyper-v|新規追加_0101|1|追加|Win10-Host1|data|20|

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/43b9dcc2-8949-cb30-6cab-8ae48046d005.png)


#実行編

## 1. Hyper-Vモデルの実行

1. 「Conductor」＞「Conductor作業実行」へ移動する
1. 「Conductor[一覧]」の「仮想マシン作成」を選択する。
1. 「オペレーション[一覧]」から「新規追加_0101」を選択する。
1. 画面下部の実行ボタンをクリック。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/1a6a5508-5ac1-05cc-2b12-1248d8fdadc8.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/6db9272f-edd8-e51d-3f96-49eed40034f5.png)




## 2. 実行結果の確認
### ITA側

1. Statusに「正常終了」が表示されていることを確認する。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/c0ff8013-9fa7-7dab-37dd-b646edf74ade.png)

2. 「基本コンソール」＞「機器一覧」へ移動する。
3. 「フィルタ」をクリックして作成した仮想マシンが登録されていることを確認する。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/5604d635-c03c-3748-5e2c-7c3c94c13717.png)


### Hyper-V側
1. [作成する仮想マシン情報](#作成する仮想マシン情報) 通りに作成されていることを確認する。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/90e35591-7dd7-0c24-34a9-27212a5306b2.png)


#おまけ

## 1. IPアドレス設定や仮想ハードディスク追加をしない場合

1. 「Conductor」＞「Conductor作業実行」へ移動する。
1. 「Conductor[一覧]」の「仮想マシン作成」を選択する。
1. 「オペレーション[一覧]」から「新規追加_0101」を選択する。
1. 「IPアドレス設定」をクリック ＞ 「Skip:」にチェックを入れる。
1. 「仮想ハードディスク追加」をクリック ＞ 「Skip:」にチェックを入れる。
1. 画面下部の実行ボタンをクリック。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/bbcc796a-e949-2d12-e270-897f649cf860.png)


## 2. さらに仮想マシンを追加をする場合
今回は「Win10-Host2」をもとにして仮想マシン名のみ違うマシンを追加しようと思います。
※この手順を行うと一つのオペレーションに対して、最大で10台まで追加可能です。

### 追加する仮想マシン情報

|仮想マシン名|CPUコア数|メモリ容量|仮想スイッチ名|IPアドレス|追加仮想ハードディスク名|追加仮想ハードディスク容量|
|---|---|---|---|---|---|---|
|Win10-Host3|1|2048MB|Internal-Network-1|dhcp |なし|なし|

### 1. 仮想マシン情報の複製

1. 「[1. 仮想マシン名の登録](#1-仮想マシン名の登録)」を行う。
1. 「仮想マシン管理_Hyper-Vモデル」＞「仮想マシン設定」へ移動する。
1. 「フィルタ」をクリックして一覧を表示する。
1. 「Win10-Host2」のレコードの「複製」をクリックする。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/8b7cfc18-4003-1657-c632-ddedbaba64ae.png)


1. 必要な項目の情報を変更したら「登録」をクリックする。

|<font color="Red">代入順序</font>|<font color="Red">処理状況</font>|<font color="Red">仮想マシン名</font>|
|---|---|---|
|3|追加|Win10-Host3|

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/be632f4e-da80-0f50-f6c0-fa4838bb74bb.png)

※設定値によっては下記の手順も必要になる可能性があります。
[4. IPアドレス設定の登録](#4-ipアドレス設定の登録)
[5. 仮想ハードディスク設定の登録](#5-仮想ハードディスク設定の登録)

### 2. Hyper-Vモデルの実行
1. 「Conductor」＞「Conductor作業実行」へ移動する
1. 「Conductor[一覧]」の「仮想マシン作成」を選択する。
1. 「オペレーション[一覧]」から「新規追加_0101」を選択する。
1. 「[1. IPアドレス設定や仮想ハードディスク追加をしない場合](#1-ipアドレス設定や仮想ハードディスク追加をしない場合)」を参考にして「IPアドレス設定」と「仮想ハードディスク追加」をスキップするようにしてから、Conductorの実行する。

### 3. 実行結果の確認
#### ITA側

1. Statusに「正常終了」が表示されていることを確認する。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/29b15e68-6270-cb34-4206-e45926296d16.png)


2. 「基本コンソール」＞「機器一覧」へ移動する。
3. 「フィルタ」をクリックして作成した仮想マシンが登録されていることを確認する。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/b839c534-6504-80c2-dfe3-236f9613d554.png)



#### Hyper-V側
1. [追加する仮想マシン情報](#追加する仮想マシン情報) 通りに作成されていることを確認する。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/1770057/713210a0-d5ff-ed9f-1e0e-18538c84dabb.png)


---
以上、今回は、Hyper-Vモデルの準備・導入～実行を実施しました。

一度に10個まで作成できるようなので、10個を超える場合はオペレーションを分ける必要がありますし、
Windowsサーバー側にHyper-Vの準備やネットワーク作成など必要ですが、
準備が済めば簡単に仮想マシンの追加/削除が可能なのはいいですね。