初めてのIBM i  Merlin 【セットアップ/管理者編】

# 記事概要
IBM iの統合開発環境であるMerlinの初期セットアップ手順をまとめました。
こちらは**管理者(Admin)権限**を持つユーザーのセットアップをご紹介した記事です。
|手順|管理者(Administorator)|開発者(Developer)/<br>ビルド管理者|
|---|---|---|
|① Merlin初期設定|**Vaultサーバーの初期化** <br> **ユーザーの作成** <br> **ロールの管理** <br> **プロジェクトの作成** <br> **IBM i CI/CDのインストール** <br> **インベントリ情報の登録** <br> **テンプレートの設定**|- <br> - <br> - <br> プロジェクトの作成 <br> IBM i Developerのインストール <br> インベントリ情報の登録 <br> テンプレートの設定|
|② IBM i Developer セットアップと初期設定|- <br> - <br> -|ワークスペースの作成 <br> Gitの連携 <br> IBM iとの連携|
|③ IBM i CI/CD セットアップと初期設定|**Jenkinsサーバーの構成** <br>**権限の付与**<br> -|- <br> - <br>タスクの作成と実行 | 


開発者/ビルド管理者ユーザーのセットアップについては[こちらの記事](https://qiita.com/koga39chan/items/6544eb39b7b168a07dfa)をご参照ください。
また、IBM i Merlinに関する記事の目次ページは[こちら](https://qiita.com/koga39chan/items/90638f30f65c62177967)です。こちらのページは、記事が追加され次第更新されます。



また、この記事ではMerlinインストール後からのセットアップを扱っています。Merlinをインストールするまでの部分に関しては、こちらの[マニュアル](https://www.ibm.com/docs/en/merlin/1.0?topic=guide-install-i-modernization-engine-lifecycle-integration)をご参照ください。
*現在のMerlinの最新バージョンは1.4.2です。1.4.0では、IBM i Developerのインストール時にエラーとなる場合がありますので、最新版をお使いください。

# 初期設定
## Vaultサーバーの初期化
Merlinをインストールした最初の画面がこちらです。
![スクリーンショット 2023-05-08 13.46.05.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3078498/9c90f84b-7cc6-1b6f-7232-51e668dd7a21.png)

まず、Vaultサーバーを初期化します。
**Vaultサーバーの構成 -> Vaultの初期化 -> (デフォルトの設定で)Vaultの初期化**
 ![スクリーンショット 2023-05-08 13.51.21.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3078498/d3ce375d-8e40-f6c1-41e6-eb8f895c99dd.png)
最後にシークレットとトークンが表示されます。Merlinをrestartしたタイミングなどで聞かれることがありますので、これらは**必ず控えておいてください。**

## ユーザー作成とロールの管理
次にユーザー作成をして、さらにそのユーザーにのロールを設定します。
**ユーザー管理 -> ユーザー -> 追加**
の画面で、任意のユーザー名・Eメールアドレス・パスワードを入力して追加。
IBM i Developerを使うにはメールアドレスは必須なので忘れずに入力してください。
![スクリーンショット 2023-05-11 17.10.37.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3078498/35964d4f-f0aa-b837-de56-09b07e7f5661.png)

ユーザーの追加ができたら、ロールを設定します。
**許可 -> ロールの管理 -> ASSIGN**
の画面で、ユーザーとその役割を選択します。IBM i Developerを使うユーザーにはCREATOR権限を与えます。
![スクリーンショット 2023-05-12 10.12.29.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3078498/955015c0-99c2-e2ce-10bf-789fad9a4665.png)

## プロジェクト作成とCI/CDツールのインストール
CI/CDツールをインストールします。
**ツール -> カタログ**
にツールがあるので、右クリックをして「アプリケーションのインストール」をクリック。
![スクリーンショット 2023-05-25 11.11.17.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3078498/28d606d5-4ad0-c35a-d833-f3d665f96ed9.png)
インストールの際にはプロジェクトが必要になります。新しくプロジェクトを作成してインストールすることをお勧めします。
プロジェクトは、「アプリケーションのインストール」の操作の過程で、プロジェクトを選択する画面にて「作成」をクリックして新規に作成することができます。
![スクリーンショット 2023-05-25 11.13.18.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3078498/d9c5db78-7e15-382f-fa0e-51a8f4214820.png)
**ツール -> デプロイ済みツール**でCI/CDツールがAvailableになっていることを確認できたらインストールは完了です。
(AdminもIBM i Developerを使用する場合、同様の手順でそちらもインストールをしてください。なお、途中で作成するプロジェクトはそれぞれのツールで別に作ることをお勧めします。)

## インベントリ情報の登録とテンプレートの設定
次に、IBM iへの接続の設定をします。
**接続 -> 在庫**
から名前(任意)・タイプ名(IBM i)・ホスト名(該当のもの)を追加。
**接続 -> Credentials**
から名前(任意)・IBM iにサインオンする際に入力するユーザー名・パスワードを追加。(SSHでも可)
**接続 -> テンプレート**
から、名前(任意)・先ほど追加した在庫(Inventory)・資格情報(Credentials)を追加し、在庫と資格情報を紐づけます。
![スクリーンショット 2023-05-12 10.16.37.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3078498/14b55be8-eef2-40eb-9f97-f6a80be02e0f.png)

テンプレートの作成ができたら、**該当のテンプレートを選択 -> 実行**
として、6項目全てを実行します。
![スクリーンショット 2023-05-12 10.37.27.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3078498/9291ddb9-46e5-a376-0967-8ffe289f8d8c.png)
テンプレートの実行がすべて完了したのを確認します。

# CI/CDのセットアップ
Merlinの画面にて、**ツール -> デプロイ済ツール**でCI/CDを見つけます。
CI/CD上で右クリックをして、**アプリケーションの起動**を選択するとCI/CDに入ることができます。
![スクリーンショット 2023-05-24 17.24.28.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3078498/dca22a95-3a19-235f-ac28-cec5c559c7fd.png)
## Jenkinsサーバーの構成
**Jenkinsの構成 -> Jenkinsサーバー -> Jenkinsサーバーの初期化**
で接続されているJenkinsのインスタンスを初期化します。
![スクリーンショット 2023-05-24 10.02.09.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3078498/4e618c07-48e7-c7c9-7325-f5dbe02aca11.png)
続いて、内部のJenkinsを使うか外部のJenkinsを使うかを選びます。**内部のJenkins**を選択します。
![CI2枚目.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3078498/95ef7405-d6b2-d503-105b-447b5261f576.png)
次に、ユーザーネームとパスワードを入力します。このユーザーとパスワードは、Merlinのユーザーとパスワード**ではありません**。ここで新しく作るようにしてください。
![スクリーンショット 2023-05-24 10.02.58.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3078498/c1ac6056-d3ea-bc39-3bae-351c41ae905c.png)
完了をクリックし、終了まで待てば完了です。

## 権限の付与
**Jenkinsの構成 -> 権限の管理** の画面で**追加**を選択
![スクリーンショット 2023-05-29 13.16.19.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3078498/083abac9-ea4d-6e9e-f1d1-68afc940b2a8.png)
CI/CDを使うユーザーを選択し、**OK**を選択します。
すると、該当ユーザーがCI/CDを使用できるようになります。

以上で、管理者(Admin権限保有者)が行う初期設定とセットアップは終了になります。
お読みいただきありがとうございました。