准备阶段

在我们开始之前,如果您还没有这样做,您可能希望检查以下所有先决条件是否已安装在您将开发区块链应用程序或运行 Hyperledger Fabric 的平台上。

安装 cURL

如果尚未安装cURl或在服务器上运行文档中的curl命令出错时请下载最新版本的 cURL 工具。

注解

如果您使用的是Windows,请参阅下面有关Windows附加功能( `Windows extras`_ )的特定说明。

Docker 和 Docker Compose

您将需要在将要运行或基于Hyperledger Fabric开发(或开发Hyperledger Fabric)的平台上安装以下内容:

  • MacOSX,* nix或Windows 10: 要求 Docker Docker版本17.06.2-ce及以上。
  • 较旧版本的Windows:Docker Toolbox - 要求Docker版本Docker 17.06.2-ce及以上。

您可以通过执行以下终端提示符中的命令来检查已安装的Docker的版本:

docker --version

注解

在Mac或Windows以及Docker Toolbox中安装Docker,也会安装 Docker Compose。 如果您已安装 Docker,则应检查是否已安装 Docker Compose版本1.14.0或更高版本。如果没有,我们建议您安装最新版本的Docker。

您可以通过执行以下终端提示符中的命令来检查已安装的Docker Compose的版本:

docker-compose --version

Go 语言

Hyperledger Fabric许多组件使用Go编程语言开发。

  • Go 要求 1.11.x 版本.

鉴于我们将在Go中编写链码程序,您需要正确设置两个环境变量; 您可以将这些设置永久保存在相应的启动文件中,例如您的个人 ~/.bashrc 文件(如果您在Linux下使用 bash shell)。

首先,您必须将环境变量 GOPATH 设置为指向包含下载的Fabric代码库的Go工作空间,例如:

export GOPATH=$HOME/go

注解

必须 设置GOPATH变量

即使在Linux中,Go的 GOPATH 变量可以是以冒号分隔的目录列表,如果未设置,将使用默认值 $HOME/go ,当前的Fabric构建框架仍然需要您设置和输出该变量,它必须 包含Go工作区的单个目录名称。(此限制可能会在将来的版本中删除。)

其次,您应该(再次,在适当的启动文件中)扩展您的命令搜索路径以包含Go ``bin``目录,例如下面是Linux下的``bash``示例:

export PATH=$PATH:$GOPATH/bin

虽然此目录可能不存在于新安装的Go工作区中,但稍后由Fabric构建系统填充,其中构建系统的其他部分使用少量Go可执行文件。因此,即使您目前还没有此类目录,也可以像上面那样扩展shell搜索路径。

Node.js运行环境及NPM

如果你将用Node.js的Hyperledger Fabric SDK开发Hyperledger Fabric的应用程序,则需安装Node.js的8.9.x版本.

注解

安装Node.js也会安装NPM,但建议您确认安装的NPM版本。 您可以使用以下命令升级 npm 工具:

npm install npm@5.6.0 -g

Python

注解

以下内容仅适用于Ubuntu 16.04用户。

默认情况下,Ubuntu 16.04附带了Python 3.5.1安装的 python3 二进制文件。Fabric Node.js SDK需要使用 Python 2.7版本才能成功完成 npm install 操作。使用以下命令安装2.7版本:

sudo apt-get install python

检查您的版本:

python --version

Windows附加功能

如果您在Windows 7上进行开发,则需要在使用 Git Bash 的Docker Quickstart终端中工作,它是一个比内置Windows shel更好的替代方案。

然而,经验表明这是一个功能有限的糟糕开发环境。它适合运行基于Docker的场景,如 入门,但你可能在操作包括``make``和 ``docker``命令时出现问题。

在Windows 10上,你应该使用本地Docker发行版,并且可以使用Windows PowerShell。但是你仍需要可用的 uname 命令以便成功运行 binaries 命令。

在运行任何``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 命令很旧,无法正确处理 :doc:`getting_started`中使用的重定向。 因此要确保你从 `cURL downloads page <https://curl.haxx.se/download.html>`__ 安装并使用的是较新版本。

对于Node.js,你还需要必需的Visual Studio C ++构建工具,它是免费可用的并且可以使用以下命令进行安装:

npm install --global windows-build-tools

有关更多详细信息,请参阅 NPM windows-build-tools 页面

完成此操作后,还应使用以下命令安装NPM GRPC模块:

npm install --global grpc

你的环境现在应该已准备好实现 入门 中的示例和教程。

注解

如果你有本文档未解决的问题,或遇到任何有关教程的问题,请访问 还有问题? 页面,获取有关在何处寻求其他帮助的一些提示。