安裝並設定區塊鏈 App 產生器 CLI

下列是支援的平台：

• macOS
• Oracle Linux 8.0 或 9.0
• Microsoft Windows 10 或 11

完成安裝程序之後：

• 驗證您的安裝。
• 如果您使用 Go chaincode 專案，請完成其他組態設定步驟。

必備條件

在本機系統上安裝 Blockchain App Builder CLI 之前，必須先安裝先決條件。

附註：

Blockchain App Builder 與 Oracle Blockchain Platform 及其編譯器協調。如果您使用下列小節所述之先決條件以外的任何版本，將鏈碼部署到遠端 Oracle Blockchain Platform 網路可能會失敗。

安裝 Blockchain App Builder 時，會先執行先決條件檢查。如果先決條件檢查失敗，安裝處理作業就會停止。

• macOS
• Linux
• Windows

先決條件

• Rancher 桌面 (通過 1.4.1 測試)。Blockchain App Builder 也可以與 Docker 搭配使用，但已經使用 Rancher Desktop 進行測試和驗證。如果您打算使用 Rancher Desktop，請先完全解除安裝 Docker，再安裝 Rancher Desktop。安裝 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.23.2 或更新版本，但不要執行 v1.24 或更新版本。安裝 Blockchain App 產生器之後，請參閱 Go Chaincode 專案的其他設定。
• 如果您要使用區塊鏈 App 產生器的同步功能，請安裝 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 編寫 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.23.2 或更新版本，但不要執行 v1.24 或更新版本。安裝 Blockchain App 產生器之後，請參閱 Go Chaincode 專案的其他設定。
• 如果您要使用區塊鏈 App 產生器的同步功能，請安裝 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 編寫

1. 輸入下列 curl 命令以取得 Docker 組合：

   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 編寫：

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

先決條件

• Rancher 桌面 (通過 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.23.2 或更新版本，但不要執行 v1.24 或更新版本。安裝 Blockchain App 產生器之後，請參閱 Go Chaincode 專案的其他設定。
• 若要使用區塊鏈 App 產生器的同步功能，請安裝 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 設定值 > 容器程式實際執行。

安裝區塊鏈 App 產生器

從 Oracle Blockchain Platform 主控台區塊鏈 App 產生器窗格的開發人員工具頁籤下載 Blockchain App Builder CLI 套裝程式 (oracle-ochain-cli-x.x.x.tgz)。

• macOS
• Linux
• Windows

1. 輸入下列命令以安裝 Xcode 或 XCode 命令行工具 (xcode-select)。

   sudo xcode-select –install

2. 輸入下列命令以安裝區塊鏈 App 產生器 (根據您正在安裝的版本調整 .tgz 檔案的名稱)：

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

請注意，Mac OS Catalina 可能有 xcode-select 的問題。如果發生這些問題，請使用下列命令重設並重新啟動 xcode-select：

xcode-select –-reset

1. 輸入下列命令以安裝區塊鏈 App 產生器 (根據您正在安裝的版本調整 .tgz 檔案的名稱)：

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

2. 以目前的使用者身分登出，然後重新登入，讓群組成員身分生效。

安裝所有先決條件軟體之後，請輸入下列命令以安裝區塊鏈 App 產生器 (請根據您正在安裝的版本調整 .tgz 檔案的名稱)：

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

驗證安裝

在您的終端機中輸入 ochain -v。輸出顯示 Blockchain App Builder CLI 用法、選項和命令。

Go Chaincode 專案的其他設定

若要開發 Go 專案，您必須設定 GOPATH 環境變數。這可讓 Go 尋找您的工作區並執行您的程式碼。

• macOS
• Linux
• Windows

設定 GOPATH 環境變數之前，請確定 $HOME 目錄中有 go/ 資料夾。如果不是，請輸入下列命令在主目錄中建立 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 環境變數之前，請確定 $HOME 目錄中有 go/ 資料夾。如果不是，請輸入下列命令在主目錄中建立 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。