ブロックチェーン・アプリケーション・ビルダーCLIのインストールおよび構成

次のプラットフォームがサポートされています。

• macOS
• Oracle Linux 8.0または9.0
• Microsoft Windows 10または11

インストール・プロセスが完了すると、次のようになります。

• インストールを確認します。
• Goチェーンコード・プロジェクトを使用している場合は、追加の構成ステップを完了します。

前提条件

ブロックチェーン・アプリケーション・ビルダーCLIをローカル・システムにインストールする前に、前提条件をインストールする必要があります。

ノート:

ブロックチェーン・アプリケーション・ビルダーは、Oracle Blockchain Platformとそのコンパイラと連携します。次の項で説明した前提条件以外のバージョンを使用する場合、チェーンコードをリモートのOracle Blockchain Platformネットワークにデプロイすると失敗する可能性があります。

Blockchain App Builderをインストールすると、前提条件チェックが最初に実行されます。前提条件チェックが失敗すると、インストール・プロセスが停止します。

• macOS
• Linux
• ウィンドウ

前提条件

• Rancher Desktop(1.4.1でテスト)Blockchain App BuilderはDockerでも動作しますが、Rancher Desktopでテストおよび検証されています。Rancher Desktopを使用する場合は、Rancher Desktopをインストールする前にDockerを完全にアンインストールしてください。Rancher Desktopをインストールした後、コンテナ・ランタイムがdockerd (moby)に設定されていることを確認します。Rancher Desktop 1.4.1でコンテナ・ランタイムを確認するには、「Kubernetes設定」、「コンテナ・ランタイム」の順にクリックします。
• Node.jsバージョン18の最新リリース(18.15.0および18.16.0でテスト済)。バージョン18より前または後のNode.jsのバージョンは使用しないでください。
• npm v8.xまたはv9.x (9.5.0および9.5.1でテスト済)
• v1.21.9 以降は実行しますが、Go v1.22以降は実行しません。ブロックチェーン・アプリケーション・ビルダーのインストール後、Goチェーンコード・プロジェクトの追加設定を参照してください。
• ブロックチェーン・アプリケーション・ビルダーの同期機能を使用する場合は、Gitをインストールしてから、次のコマンドに示すようにユーザー名および電子メールを構成します。<your_name>および<email>のかわりに、ユーザー名および電子メール・アドレスを指定してください。

  git config --global user.name "<your_name>" 
  

  git config --global user.email "<email>"

nvmを使用したNode.jsおよびnpmのインストール

nvmを使用してNode.jsおよびnpmをインストールすると、sudoを使用せずにさらにコマンドを実行できます。

1. 次のコマンドを入力してnvmをインストールします:

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

2. 該当するファイル~/.bash_profile、~/.profile、~/.bashrcまたは~/.zshrcにコード・スニペットを追加します。

   export NVM_DIR="$HOME/.nvm"
   [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
   [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

3. オペレーティング・システムからログアウトし、再びオペレーティング・システムにログインします。
4. 次のコマンドを入力して、nvmのインストールを確認します。

   nvm version

5. Node.jsおよびnpmをインストールするには、次のコマンドを入力します。

   nvm install 18.16.0

6. 次のコマンドを入力して、nvmでNode.js 18.16.0をデフォルトとして設定します。

   nvm alias default 18.16.0

前提条件

• Docker v20.10.0以上
• Docker Compose v1.23.0以降
• Node.jsバージョン18の最新リリース(18.15.0および18.16.0でテスト済)。バージョン18より前または後のNode.jsのバージョンは使用しないでください。
• npm v8.xまたはv9.x (9.5.0および9.5.1でテスト済)
• v1.21.9 以降は実行しますが、Go v1.22以降は実行しません。ブロックチェーン・アプリケーション・ビルダーのインストール後、Goチェーンコード・プロジェクトの追加設定を参照してください。
• ブロックチェーン・アプリケーション・ビルダーの同期機能を使用する場合は、Gitをインストールしてから、次のコマンドに示すようにユーザー名および電子メールを構成します。<your_name>および<email>のかわりに、ユーザー名および電子メール・アドレスを指定してください。

  git config --global user.name "<your_name>" 
  

  git config --global user.email "<email>"

nvmを使用したNode.jsおよびnpmのインストール

nvmを使用してNode.jsおよびnpmをインストールすると、sudoを使用せずにさらにコマンドを実行できます。

1. 次のコマンドを入力してnvmをインストールします:

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

2. 該当するファイル~/.bash_profile、~/.profile、~/.bashrcまたは~/.zshrcにコード・スニペットを追加します。

   export NVM_DIR="$HOME/.nvm"
   [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
   [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

3. オペレーティング・システムからログアウトし、再びオペレーティング・システムにログインします。
4. 次のコマンドを入力して、nvmのインストールを確認します。

   nvm version

5. Node.jsおよびnpmをインストールするには、次のコマンドを入力します。

   nvm install 18.16.0

6. 次のコマンドを入力して、nvmでNode.js 18.16.0をデフォルトとして設定します。

   nvm alias default 18.16.0

Dockerのインストール

dnfが更新され、カーネルに基づいて現在のリポジトリを指していることを確認します。

1. 次のコマンドを入力して、リポジトリ・リストにDockerを追加します:

   sudo dnf config-manager --add-repo=https://download.docker.com/linux/centos/docker-ce.repo

2. 次のコマンドを入力してDockerをインストールします:

   dnf install docker-ce -y --allowerasing

3. 次のコマンドを入力して、Dockerをサービスとして起動します:

   sudo systemctl enable --now docker

4. 次のコマンドを入力して、現在のユーザーがDockerにアクセスできることを確認します:

   sudo groupadd docker
   sudo usermod -aG docker $USER

5. システムを再起動するには、次のコマンドを入力します。

   sudo reboot

Docker Composeのインストール

1. 次のcurlコマンドを入力して、Docker Composeを取得します:

   sudo curl -L https://github.com/docker/compose/releases/download/v2.5.0/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compos

2. 次のコマンドを入力して、Docker Composeに実行可能権限を追加します:

   sudo chmod +x /usr/local/bin/docker-compose

前提条件

• Rancher Desktop(1.4.1でテスト)Blockchain App BuilderはDockerでも動作しますが、Rancher Desktopでテストおよび検証されています。
• Node.jsバージョン18の最新リリース(18.15.0および18.16.0でテスト済)。バージョン18より前または後のNode.jsのバージョンは使用しないでください。
• npm v8.xまたはv9.x (9.5.0および9.5.1でテスト済)
• v1.21.9 以降は実行しますが、Go v1.22以降は実行しません。ブロックチェーン・アプリケーション・ビルダーのインストール後、Goチェーンコード・プロジェクトの追加設定を参照してください。
• Blockchain App Builderの同期機能を使用する場合は、Gitをインストールし、次のコマンドに示すようにユーザー名と電子メールを構成します。<your_name>および<email>のかわりに、ユーザー名および電子メール・アドレスを指定してください。

  git config --global user.name "<your_name>" 
  

  git config --global user.email "<email>"

Rancherデスクトップのインストール

Microsoft WindowsにRancher Desktopをインストールするには、次のステップを実行します。

1. Dockerがローカル・コンピュータにインストールされている場合は、完全にアンインストールします。
2. Rancher Desktopをダウンロードしてインストールします。
3. インストール・ウィザードの完了後、Rancher Desktopを開く前に、次のコマンドを実行します。

   wsl --install
   wsl --set-default-version 2
   wsl --setdefault rancher-desktop

4. Rancher Desktopを開き、設定プロセスを完了します。
5. Rancher Desktopをインストールした後、コンテナ・ランタイムがdockerd (moby)に設定されていることを確認します。Rancher Desktop 1.4.1でコンテナ・ランタイムを確認するには、「Kubernetes設定」、「コンテナ・ランタイム」の順にクリックします。

ブロックチェーン・アプリケーション・ビルダーをインストールします

Oracle Blockchain Platformコンソールの「ブロックチェーン・アプリケーション・ビルダー」ペインの「開発者ツール」タブからブロックチェーン・アプリケーション・ビルダーCLIパッケージ(oracle-ochain-cli-x.x.x.tgz)をダウンロードします。

• macOS
• Linux
• ウィンドウ

1. 次のコマンドを入力して、XcodeまたはXCodeコマンドライン・ツール(xcode-select)をインストールします。

   sudo xcode-select –install

2. ブロックチェーン・アプリケーション・ビルダーをインストールするには、次のコマンドを入力します(インストールするバージョンの.tgzファイルの名前を調整します)。

   npm install -g oracle-ochain-cli-x.x.x.tgz

Mac OS Catalinaでxcode-selectに問題が発生することがあります。これらの問題が発生した場合は、次のコマンドを使用して、xcode-selectをリセットして再起動します。

xcode-select –-reset

1. ブロックチェーン・アプリケーション・ビルダーをインストールするには、次のコマンドを入力します(インストールするバージョンの.tgzファイルの名前を調整します)。

   npm install -g oracle-ochain-cli-x.x.x.tgz

2. グループ・メンバーシップを有効にするには、現在のユーザーとしてログアウトして再度ログインします。

前提条件となるソフトウェアをすべてインストールしたら、次のコマンドを入力してBlockchain App Builderをインストールします(インストールするバージョンの.tgzファイルの名前を調整します)。

npm install -g oracle-ochain-cli-x.x.x.tgz

インストールの検証

ターミナルで、ochain -vと入力します。出力には、ブロックチェーン・アプリケーション・ビルダーCLIの使用状況、オプションおよびコマンドが表示されます。

チェーンコード・プロジェクトの実行の追加設定

Goプロジェクトを開発するには、GOPATH環境変数を設定する必要があります。これにより、Goはワークスペースを検索し、コードを実行できます。

• macOS
• Linux
• ウィンドウ

GOPATH環境変数を設定する前に、go/フォルダが$HOMEディレクトリに存在することを確認してください。そうでない場合は、次のコマンドを入力して、ホーム・ディレクトリにgo/ディレクトリを作成します:

mkdir $HOME/go

該当するファイルに次の変数(~/.bash_profile、~/.profile、~/.bashrcまたは~/.zshrc)を追加して、GOPATH環境変数を設定します。

export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

ファイルを編集したら、次のコマンドを実行して変更をただちに有効にします:

source ~/.bash_profile

または、前の変数を/etc/bashrcファイルに追加して、システム全体に変更を適用できます。

GOPATH環境変数を設定する前に、go/フォルダが$HOMEディレクトリに存在することを確認してください。そうでない場合は、次のコマンドを入力して、ホーム・ディレクトリにgo/ディレクトリを作成します:

mkdir $HOME/go

該当するファイルに次の変数(~/.bash_profile、~/.profile、~/.bashrcまたは~/.zshrc)を追加して、GOPATH環境変数を設定します。

export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

ファイルを編集したら、次のコマンドを実行して変更をただちに有効にします:

source ~/.bash_profile

または、前の変数を/etc/bashrcファイルに追加して、システム全体に変更を適用できます。

ホーム・ディレクトリにgo/ディレクトリを作成します: C:\Users\<username>\go。