AWSとDockerを使用したOmiseGo / ewallet環境構築

【本文】

この記事は Blockchain Advent Calendar 2018 の15日目の記事です。
空いていたので、急遽ねじ込みました！

OmiseGoのewalletをAWS上でdockerイメージを使って簡単に構築する手順について共有します。

【前提】

• EC2の基本的な設定まで終わっている前提。以下を参考にすれば、AWS上で基本的なWebアプリケーション環境構築が可能。

　　（参考）Qiita: 0から始めるAWS入門

• Elastic IPを取得してパブリックIPアドレスを固定化しておく方が良い。（※固定していない場合、インスタンス起動の度にDNSとパブリックIPが変わる。）

　　（参考）【AWS】IPを固定しよう！Elastic IPの設定【初心者】

【EC2起動】

• AWSコンソール上からインスタンス立ち上げ

【サーバへログイン】

• ssh接続(mac or Linux)もしくはTeraterm(windows)を利用してEC2へログイン（※通常、ユーザー名はec2-user ）

【docker環境構築】

• 以下を参考に導入（※特に「docker環境初期構築」のあたり）

　　（参考）Qiita: 初心者がAWS Linux環境にdocker-composeでELK環境を構築してみた

＜コマンド＞

• リポジトリのアップデートチェック
• dockerをインストール
• dockerを起動
• ec2-userをdockerグループに追加（ubuntuの場合はubuntu）

$ sudo yum update
$ sudo yum install -y docker
$ sudo service docker start
$ sudo usermod -a -G docker ec2-user

• Doicker-composeの導入は公式ドキュメントに従った方が良い。

　　（参考）Install Docker Compose

【OmiseGo: ewalletのdockerイメージ導入】

• 任意の場所にdocker-compose.ymlファイルを作成し、以下リンク内の内容をコピー＆ペーストする。

　　（参考）omisego/ewallet: Option 1: Using Docker Compose
→（2019/6/12修正）　https://raw.githubusercontent.com/omisego/ewallet/master/docker-compose.yml

＊基本は、以下リンクの手順をこなせば起動する。
https://github.com/omisego/ewallet

• なお、docker-compose.ymlの配置場所は何処でも良いが、プロジェクトに紐づいたディレクトリ内に配置する等しておくと後々分かりやすい。

　　（参考）Qiita: Docker compose ことはじめハンズオン

• それ以降の設定もOption 1の終わりまで実行。

• docker-compose.ymlの内容に従って、ほぼ自動で環境設定からdockerコンテナのサービス起動まで実行してくれるが、実行途中で管理者のE-mail/Password設定を訊かれるので、任意のものを入力。あくまでもサンプル用なのでE-mailアドレスは何でもよく、例えば、[e-mail]でもよい。（※Email/Passwordは後のログイン時に使用するので覚えておく。）

（備考）OmiseGo/ewallet側での環境構築自体はこれだけ。シンプルです！

【EC2：セキュリティグループ設定追加】

• 以下参考リンクの「EC2セキュリティグループの修正」を参照しながら、EC2のセキュリティグループに設定追加。

　　（参考）AWSのEC2に、docker-composeを使用してredmineとGitBucketをインストール

（図1）

• 図1の赤枠を参考。

タイプ：

• カスタムTCPルールを指定。

ポート範囲：

• dockerコンテナのPORTSを指定。
• OmiseGoのewalletの場合、docker-compose.ymlでポート番号を4000に設定しているので、そちらを使用。

ソース：

• IPアドレスを指定。（0.0.0.0/0にすればすべてのIPアドレスを受け付ける。）

【OmiseGoのe-walletの管理者画面へログイン】

• Webブラウザ上で　http://{EC2のパブリックIP}:4000/admin を指定し実行

（図2）

• Email/Password はdokerイメージ導入中に設定したものを使用。

（図3）

• これで管理者画面へのログインまで完了。
• トークン発行／移転やアカウント追加等もここからでも可能。

（図4）

• 一例として、TestToken(TST)を発行し、一部を管理者アカウントから作成したtest1アカウントにトークン移転した際のトランザクション。

• 補足として、一般ユーザ側で使用できるようにするには、APIを使用してクライアントウォレットを作成する。API詳細はドキュメント参照。

【おわりに】

OmiseGoのewallet環境構築は、現状ではBare-metalとDockerイメージを使用する場合の2通りあります。
Bare-metalを使用する場合は、以下リンクの手順が詳しいですが、端末の環境にも左右されて思わぬところで嵌ることも多いかもしれません。

（参考）OmiseGoのeWalletをRuby on Railsで利用する(アルゴリズムとかオーダーとか)

今回のようにAWS + docker使用の場合は、嵌る可能性があるとすればAWS設定くらいなので、より簡単に環境構築できると思います。（その代わり、慣れない人はAWSの設定で嵌る可能性もありますが。）

以上

BUIDL the blockchain world!