Install Fabric and Fabric Samples

以下のインストール手順を実行する前に Prerequisites のインストールを行ってください。

私たちは、何かを理解する最良の方法は、実際に自分で使ってみることだと考えています。 我々はFabricの利用を支援するために、Docker composeを使用したシンプルなFabricテストネットワークと、そのコア機能をデモするサンプルアプリケーションのセットを作成しました。

また、 Fabric CLI tool binaries および Fabric Docker Images を事前にコンパイルしたものを用意しており、これらを自身の環境へダウンロードすることですぐに開始できます。

以下の手順にあるcURLコマンドは、Fabricテストネットワークを実行できる環境を設定します。具体的には、以下の手順を実行します:

  • hyperledger/fabric-samples リポジトリをクローンする。
  • 最新のHyperledger Fabric Dockerイメージをダウンロードし、 latest というタグを付与する。
  • 以下に示す、プラットフォーム固有のHyperledger Fabric CLIツールのバイナリと設定ファイルを、 fabric-samples ディレクトリの /bin と /config ディレクトリにダウンロードする。これらのバイナリは、テストネットワークとのやり取りに役立ちます。
    • configtxgen,
    • configtxlator,
    • cryptogen,
    • discover,
    • idemixgen,
    • orderer,
    • osnadmin,
    • peer,
    • fabric-ca-client,
    • fabric-ca-server

Download Fabric samples, Docker images, and binaries

作業ディレクトリの作成が必要です - 例えば、Goの開発者は $HOME/go/src/github.com/<your_github_userid> ディレクトリを利用します。これはGolangのコミュニティがGoプロジェクト向けに推奨しているものです。

mkdir -p $HOME/go/src/github.com/<your_github_userid>
cd $HOME/go/src/github.com/<your_github_userid>

インストールスクリプトを入手します:

curl -sSLO https://raw.githubusercontent.com/hyperledger/fabric/main/scripts/install-fabric.sh && chmod +x install-fabric.sh

オプション一覧を見るには、 -h オプションをつけてスクリプトを実行します:

./install-fabric.sh -h
Usage: ./install-fabric.sh [-f|--fabric-version <arg>] [-c|--ca-version <arg>] <comp-1> [<comp-2>] ... [<comp-n>] ...
        <comp>: Component to install one or more of  d[ocker]|b[inary]|s[amples]. If none specified, all will be installed
        -f, --fabric-version: FabricVersion (default: '2.5.4')
        -c, --ca-version: Fabric CA Version (default: '1.5.6')

Choosing which components

ダウンロードするコンポーネントを指定するには、次の引数の1つまたは複数を追加します。各引数は最初の文字のみに短縮できます。

  • Dockerを使用してFabricコンテナイメージをダウンロードするには docker を指定します
  • podmanを使用してFabricコンテナイメージをダウンロードするには podman を指定します
  • Fabricのバイナリをダウンロードするには binary を指定します
  • fabric-samples gitHub リポジトリを現在のディレクトリにクローンするには samples を指定します

Dockerコンテナをpullし、サンプルリポジトリをクローンするには、次のコマンドのいずれかを実行してください。

./install-fabric.sh docker samples binary
or
./install-fabric.sh d s b

引数が指定されていない場合、引数 docker binary samples が使用されます。

Choosing which version

デフォルトでは、コンポーネントの最新版が使用されます。これらは、オプション --fabric-version と -ca-version を使用して変更できます。-f と -c はそれぞれ対応する短縮形です。

例えば、v2.5.4のバイナリをダウンロードするには、次のコマンドを実行すると

./install-fabric.sh --fabric-version 2.5.4 binary

Fabricサンプル、Dockerイメージ、およびバイナリをシステムにインストールできます。

Note: これは、既存のスクリプトと同じ結果を得るための更新されたインストールスクリプトです。ただし、構文が改善されています。このスクリプトでは、インストールするコンポーネントを選択する際、積極的なオプトイン方式を採用しています。元のスクリプトは、同じ場所 curl -sSL https://raw.githubusercontent.com/hyperledger/fabric/main/scripts/bootstrap.sh| bash -s に引き続き存在しています。