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

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

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

インストール・プロセスが完了したら、次の手順を実行します。

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

前提条件

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

ノート:

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

ブロックチェーン・アプリケーション・ビルダーをインストールすると、前提条件チェックが最初に実行されます。前提条件チェックが失敗すると、インストール・プロセスは停止します。

• macOS
• Linux
• ウィンドウ

前提条件

• Rancher Desktop (1.4.1でテスト済み)ブロックチェーン・アプリケーション・ビルダーは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.20.10に移動します。ブロックチェーン・アプリケーション・ビルダーのインストール後、Goチェーンコード・プロジェクトの追加設定を参照してください。
• Blockchain App Builderの同期機能を使用する場合は、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. 次のコマンドを入力して、Node.js 18.16.0をnvmのデフォルトとして設定します。

   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.20.10に移動します。ブロックチェーン・アプリケーション・ビルダーのインストール後、Goチェーンコード・プロジェクトの追加設定を参照してください。
• Blockchain App Builderの同期機能を使用する場合は、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. 次のコマンドを入力して、Node.js 18.16.0をnvmのデフォルトとして設定します。

   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でテスト済み)ブロックチェーン・アプリケーション・ビルダーは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.20.10に移動します。ブロックチェーン・アプリケーション・ビルダーのインストール後、Goチェーンコード・プロジェクトの追加設定を参照してください。
• Blockchain App Builderの同期機能を使用する場合は、Gitをインストールし、次のコマンドに示すようにユーザー名と電子メールを構成します。<your_name>および<email>のかわりに、ユーザー名および電子メール・アドレスを指定してください。

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

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

Rancher Desktopのインストール

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

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

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

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

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。