Hyperledger Fabric 官方最新翻譯---入門(一)(Prerequisites)
在我們開始前,如果你之前沒有做過,你可能需要檢查一下所有的先決條件,看看你準備開發區塊鏈應用程式或者操作fabric的環境內有沒有裝好。
安裝cURL
如果沒有被安裝或者執行該文件的curl命令時報錯,那麼請下載最新版本的cURL工具。
注意:如果你再Windows平臺,請參閱下面關於Windows extras的具體說明。
Docker和Docker Compose
接下來你需要在環境中安裝:
- MacOSX, *nix, or Windows 10: Docker Docker version 17.06.2-ce or
greater is required. - Older versions of Windows: Docker Toolbox again, Docker version Docker 17.06.2-ce or greater is required.
你可以在終端用如下指令檢查你的Docker版本
docker --version
注意:安裝Docker也還需要安裝Docker compose,如果你已經安裝了Docker,你可以檢查有沒有安裝1.14.0或者更高版本的Docker Compose。如果安裝不了,我們推薦你安裝一個更高更新版本的Docker。
你可以在終端用如下指令檢查Docker Compose版本
docker-compose --version
Go 程式語言
Fabric的很多元件都是用Go 程式語言。所以需要1.10,X版本的Go。
考慮到我們將要用Go語言編寫鏈碼程式,有兩個環境變數需要正確的設定。如果你在Linux環境使用bash指令碼,那麼可以將他們設定合適的啟動檔案中,例如你的~/.bashrc檔案。
第一,你必須要GOPATH設定fabric的程式碼下載路徑作為Go的workspace,如下:
export GOPATH=$HOME/go
注意:你必須設定GOPATH變數。儘管在Linux中,GOPATH變數可以被設定為冒號的分割的多個目錄而且如果沒有設定,會使用預設值$HOME/go。當前的fabric構建框架還是需要設定和匯出該變數,而且它只能包含Go工作區的單個目錄名稱。(這個限制將在未來的版本中被移除)
第二,你可以延伸你的命令搜尋目錄到包含Go bin的目錄(同樣也可以設定到合適的啟動檔案中),例如如下的Linux,bash例子
export PATH=$PATH:$GOPATH/bin
在一個新的Go語言工作環境,這個目錄可能並不存在,但稍後會有Fabric構建系統進行填充,其中一小部分Go可執行檔案會被用於構建系統的其他部分。所以即使現在還沒有這個資料夾,依然像上面shell指令碼一樣擴充套件你的搜尋路徑。
Node的執行環境和NPM
如果你想要用fabric SDK-Node.js開發應用程式。你需要安裝8.9.x版本的Node.js。
注意:Node.js 9.x版本不支援
注意:安裝Node.js也要安裝NPM,但是建議你確認安裝的NPM版本。你就可以用如下指令升級npm工具
npm install npm@5.6.0 -g
Python
注意:以下內容僅適用於Ubuntu 16.04使用者
預設 Ubuntu 16.04安裝的是Python3.5.1。Fabric Node.js SDK需要迭代到Python2.7為了npm install指令可以操作能成功執行。用如下命令,恢復到2.7版本:
sudo apt-get install python
檢視你的版本:
python --version
Windows附件操作
如果你在Windows7環境下開發,你會希望在使用Git Bash的Docker Quickstart Terminal中工作,併為內建的Windows shell提供更好的選擇。
但是經驗告訴我們這是一個功能收限制的簡單開發環境。它可以執行Docer基本指令,例如Getting Started裡面的,但是涉及make和docker命令的操作可能會遇到困難。
在Windows10你可以使用原生態的Docker分佈而且你可以使用Windows PowerShell。但是為了二進位制命令可以成功執行,你還是需要uname命令變數。你可以把它作為Git的一部分,但要注意只支援64位版本。
執行git clone指令前,執行如下指令
git config --global core.autocrlf false
git config --global core.longpaths true
你可以用如下命令檢查這些引數
git config --get core.autocrlf
git config --get core.longpaths
將返回false和true。
Git和Docker Toolbox的curl命令已經太舊了,無法處理入門示例內的重定向。確保你從cURL 下載頁面下載和安裝了最新的版本。對應Node,你可能還要VC++的構建工具,它們可以通過如下指令免費的下載和安裝
npm install --global windows-build-tools
檢視NPM windows構建指南瞭解更多。
一旦完成,你也可以用如下指令安裝NPM GRPC模組
npm install --global grpc
你的環境現在已經準備好了去完成入門例項和指南了。
注意:如果這篇文件文件你還有問題沒有解決,如果教程中遇到了任何問題,可以訪問“仍然還有問題?”頁面,裡面會有一些提示關於如何找到額外的幫助。