HULFT10 API Gateway を導入してみた

# はじめに
こんにちは。すぎもんです。:smiley:

今回は HULFT10 API Gateway を先行で触ってみた際の記事になります。

**HULFT10 API Gateway** はWebブラウザでHULFTの統合管理が出来ます。

※ HULFT10 API Gateway の他にPostgreSQLのインストールが必要です。

HULFT10 について紹介している公式サイトと記事もあわせてご覧ください。

https://www.hulft.com/software/hulft-10

https://qiita.com/sugimon/items/f20294a677d69f87cac5


:::note warn
本資料は2024年10月開発中時点のリリース前モジュールでの環境構築ナレッジです。
設定内容等の細かい部分は変更になる可能性がある点、ご留意ください。
:::


# 今回やること
HULFT10 API Gateway とPosgreSQLを導入して環境構築を行います。
最初にPosgreSQLの導入とテーブルの作成を行います。
その後、HULFT10 API Gateway のモジュールを展開し、設定ファイルに情報の登録や実行ファイルの実施等を行います。
最後に、HULFT10 API Gateway のログインを行います。

それでは早速やってみましょう！


# 実施手順
以下の流れで HULFT10 API Gateway の環境構築を行っていきます。

<dl>
  <dt>① HULFT10 API Gateway の導入</dt>
  <dd>1. PostgreSQL の導入</dd>
  <dd>2. HULFT10 API Gateway のモジュールを展開</dd>
  <dd>3. PostgreSQL の接続情報の登録</dd>
  <dd>4. HULFT10 API Gateway のサーバー起動情報を登録</dd>
  <dd>5. HULFT10 API Gateway のアクティベート</dd>
  <dd>6. HULFT10 API Gateway のサービスを登録</dd>
  <dt>② ログイン</dt>
  <dd>1. HULFT10 API Gateway のサービスを起動</dd>
  <dd>2. HULFT10 API Gateway の管理画面を起動</dd>
</dl>



## ① HULFT10 API Gateway の導入
HULFT10 API Gateway の導入は、下記の手順で行います。

1. PostgreSQL の導入
1. HULFT10 API Gateway のモジュールを展開
1. PostgreSQL の接続情報の登録
1. HULFT10 API Gateway のサーバー起動情報を登録
1. HULFT10 API Gateway のアクティベート
1. HULFT10 API Gateway のサービスを登録


### 1. PostgreSQL の導入

先ずはバージョン16以降の PostgreSQL をダウンロードし、任意のディレクトリーに導入していきます。

導入した PostgreSQL に任意のデータベースを作成します。

```ruby:例
CREATE DATABASE hulgtw;
```
今回は「**hulgtw**」というデーターベースを作ってみました。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/dd6d2659-fedd-5bbd-c31c-86a298852a73.png)


### 2. HULFT10 API Gateway のモジュールを展開
次に任意のフォルダーに **hulft-api-gateway-windows-v100200.zip** を展開します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/9e4f0791-80f5-5c90-4207-bde1fd8c6c4b.png)

今回は `C:\HULFT Family\hulft10apigateway\hulft-api-gateway-windows-v100200` に導入してみます。


### 3. PostgreSQL の接続情報の登録
PostgreSQL の接続情報と先ほど作成したデータベース名の「**hulgtw**」を設定ファイル（**hul_gtw_config.yml**）に登録します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/71295722-b970-a8cf-ed39-841bf3b4b68d.png)

:::note
**設定項目**
| 項目 | 内容 | 備考 |
|:-|:-|:-|
| host | localhost | PostgreSQL 導入環境のホスト名 |
| port | 5433 | PostgreSQL ポート番号 |
| dbname | <font color="Red">**hulgtw**</font> | PostgreSQL 新規に作成したデータベース名 |
| username | postgres | PostgreSQL ユーザー名 |
| password | postgres | PostgreSQL パスワード |
:::


### 4. HULFT10 API Gateway のサーバー起動情報を登録
HULFT10 API Gateway サーバーの「ポート番号」を設定ファイル（**hul_gtw_config.yml**）に登録します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/9b1d0b71-0043-994f-65c9-e9da5df51998.png)

:::note
**Point**
<font color="Red">**`:`**</font> の後に半角スペースを入れてください。
:::


### 5. HULFT10 API Gateway のアクティベート
続いて HULFT10 API Gateway のアクティベートを行っていきます。
まずはコマンドプロンプトを管理者として実行し、HULFT10 API Gateway のモジュールを展開したディレクトリに移動します。

```ruby:例
cd C:\HULFT Family\hulft10apigateway\hulft-api-gateway-windows-v100200
```

**※実行例**
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/6ac1cc42-ea76-1b6d-44a0-ae13e2760660.png)


下記のコマンドを使って HULFT10 API Gateway のアクティベートを行っていきます。

```ruby:コマンド
hulft-api-gateway.exe  --activate --serial-number SerialNumber --product-key ProductKey [--term-license-key TermLicenseKey] --root-password InitialRootPassword
```

**※実行例**
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/a55bd44e-c39c-a7d9-16ea-22db2683a703.png)

:::note
**アクティベートには、以下の指定が必要です。**
+ シリアル番号
+ プロダクトキー
+ 期間限定キー
製品版（期間限定ライセンス）の場合のみ必要
+ 初期パスワード
:::



### 6. HULFT10 API Gateway のサービスを登録
HULFT10 API Gateway Server実行ファイル（hulft-api-gateway.exe）のコマンドを使用して、HULFT10 API Gateway のサービスを登録していきます。

```ruby:登録コマンド
hulft-api-gateway.exe --register-service [--service-name ServiceName]
```

**※実行例**
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/e7060f17-1355-058b-f385-77d1cf76a0a9.png)

:::note
**Point**
ServiceName の指定を省略すると、サービス名が「**HULFT API Gateway**」で登録されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/c3b5f5ce-7822-1683-d111-248c29fce92b.png)
:::


## ② ログイン
それでは実際に HULFT10 API Gateway にログインをしてみましょう。
ログインは以下の流れで行います。

1. HULFT10 API Gateway のサービスを起動
1. HULFT10 API Gateway の管理画面を起動


### 1. HULFT10 API Gateway のサービスを起動

ログインをするためには、先にサービスの起動を行う必要があります。
Windowsのコマンドプロンプトを管理者として実行し、以下のコマンドを使用して HULFT10 API Gateway のサービスを起動します。

```ruby:起動コマンド
hulft-api-gateway.exe --start
```

**※実行例**
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/3bd3eff1-f2ab-a6bd-3da9-e3ddb6065f29.png)


### 2. HULFT10 API Gateway の管理画面を起動

Webブラウザを使用して、下記のURLにアクセスします。
`http://API-Gatewayを起動しているホスト名:API-Gatewayのポート番号`

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/26989ea6-85d4-3eb8-de37-101efe4e8a02.png)

[ユーザーID] には「**root**」を入力し、[パスワード] には <font color="blue">**5. HULFT10 API Gateway のアクティベート**</font> で「**初期パスワード**」として指定したパスワードを入力して [ログイン] を押下します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/458288/5522b0c2-ff08-ffc5-3cef-94205d9998dc.png)

無事にログインできたことを確認しました。

:::note warn
**対応ブラウザ**
Google Chrome(x64) バージョン : 120.0.* 以降
Microsoft Edge(x64) バージョン : 120.0.* 以降
:::



# 最後に
今回は HULFT10 API Gateway を導入してみましたが、いかがだったでしょうか。

HULFT10 API Gateway を用いることで HULFT をWebブラウザで統合管理が可能になるため、ぜひ試してみてください。

このブログでは、今後も様々なTopics記事や接続検証等、皆さんの参考になるような記事を投稿していきたいと思います！
ここまで読んでいただきありがとうございました。それでは、また！:raised_hand: