初めてのIBM i Merlin【開発者(Developer)編】

# この記事でやること
[前回の記事](https://qiita.com/meo_kawa/private/e8fb4d324c00bf01fb8c)では管理者向けのセットアップ(初期セットアップとIBM i CI/CDおけるサーバーの設定)を行いました。
今回はIBM i Merlinの開発者(Developer)とビルド管理者がやることについて書いていきます。


今回の作業の流れはこちら。


|手順|管理者(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> -|**ワークスペースの作成** <br> **Gitの連携** <br> **IBM iとの連携**|- <br> - <br> -
|③ IBM i CI/CD<br>セットアップと初期設定|Jenkinsサーバーの構成 <br> -|- <br> タスクの作成と実行 | - <br> タスクの作成<br>(ビルド管理者)|

Merlin初期設定とIBM i Developerセットアップと初期設定は開発者が、
最後のIBM i CI/CDセットアップのみビルド管理者が行います。


参考
[IBM i Merlin公式マニュアル](https://www.ibm.com/docs/en/merlin/1.0?topic=overview)
[IBM i Merlin Git](https://ibm.github.io/merlin-docs/#/./README)

# IBM i Merlin初期設定
:::note info
開発者アカウントにログインして行います
:::
## プロジェクトの作成
左側のメニューからホーム->プロジェクトを選択し、右下の作成を選択します。
![スクリーンショット 2023-05-24 14.38.12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/ec20f00b-b746-0d38-c45f-378a9aa04206.png)
任意のプロジェクト名を入力します。
![スクリーンショット 2023-05-24 14.38.27.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/80f1a564-3fb2-4e21-29e3-ffed3425e611.png)

## ツールのインストール
IBM i DeveloperとCI/CDツールのインストールをします。
右側のメニューバーからツール -> カタログを選択します。
インストールしたいツール(今回はIBM i Developer)を右クリックをし、アプリケーションのインストールを選択します。
![スクリーンショット 2023-05-24 14.41.29.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/9bad0fbc-6329-86ab-e4ef-7f230888c5f0.png)
利用条件が出てくるので同意します。
![スクリーンショット 2023-05-24 14.41.39.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/bbc0750d-046a-32ac-2999-cfffd718c84f.png)
インストールするプロジェクト(先ほどの章で作成したもの)を選択。
![スクリーンショット 2023-05-24 14.41.53.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/473b6800-82f3-f53a-c50d-ce6422fc3861.png)
今回はチャネルv1.0、更新戦略自動を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/3a8d2f00-8ffe-557b-08fa-f09f5b80ee73.png)
![スクリーンショット 2023-05-24 14.48.08.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/9c0dd48b-3a2c-58c9-aa16-747144e19f79.png)

インストール後、ツール -> デプロイ済みツールにてAvailableになっていることを確認できたらインストールは完了です。
IBM i CI/CDも同じ手順でインストールを完了させます。
![スクリーンショット 2023-05-24 14.50.48.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/e1312363-bca4-c3fb-98d2-300c6948c151.png)


## インベントリ情報の登録とテンプレートの設定
こちらの作業は基本的に管理者が行います。
[インベントリ情報の登録とテンプレートの設定方法](https://qiita.com/meo_kawa/private/0c8e376912b7920f48b8#%E3%82%A4%E3%83%B3%E3%83%99%E3%83%B3%E3%83%88%E3%83%AA%E6%83%85%E5%A0%B1%E3%81%AE%E7%99%BB%E9%8C%B2%E3%81%A8%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88%E3%81%AE%E8%A8%AD%E5%AE%9A)

# IBM i Merlinのi Developerセットアップと初期設定
## ワークスペースの作成
:::note warn
adminではなくクリエーター権限を与えられたユーザーでログインします。
:::
まずMerlinにログイン後、IBM i Developerをクリックし開きます。
![スクリーンショット 2023-05-19 10.39.01.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/e42e5ac6-371b-a94e-f784-887664394cb6.png)
IBM i Developerを開いた後、いちばん上のメニューCreate workspace画面からIBM i Developerを選択します。するとワークスペースが立ち上がり始めます。以下の画面が出れば起動OKです。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/39311fe6-d20f-830d-e251-79717c648df7.png)
![スクリーンショット 2023-05-19 10.52.59.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/00e43ded-86c7-93a1-9a52-b54f4db8f855.png)




## Gitとの連携
### ssh鍵の生成と登録
開いたワークスペースでF1キーを押すと検索タブが出てきます。ここで`SSH Generate Key`と入力し、選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/7b93ffe3-b8b3-2315-56d9-9b511673fa0f.png)



選択するとGitとIBM i Developerが連携するための鍵が生成されます、右下にこの公開鍵を表示するかを尋ねられるのでViewを押して表示します。そしてその公開鍵をコピーします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/02e8cc7b-2232-d655-7def-2ed3259eb7c7.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/cbedb512-3fee-1c9f-7c06-dc452e47b6c1.png)



この鍵をGitに登録します。今回はGitHubを用いて行います。
登録の方法として、Gitの設定≫ssh and GPG key≫New ssh keyで登録していきます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/20ec3d96-091b-1fe0-3276-61f9889653b3.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/a902b334-533b-fa92-7af0-1ce655065031.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/714d2e79-7bff-2fb7-42c1-cc28afb6c8fc.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/36e7f14e-a09a-7f36-f19d-3d1047d6d4b4.png)

### リモートリポジトリをIBM i Developerのワークスペースに複製(クローンを作成)する
再びワークスペースにてF1キーを押して、`Git Clone`と入力し選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/57714868-2237-4d64-77b0-7c34fb266c34.png)

Clone from URLと出てきたら、入力ボックスにクローンを作るリポジトリのURLを入れます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/cf59a1ff-1796-6b53-8cb8-17d066ec5cca.png)

URLは、Gitのリポジトリのcodeからコピーできます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/5a991a94-e076-49b9-db37-ea425ae4a5db.png)

今回作成するリモートリポジトリをどのブランチに作るかを聞かれるので、デフォルトのプロジェクト(今回はProjects)を指定します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/d725051b-5a42-b19b-d6b8-a294ce0698b6.png)


このように左側にリポジトリに格納されたソースが表示されたらOKです！
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/050a01e2-4444-a8cb-2208-3d7faf177a1d.png)



## IBM iインスタンスとの接続
IBM iインスタンスとIBM i Developerの接続を行います。
IBM i PROJECT Explorerの中に作成したプロジェクトが表示されています。
その下のIBM i(今は接続されていないのでNot Specifiedと表示)の＋を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/cb190061-cce1-6c19-2ead-bd432ea54aeb.png)

そうすると上部タブにてパスワードの入力を求められるので、**Merlinにサインインする際のパスワード**を入力し、Enterをおします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/70e7bf26-a5ed-f394-0dcf-492cc10f769d.png)

接続するIBM iとユーザーが定義したテンプレートを参照を選択します。
テンプレートについては[(1)Merlin初期設定]()を参照してください
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/87b8c58d-11e1-9315-cb06-f9806216c995.png)

このような表示が出たらOKです。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3212743/9abde62c-1876-066d-5efc-f9894fb37948.png)


初期セットアップはひとまず終わりです。
実践編に続きます！