HarperDBをAkamai Cloud Computing Servicesにインストールしてみた

はじめに

HarperDB は、アプリケーションとデータベースを一つのパッケージに統合した「分散型データベースアプリケーションプラットフォーム」です。データ処理の効率化、パフォーマンスの向上、コスト削減などの効果が期待できます。
このブログでは、HarperDBをAkamai Cloud Computing Services（Linode)にインストールする手順を紹介します。

Akamai Cloud Computing ServicesへHarperDBのインスタンスを構築

まずはAkamai Cloud Computing Services(Linode)上にVMを立ち上げます。
今回は、大阪リージョンにUbuntu 24.04を選択しました。

VMを立ち上げ、root以外のsudoが可能なUserを作成します。
今回は「acc」というUserを作成しsudo権限を付与しました。

root@localhost:~# adduser acc
root@localhost:~# gpasswd -a acc sudo

accのHomeディレクトリーにNVM、Node.js、HarperDBを構築していきます。

root@localhost:~# su - acc
To run a command as administrator (user "root"), use "sudo <command>".
See "man sudo_root" for details.

acc@localhost:~$

まずはOSのパッケージアップデートを行います。

acc@localhost:~$ sudo apt update && sudo apt upgrade -y

HarperDBはNode.js上で動作しますので、nvmを使ってNode.jsをインストールします。
以下のコマンドでnvmをインストールします。

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash

nvmのインストールが完了したら、ユーザーaccから一度ログアウトし、再度ログインします。

acc@localhost:~$ exit
logout
root@localhost:~# su - acc
acc@localhost:~$

次に以下のコマンドでnvmを使ってNode.jsの18.15.0をインストールします。

acc@localhost:~$ nvm install 18.15.0

以下のコマンドでHarperDBをインストールします。

linode@localhost:~$ npm install -g harperdb

次に、harperdbを実行し設定内容を入力しインスタンスを立ち上げます。
問いかけには次のようにデフォルトの値をそのまま入力し、最後のHDM_ADMINのpasswordは独自のパスワードを入力します。

acc@localhost:~$ harperdb

I Agree to the HarperDB Terms and Conditions. (yes/no) yes
Please enter a destination for HarperDB: /home/linode/hdb
Please enter a server listening port for HarperDB: 9925
Please enter a username for the HDB_ADMIN: HDB_ADMIN
Please enter a password for the HDB_ADMIN: [hidden]　”PASSWORD入力”

インストールが完了したら、Ctrl+Cを押して一旦コマンドプロンプトに戻ります。
デフォルトではHTTPのみの設定になるため、インスタンスがHTTPS接続できるように設定ファイルを変更します。　そのため以下のコマンドで一旦HarperDBを停止させます。

acc@localhost:~$ harperdb stop

HarperDBのインストールディレクトリー（/home/acc/hdb/)に移動し、HarperDBの設定ファイル（harperdb-config.yaml）を変更します。

acc@localhost:~$ ls
hdb
acc@localhost:~$ cd hdb
acc@localhost:~/hdb$ ls
backup      components  doc                   keys  node_modules  trash
clustering  database    harperdb-config.yaml  log   transactions

テキストEditorで「harperdb-config.yaml」を開いて、operationsApi:セクションに"https: true"を追加します。

次にHarperDBのインスタンスを再起動させると変更した設定ファイルが適用され、インスタンスへHTTPS接続が可能な状態になります。

acc@localhost:~/hdb$ harperdb start

これでAkamai Cloud Computing Services（Linode)へHarperDBのインスタンスのインストール作業が終わりました。

HarperDB studioを使ってインスタンスを管理

ブラウザーからHarperDB Studioに接続しHarperDBのインスタンスを管理することができます。
HarperDB Studioを利用するためには無料のアカウントの作成が必要です。
https://studio.harperdb.io/sign-upからアカウントを申請して取得します。

取得したアカウントを用いてHarperdb Studioへログインします。

ログイン後、Register Enterprise Instanceをクリックし、Akamai Cloud Computing Services（Linode）で作成したHarperDBインスタンスの情報を追加します。

Instance情報を入力します。

Instance name: 任意の名前
Username: HDB_ADMIN
Password: 設定したパスワード
Host: LinodeのIPアドレス
Port: 9925
SSL：　チェックする

インスタンズの情報入力後に、Instance Detailsをクリックすると、下に”You may need to accept the instance's self signed cert”と警告がでるので、その警告の右にある矢印アイコンをクリックするとブラウザーの別のタブでHarperdbのインスタンスへSSL接続をします。
別のタブでインスタンスへ接続すると、証明書の警告がでるので、証明書エラーを無視してインスタンスサーバーへ接続したあと、元のタブに戻り、もう一度Instance Detailsをクリックします。

次に、Instance Specsで使用するRAMを選択しますが、今回はテストのためFREEの0.5GB RAMを選んでConfirm Instance Detailsを押します。

設定内容と、プライバシーポリシーを確認して、Add Instanceをクリックします。

これでHarperDB StudioにAkamai Connected CloudのHarperDBインスタンスが追加され、インスタンスの管理、DBの操作などができるようになりました。

おわりに

今回はAkamai Cloud Computing Services（Linode)上にHarperDBのインスタンスを構築し、HarperDB Studioに構築したインスタンスを追加してみました。次回は実際にHarperDB（分散型データベースアプリケーション）の活用方法について紹介したいと思います。

関連記事

アカマイ・テクノロジーズ合同会社はQiitaでAkamai Cloud Computing Services関連など開発者向けの記事を掲載しております。