「次世代NEMではじめるブロックチェーンアプリケーション開発」の実践記録第1章 Catapult(NEM2)入門編

松岡靖典

1403

2019-09-25 07:37:59

0.00 mXYM

(0)

先日、東京・池袋のサンシャインシティにて開催された「技術書典」で、タイトルにも書かせて頂いた「次世代NEMではじめるブロックチェーンアプリケーション開発」という日本のNEMberの方々の共著による技術書をゲットさせて頂きました。

ゲットだぜ！ pic.twitter.com/32lZjTlokv
— サラリーマン投資家 (@salaryman_tousi) September 22, 2019

帰りの新幹線の中で、一通り目を通させてもらったのですが、実は商業誌なのでは？と疑ってしまうほど、素晴らしい内容で、下車するのを忘れて読みふけってしまい、気付いたら名古屋まで来てしまっていたくらいでした。(私は静岡県在住なのです…。)

技術書展にてゲットしたNEM本を夢中で読みふけっていたら、駅おりるの忘れて名古屋まで来てしまった…
せっかくなので、きしめん食べて帰ることにしました pic.twitter.com/xkpcivWXua
— サラリーマン投資家 (@salaryman_tousi) September 22, 2019

しかし、せっかくの技術書、やはり実際に手を動かしてみて、しっかり会得せねば…。著者の方も、以下のようにコメントされており、できるだけ先陣を切って手を動かして、気付いたことをまとめていこうと思います。

＊「ぎじゅつしょは　てをうごかして　みに　つけるように！　もってるだけでは　だめですぞ！」
— ニズベールℛ (@44uk_i3) September 22, 2019

詳細な内容は、書籍での説明にお任せして、詰まったり、悩んだりしたところ、メモしておくと今後役に立ちそうなことを中心に記事にしていこうと思います。

なお、私のPCの環境は、Windows 10 Pro 64bit、メモリは4GBという比較的弱いスペックです。書籍自体はmacの環境を前提として構成されている箇所が多いと思いますので、特に普通のWindows環境の方で、環境構築等で悩んだ方への解決のヒントになるような情報を提供できると嬉しいな…と思っています。

それでは、まず、第1章 Catapult(NEM2)入門編の実践記録、はじまりはじまり～

第一章では、事前にNode.js, Docker, Docker Composeの主に3種類の実行環境を整える必要があります。(正直、この環境構築の方が、Catapultネットワークを構築することより、はるかに大変だな…と思うくらい、Catapultネットワーク構築は簡単でした！)

WindowsでのNode.jsの環境構築

Windowsの64bitのOSでの環境構築の場合、Node.jsは以下URLから推奨版をダウンロードして、ダブルクリックで実行して、どんどん次に進んでいく感じでインストールすればよいと思います。

https://nodejs.org/ja/

Windowsの32bitのOSでの環境構築の場合、以下URLから推奨版のWindows Installerの32-bitをダウンロードして、ダブルクリックで実行して、どんどん次に進んでいく感じでインストールすればよいと思います。

https://nodejs.org/ja/download/

WindowsでのDockerのインストール

結論を先に書くと、私の環境(Windows 10 Pro 64bit、メモリ4GB)では、Dockerの適切な環境をシンプルに構築できなかったため、GCP(Google Cloud Platform)上で動かすことにしました。4GB程度のメモリでは、Windows上でDocker Desktopを動かすにはメモリが足りないようです。何か方法はあると思うので、どこかで別の選択肢が無いか調べてみようと思っています。

以下に、念のため、私がWindows 10 Pro 64bitの環境でトライし、結果的に上手く行かなかった流れをまとめておきます。Windosw 10 64bitでの環境構築の場合、以下のような流れになります。メモリにもう少しゆとりがあれば、これで普通にDockerが動くと思います。

Hyper-Vの有効化…これは普通に上手く行きました。
Docker Desktopのダウンロード、インストール(Docker Hubにユーザー登録し、ログイン後の画面から、必要なファイルをダウンロード、インストール)…こちらも、1GBくらいのダウンロードでかなり重かったですが、特に問題無く上手く行きました。
インストールの後、再起動後のDocker Desktopの自動起動時に以下エラーメッセージが出て解決できず…

無情にも、画面には「Not enough memory to start Docker Desktop」の文字が…。シンプルにメモリが足りないということだと思います。いくつか解決策を試したのですが、現時点では、この問題は解決できていません。

以降は、GCP上で試した手順を説明します。

GCP(Google Cloud PlatformのCompute Engineで新しいVMインスタンスを1個作成する)

以下にGCPでの作業の流れを書いておきます。初めてGCPを使う方向けの(正直乱暴な)手順となっています。作業自体は、Compute EngineのVMインスタンスを一つ新たに作成するというものです。

まず、https://cloud.google.com/にアクセスし、右上の「無料トライアル」をクリックします。
国を選び(日本で良いでしょう)、利用規約への同意にチェックを入れ、「続行」をクリックします。
必要な個人情報と、カード情報を入力し、「無料トライアル」を開始をクリックします。(Catapultネットワークを数日試すくらいであれば、おそらく無料枠に収まり、お金がかかることは無いと思います。)
「最初のプロジェクトにユーザーを追加する」という画面が出てきますが、一旦は自分だけで作業を進めると思うので、「スキップ」をクリックします。
Compute Engineの中のVMインスタンスをクリックします。
最初は、Compute Engineの準備が整うまで、少し待つ必要があるかもしれません。
VMインスタンスの「作成」ボタンをクリックし、設定画面上でregionをasia-northeast (東京)にします。また、ブートディスクの「変更」をクリックし、OSイメージの中の「Ubuntu 18.04 LTS」にチェックを入れ、「選択」をクリックします。それ以外の設定項目は、今回のようなテスト目的ならば、そのままでも良いでしょう。
画面の下の方にある「作成」ボタンをクリックすると、VMインスタンスが作成され、少し待つと、そのVMインスタンスの行が表示されるでしょう。その行の「SSH」をクリックすると、作成したVMインスタンスへ接続して各種コマンドを実行できるブラウザの黒い画面(コマンドプロンプトのような見た目…以降ブラウザコンソールと呼びます)が立ち上がります。以降は、このブラウザコンソールにコマンドを打ち込んで、操作を進めていきます。

(GCP上に構築した)UbuntuへのNode.jsのインストール

Node.jsの環境構築は以下記事を参考にさせて頂きました。1～2.2までのコマンドを、ブラウザコンソールにて、順番に1行ずつコピペして実行すればよいと思います。ブラウザコンソールへの貼付は「Ctrl」+「V」コマンドで可能です。

注意点としては「Do you want to continue? [Y/n]」等のように確認を求められる時もあるので、その場合は、概ね「y」と入力して「Enter」で良いでしょう。

https://qiita.com/kerupani129/items/60ee8c8becc2fe9f0d28

(GCP上に構築した)UbuntuへのDockerのインストール

UbuntuへのDockerのインストールは、以下記事を参考にさせて頂きました。2～2.5までのコマンドを、ブラウザコンソールにて、順番に1つずつ実行すればよいでしょう。

注意点として、2.2, 2.4のコマンドは複数行を一気にブラウザコンソールにコピペして実行する必要がある点に注意してください。ブラウザコンソールに貼付するには「Ctrl」+「V」のショートカットを利用しましょう。

また、2.4では、「x86_64」の方のみ実行することに注意しましょう。

https://qiita.com/tkyonezu/items/0f6da57eb2d823d2611d

(GCP上に構築した)UbuntuへのDocker Composeのインストール

以下の公式ドキュメントのLinuxのタブを選択し、Install Compose on Linux systemsの段落のコマンドを順に実行すると良いでしょう。

https://docs.docker.com/compose/install/

以下、環境構築以外の実践時に詰まりやすいと感じたところ

上記の環境構築が全て完了していれば、以下を意識して、試していくと良いと思います。

・困ったら、まずは、タイプミスを疑ってみましょう。(しょうもない打ち間違えを、私もよくやってしまいます。)ファイル名等に関しては、実際にファイル名を確認してみて、トライしてみることをオススメします。

・権限の不足で失敗する箇所がいくつかあるので、sudoをつけてみましょう。

コマンドの最初に「sudo 」(sudoの後には半角スペース一文字分)を付けるという意識で進めると、詰まることなく、ブロックチェーンネットワークの立ち上げ、ノード群の停止まで進めると思います。(本来は、sudo をつけなくても上手くいくように、環境自体を設定すべきなのかもしれませんが、ここでは、第1章を確実に完走することを優先します。)

例

「npm install nem2-cli@0.13.0 -g」→「sudo npm install nem2-cli@0.13.0 -g」

「./cmds/start-all -d」 → 「sudo ./cmds/start-all -d」

「./cmds/stop-all」 → 「sudo ./cmds/stop-all」

・ブラウザでの表示内容の確認

また、ブラウザで表示内容を確認する箇所は、

curl http://localhost:3000/block/1

のようなコマンドで代用可能ですので、ブラウザコンソール上で直接コマンドを打ち込んで確認していきましょう。

・初期配布アドレスの確認

初期配布アドレスが記載されたファイルを確認する際には、「ls」で現在のフォルダ内にある、フォルダ・ファイルを確認し、フォルダ間移動はcdコマンド「cd build」「cd generated-address」、ファイルを開いて中身を確認するには「nano addresses.yaml」、そこでテキストをコピーするには、コピーしたい範囲を選択した瞬間にハサミマークが表示されればコピーされているので、ブラウザコンソールの外の自分が普段使っているテキストエディタにコピーしておきましょう。ちなみに、nanoの表示は「Ctrl」+「X」ショートカットで終了できます。

一つ上のフォルダに戻るには「cd ..」を使いましょう。

・無駄にVMを立ち上げっぱなしにしないこと→ほったらかしにし過ぎると、いずれは、課金が発生してしまうと思います。

試し終わったら、忘れず、「sudo ./cmds/stop-all」でノード群を停止し、GCPのVMインスタンスの一覧の対象ノードの右端の三点をクリックして「停止」をクリックし、仮想マシンを停止しておきましょう。

・インスタンス再起動後は、環境変数設定をもう一度実行する必要あり

注意点として、再度、右端の三点をクリックして「開始」をクリックし、仮想マシンを立ち上げたときには、設定した環境変数は消えているので、再度、「export PRIVATE_KEY=秘密鍵(人それぞれ異なる)」「export GENERATION_HASH=ジェネレーションハッシュ(人それぞれ異なる)」のコマンドで設定する必要があることに注意してください。

概ね、以上のような内容を念頭に置いてチャレンジすれば、非エンジニアの方でも、第一章は、最後まで完走できるのではないか…と思いました。ぜひ、多くの方にチャレンジして頂ければ…と思います。私も、できるだけ早く、最後まで完走して、自分なりのサービスを作り始めたいと改めて感じました。

nem