Install Samples, Binaries and Docker Images - 安装示例，二进制文件和Docker镜像

While we work on developing real installers for the Hyperledger Fabric binaries, we provide a script that will download and install samples and binaries to your system. We think that you’ll find the sample applications installed useful to learn more about the capabilities and operations of Hyperledger Fabric.

在我们为Hyperledger Fabric二进制文件开发真正的安装程序的同时，我们提供了一个脚本，可以下载并安装样本和二进制文件到你的系统。我们认为你会发现安装的示例应用程序对了解有关Hyperledger Fabric的功能和操作的更多信息非常有用。

Note

If you are running on Windows you will want to make use of the Docker Quickstart Terminal for the upcoming terminal commands. Please visit the Prerequisites - 必备组件 if you haven’t previously installed it. 如果您在 Windows 上运行，则需要使用Docker快速启动终端来执行即将发布的终端命令。 如果您之前没有安装，请访问 Prerequisites - 必备组件 。

If you are using Docker Toolbox on Windows 7 or macOS, you will need to use a location under C:\Users (Windows 7) or /Users (macOS) when installing and running the samples. 如果你在Windows 7或macOS系统下使用Docker Toolbox，则在安装和运行示例时，需要使用 C:\Users （Windows 7）或 /Users （macOS）下的位置。

If you are using Docker for Mac, you will need to use a location under /Users, /Volumes, /private, or /tmp. To use a different location, please consult the Docker documentation for file sharing. 如果你是在Mac系统下使用Docker，则需要在 /Users， /Volumes，/private 或 /tmp 下使用一个位置。要使用其他位置，请参阅Docker文档以获取 文件共享。

If you are using Docker for Windows, please consult the Docker documentation for shared drives and use a location under one of the shared drives. 如果你是在Windows系统下使用Docker，请参阅Docker文档中的 共享驱动器 并使用其中一个共享驱动器的位置。

Determine a location on your machine where you want to place the fabric-samples repository and enter that directory in a terminal window. The command that follows will perform the following steps:

  1. If needed, clone the hyperledger/fabric-samples repository
  2. Checkout the appropriate version tag
  3. Install the Hyperledger Fabric platform-specific binaries and config files for the version specified into the root of the fabric-samples repository
  4. Download the Hyperledger Fabric docker images for the version specified

确定计算机上要放置 `fabric-samples`存储库的位置，并在终端窗口中输入该目录。 后面的命令将执行以下步骤：

  1. 如果需要，克隆 hyperledger/fabric-samples 存储库
  2. 查看适当的版本标签
  3. 将指定版本的Hyperledger Fabric平台特定二进制文件和配置文件安装到fabric-samples存储库的根目录中
  4. 下载指定版本的Hyperledger Fabric docker镜像

Once you are ready, and in the directory into which you will install the Fabric Samples and binaries, go ahead and execute the following command:

准备好后，在要安装Fabric Samples和二进制文件的目录中，继续执行以下命令：

curl -sSL http://bit.ly/2ysbOFE | bash -s 1.3.0

Note

If you want to download Fabric, Fabric-ca and thirdparty Docker images you must pass the version identifier to the script. 如果要下载Fabric，Fabric-ca和第三方Docker镜像，则必须将版本标识符传递给脚本。

curl -sSL http://bit.ly/2ysbOFE | bash -s <fabric> <fabric-ca> <thirdparty>
curl -sSL http://bit.ly/2ysbOFE | bash -s 1.3.0 1.3.0 0.4.13

Note

If you get an error running the above curl command, you may have too old a version of curl that does not handle redirects or an unsupported environment.

Please visit the Prerequisites - 必备组件 page for additional information on where to find the latest version of curl and get the right environment. Alternately, you can substitute the un-shortened URL: https://raw.githubusercontent.com/hyperledger/fabric/master/scripts/bootstrap.sh 如果运行上述curl命令时出错，则可能是旧版本的curl不能处理重定向或不受支持的环境。 请访问 Prerequisites - 必备组件 页面，了解有关在何处查找最新版本curl并获取正确环境的其他信息。或者，你可以替换未缩写的URL：https://github.com/hyperledger/fabric/blob/master/scripts/bootstrap.sh

Note

You can use the command above for any published version of Hyperledger
Fabric. Simply replace 1.3.0 with the version identifier of the version you wish to install.

你可以在任何已发布的Hyperledger Fabric版本使用上述命令。 只需将 1.3.0 替换为你要安装的版本的版本标识符即可。

The command above downloads and executes a bash script that will download and extract all of the platform-specific binaries you will need to set up your network and place them into the cloned repo you created above. It retrieves the following platform-specific binaries:

  • cryptogen,
  • configtxgen,
  • configtxlator,
  • peer,
  • orderer,
  • idemixgen, and
  • fabric-ca-client

and places them in the bin sub-directory of the current working directory.

上面的命令下载并执行一个bash脚本，该脚本将下载并提取设置网络所需的所有特定于平台的二进制文件，并将它们放入您在上面创建的克隆仓库中。它检索以下特定平台的二进制文件：

  • cryptogen,
  • configtxgen,
  • configtxlator,
  • peer,
  • orderer,
  • idemixgen, 和
  • fabric-ca-client

并将它们放在当前工作目录的 bin 子目录中。

You may want to add that to your PATH environment variable so that these can be picked up without fully qualifying the path to each binary. e.g.:

你可能希望将其添加到PATH环境变量中，以便在不完全限定每个二进制文件的路径的情况下拾取这些变量。例如：

export PATH=<path to download location>/bin:$PATH

Finally, the script will download the Hyperledger Fabric docker images from Docker Hub into your local Docker registry and tag them as ‘latest’.

最后，该脚本会将 Docker Hub 中的Hyperledger Fabric docker映像下载到本地Docker注册表中，并将其标记为“最新”。

The script lists out the Docker images installed upon conclusion.

该脚本列出了结束时安装的Docker镜像。

Look at the names for each image; these are the components that will ultimately comprise our Hyperledger Fabric network. You will also notice that you have two instances of the same image ID - one tagged as “amd64-1.x.x” and one tagged as “latest”. Prior to 1.2.0, the image being downloaded was determined by uname -m and showed as “x86_64-1.x.x”.

查看每个镜像的名称；这些组件最终将构成我们的Hyperledger Fabric网络。你还会注意到，你有两个具有相同镜像ID的实例——一个标记为“amd64-1.x.x”，另一个标记为“最新”。在1.2.0之前，下载的图像由 uname -m 确定，并显示为“x86_64-1.x.x”。

Note

On different architectures, the x86_64/amd64 would be replaced
with the string identifying your architecture.

在不同的体系结构中，x86_64/amd64将替换为标识你的体系结构的字符串。

Note

If you have questions not addressed by this documentation, or run into issues with any of the tutorials, please visit the Still Have Questions? page for some tips on where to find additional help.

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