# Using the Fabric test network Hyperledger FabricのDockerイメージとサンプルをダウンロードした後、 `fabric-samples`リポジトリで提供されているスクリプトを使用してテストネットワークをデプロイできます。 このテストネットワークは、ローカルマシンでノードを実行することでFabricについて学習するために提供されています。 開発者は、このテストネットワークを使用してスマートコントラクトとアプリケーションをテストできます。 このテストネットワークは、教育とテストのためのツールとしてのみ使用することを目的としており、 ネットワークをセットアップする方法のモデルとして使われることを意図していません。 基本的にスクリプトを改変することは勧められません。ネットワークを壊してしまうかもしれないからです。 このネットワークは制限された設定をもとにしており、本番ネットワークをデプロイする際のテンプレートとして使うべきではありません。 - ネットワークには、2つのピア組織とオーダリング組織を含みます。 - 単純化のため、単一ノードによるRaftオーダリングサービスの設定が用いられます。 - 複雑にならないように、TLSの認証局(CA)はデプロイされません。全ての証明書はルートCAによって発行されます。 - サンプルネットワークは、Docker Composeを用いてFabricネットワークをデプロイします。ノードはすべてDocker Composeのネットワーク内に隔離されているため、テストネットワークは動いている他のノードに接続するようには作られません。 Fabricを本番でどのように使うべきかについては、[本番ネットワークをデプロイする](deployment_guide_overview.html)を参照してください。 **注:** これらの手順は、最新の安定版Fabric Dockerイメージと、提供されるtarファイル内のコンパイル済みセットアップユーティリティに対して動作することが確認されています。 現在のmainブランチのイメージまたはツールを使用してこれらのコマンドを実行すると、エラーが発生する可能性があります。 ## Before you begin テストネットワークを実行する前に、Fabric Samplesをインストールする必要があります。 [getting_started](getting_started.html)に記載された手順に従って必要なソフトウェアをインストールしてください。 **重要:** テストネットワークはDocker Desktop の安定版であるバージョン 2.5.0.1 を用いて動作検証を行っており、それ以上のバージョンでは動作しない可能性があります。 ## Bring up the test network ネットワークを起動するためのスクリプトは、``fabric-samples``リポジトリの`test-network`ディレクトリにあります。 次のコマンドを使用して、テストネットワークディレクトリに移動します: ``` cd fabric-samples/test-network ``` このディレクトリには、ローカルマシン上のDockerイメージを使用してFabricネットワークを立ち上げる注釈付きスクリプト``network.sh``があります。 ``./network.sh -h``を実行して、スクリプトのヘルプテキストを表示できます: ``` Usage: network.sh [Flags] Modes: up - FabricのOrdererとピアノードを起動します。チャネルは作成されません。 up createChannel - 1つのチャネルを持つFabricネットワークを起動します。 createChannel - ネットワークが作られた後に、チャネルを作成して参加します。 deployCC - チェーンコードをチャネル上にデプロイします。(デフォルトは asset-transfer-basic) down - docker-compose downを用いてネットワークをクリアします。 Flags: network.sh up、network.sh createChannelのときに用いるもの: -ca - 暗号マテリアル (crypto material) を生成するための認証局(CA)を作成します。 -c - 使用するチャネル名 (デフォルトは"mychannel") -s - 使用するデータベースのバックエンド: goleveldb (デフォルト) or couchdb -r - CLIは指定した回数の試行後にタイムアウトします (デフォルトは5) -d - CLIは指定した秒だけ動作を遅延させます (秒単位で指定) (デフォルトは3) -i - ネットワークの起動に利用されるDockerイメージタグ (デフォルトは"latest") -cai - CAに利用されるDockerイメージタグ (デフォルトは"1.4.6") -verbose - verboseモード network.sh deployCCのときに用いるもの: -c - チェーンコードをデプロイするチャネルの名前 -ccn - チェーンコードの名前 -ccl - デプロイするチェーンコードのプログラミング言語: go (デフォルト), java, javascript, typescript -ccv - チェーンコードのバージョン。1.0 (default), v2, version3.x など -ccs - チェーンコード定義のシーケンス。整数を指定すること。1 (デフォルト), 2, 3など -ccp - チェーンコードのファイルパス -ccep - (オプション) 署名ポリシー文法によるチェーンコードのエンドースメントポリシー。デフォルトのポリシーはOrg1とOrg2からのエンドースメントを必要とするものです。 -cccg - (オプション) プライベートデータコレクションの設定ファイルのファイルパス -cci - (オプション) チェーンコードの初期化関数名。関数が指定された場合、初期化関数の実行が要求され、この関数が実行されます。 -h - このメッセージを表示します 指定可能なモードとフラグの組み合わせ up -ca -r -d -s -i -cai -verbose up createChannel -ca -c -r -d -s -i -cai -verbose createChannel -c -r -d -verbose deployCC -ccn -ccl -ccv -ccs -ccp -cci -r -d -verbose 例: network.sh up createChannel -ca -c mychannel -s couchdb -i 2.0.0 network.sh createChannel -c channelName network.sh deployCC -ccn basic -ccp ../asset-transfer-basic/chaincode-javascript/ -ccl javascript network.sh deployCC -ccn mychaincode -ccp ./user/mychaincode -ccv 1 -ccl javascript ``` 訳注: 暗号マテリアル (crypto material) は「証明書・公開鍵・秘密鍵といった暗号にかかわるファイル」のことを指しています。なお、実際にコマンドを実行した際には、英語でヘルプが表示されます。 `test-network`ディレクトリ内で、次のコマンドを実行して、以前に実行したコンテナやアーティファクトを削除します: ``` ./network.sh down ``` 訳注: アーティファクト (artifacts) は「本スクリプトの実行過程で生成されたファイル (ジェネシスブロックなど)」のことを指しています。 そして、次のコマンドを発行することでネットワークを立ち上げることができます。 もし別のディレクトリからスクリプトを実行しようとすると問題が発生します: ``` ./network.sh up ``` このコマンドは、2つのピアノードと1つのOrdererノードからなるFabricネットワークを作成します。 `./network.sh up`を実行してもチャネルは作成されませんが、これについては[後のステップ](#creating-a-channel) で説明します。 コマンドが正常に完了すると、作成されたノードのログが表示されます: ``` Creating network "fabric_test" with the default driver Creating volume "net_orderer.example.com" with default driver Creating volume "net_peer0.org1.example.com" with default driver Creating volume "net_peer0.org2.example.com" with default driver Creating peer0.org2.example.com ... done Creating orderer.example.com ... done Creating peer0.org1.example.com ... done Creating cli ... done CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 1667543b5634 hyperledger/fabric-tools:latest "/bin/bash" 1 second ago Up Less than a second cli b6b117c81c7f hyperledger/fabric-peer:latest "peer node start" 2 seconds ago Up 1 second 0.0.0.0:7051->7051/tcp peer0.org1.example.com 703ead770e05 hyperledger/fabric-orderer:latest "orderer" 2 seconds ago Up Less than a second 0.0.0.0:7050->7050/tcp, 0.0.0.0:7053->7053/tcp orderer.example.com 718d43f5f312 hyperledger/fabric-peer:latest "peer node start" 2 seconds ago Up 1 second 7051/tcp, 0.0.0.0:9051->9051/tcp peer0.org2.example.com ``` 上記のような結果が得られない場合は、[トラブルシューティング](#troubleshooting) に移動して、 何が間違っているのかを確認してください。デフォルトでは、ネットワークはcryptogenツールを使用してネットワークを起動します。 しかし、CAを使用することもできます ([認証局を使ったネットワークを立ち上げる](#bring-up-the-network-with-certificate-authorities) 参照)。 ### The components of the test network テストネットワークがデプロイされたら、しばらく時間をかけてそのコンポーネントを調べることができます。 次のコマンドを実行して、マシンで実行されているすべてのDockerコンテナを一覧表示します。`network.sh`スクリプトによって作成された3つのノードが表示されます: ``` docker ps -a ``` Fabricネットワーク上でやりとりする各ノードおよびユーザーは、 ネットワークに参加するために組織に所属する必要があります。 テストネットワークには、Org1とOrg2の2つのピア組織があります。 また、ネットワークのオーダリングサービスを維持する単一のオーダリング組織 (orderer organization) が含まれています。 [ピア](peers/peers.html) は、あらゆるFabricネットワークの基本的なコンポーネントです。 ピアはブロックチェーン台帳を保存し、台帳にコミットする前にトランザクションを検証します。 ピアは、ブロックチェーン台帳上の資産を管理するために使用されるビジネスロジックを含むスマートコントラクトを実行します。 ネットワーク内のすべてのピアは、組織に属している必要があります。 テストネットワークでは、各組織がそれぞれ1つのピア`peer0.org1.example.com`と`peer0.org2.example.com`を動かしています。 すべてのFabricネットワークには、[オーダリングサービス](orderer/ordering_service.html) も含まれています。 ピアはトランザクションを検証し、トランザクションのブロックをブロックチェーン台帳に追加しますが、 トランザクションの順序を決定したり、トランザクションを新しいブロックに追加したりすることはありません。 分散ネットワークでは、ピアはお互いに離れた場所にあって、トランザクションがいつ作成されたかについて共通の見解を持っていないかもしれません。 トランザクションの順序について合意を得ることは、ピアのオーバーヘッドを生み出すコストのかかるプロセスです。 オーダリングサービスにより、ピアはトランザクションの検証と台帳へのコミットに集中できます。 オーダリングノードは、クライアントからエンドースされたトランザクションを受信した後、トランザクションの順序について合意に至り、ブロックに追加します。 その後、ブロックはピアノードに配布され、ピアノードがブロックチェーン台帳にブロックを追加します。 今回のサンプルネットワークは、オーダリング組織によって運用されている単一ノードによるRaftオーダリングサービスを使用しています。 マシン上で実行されているオーダリングノードは`orderer.example.com`と表示されます。 テストネットワークは単一ノードのオーダリングサービスのみを使用しますが、本番のネットワークには複数のオーダリングノードがあり、 1つまたは複数のオーダリング組織によって運用されます。 複数のオーダリングノードは、Raft合意形成アルゴリズムを使用して、ネットワーク全体のトランザクションの順序について合意します。 ## Creating a channel マシン上ではピアノードとOrdererノードが実行されているので、 本スクリプトを使用して、Org1とOrg2の間のトランザクションを行うためのFabricのチャネルを作成できます。 チャネルは、特定のネットワークメンバー間の通信のプライベートレイヤーです。 チャネルは、チャネルに招待された組織のみが使用でき、ネットワークのその他のメンバーには見えません。 各チャネルには、個別のブロックチェーン台帳があります。 招待された組織は、ピアをチャネルに「参加」させて、チャネル台帳にデータを保存したり、チャネル上でのトランザクションを検証したりします。 `network.sh`スクリプトを使用して、Org1とOrg2間のチャネルを作成し、それらのピアをチャネルに参加させることができます。 次のコマンドを実行して、`mychannel`というデフォルトの名前でチャネルを作成します: ``` ./network.sh createChannel ``` コマンドが成功した場合、コンソールログに以下のようなメッセージが表示されます: ``` Channel 'mychannel' joined ``` チャネルフラグを使用して、名前をカスタマイズしたチャネルを作成することもできます。 例として、次のコマンドは`channel1`という名前のチャネルを作成します: ``` ./network.sh createChannel -c channel1 ``` チャネルフラグを使用すると、異なるチャネル名を指定して複数のチャネルを作成することもできます。 `mychannel`または`channel1`を作成した後、以下のコマンドを使用して、`channel2`という名前の2番目のチャネルを作成できます: ``` ./network.sh createChannel -c channel2 ``` **注:** 指定できるチャネル名には以下の制約があります: - 半角のアルファベット小文字、数字、ドット '.' 、ダッシュ '-' のみを含む - 250 字より短い - 記号以外から始まる 1つのステップでネットワークを立ち上げてチャネルを作成したい場合は、`up`モードと`createChannel`モードを一緒に使用できます: ``` ./network.sh up createChannel ``` ## Starting a chaincode on the channel チャネルを作成したら、[スマートコントラクト](smartcontract/smartcontract.html) を使用してチャネル台帳とやり取りできるようになります。 スマートコントラクトには、ブロックチェーン台帳上の資産を管理するビジネスロジックが含まれています。 ネットワークメンバーによって実行されるアプリケーションは、スマートコントラクトを呼び出して、台帳上に資産を作成したり、 それらの資産を変更および譲渡したりできます。 アプリケーションはまた、スマートコントラクトを参照して、台帳上のデータを読み取ります。 トランザクションが有効であることを保証するために、スマートコントラクトを使用して作成されたトランザクションは、 通常、チャネル台帳にコミットするために複数の組織によって署名される必要があります。 複数の署名は、Fabricの信頼モデルに不可欠です。 トランザクションに複数のエンドースメントを要求することで、チャネル上の1つの組織が台帳を改ざんしたり、合意されていないビジネスロジックを使用したりするのを防ぎます。 トランザクションに署名するには、各組織がピア上でスマートコントラクトを呼び出して実行する必要があり、ピアがトランザクションの出力に署名します。 出力に一貫性があり、十分な組織によって署名されている場合、トランザクションは台帳にコミットできます。 スマートコントラクトを実行する必要がある、チャネル上の設定された組織を指定するポリシーは、エンドースメントポリシーと呼ばれ、チェーンコード定義の一部としてチェーンコードごとに設定されます。 Fabricでは、スマートコントラクトはチェーンコードと呼ばれるパッケージでネットワークにデプロイされます。 チェーンコードは組織のピアにインストールされてからチャネルにデプロイされ、その後トランザクションをエンドースしてブロックチェーン台帳とやり取りするために使用できます。 チェーンコードをチャネルにデプロイする前に、チャネルのメンバーは、チェーンコードのガバナンスを確立するチェーンコード定義について合意する必要があります。 必要な数の組織が同意すると、チェーンコード定義をチャネルにコミットでき、チェーンコードを使用できるようになります。 `network.sh`を使用してチャネルを作成した後、次のコマンドを使用してチャネル上でチェーンコードを開始することができます: ``` ./network.sh deployCC -ccn basic -ccp ../asset-transfer-basic/chaincode-go -ccl go ``` `deployCC`サブコマンドは、 **asset-transfer (basic)r** チェーンコードを``peer0.org1.example.com``と``peer0.org2.example.com``にインストールし、 チャネルフラグを使用して指定されたチャネルにチェーンコードをデプロイします (チャネルが指定されていない場合は`mychannel`)。 チェーンコードを初めてデプロイする場合、本スクリプトはチェーンコードの依存関係をインストールします。 言語フラグ`-ccl`を使うことで、Go、typescript、javascript版のチェーンコードをインストールすることができます。 asset-transfer (basic)のチェーンコードは、`fabric-samples`ディレクトリの`asset-transfer-basic`フォルダにあります。 このフォルダには、例として提供され、チュートリアル内でFabricの機能を強調するために使用されるサンプルチェーンコードが含まれています。 ## Interacting with the network テストネットワークを起動したら、`peer` CLIを使用してそのネットワークとやり取りできます。 `peer` CLIを使用すると、デプロイされたスマートコントラクトを呼び出したり、チャネルを更新したり、 CLIから新しいスマートコントラクトをインストールしてデプロイしたりできます。 `test-network`ディレクトリから操作していることを確認してください。 [サンプル、バイナリ、Dockerイメージのインストール](install.html) の手順に従った場合、`fabric-samples`リポジトリの`bin`フォルダに`peer`バイナリがあります。 次のコマンドを使用して、これらのバイナリをパスに追加します: ``` export PATH=${PWD}/../bin:$PATH ``` また、`fabric-samples`リポジトリ内の`core.yaml`ファイルを指すように`FABRIC_CFG_PATH`を設定する必要があります: ``` export FABRIC_CFG_PATH=$PWD/../config/ ``` 以下で、`peer` CLIをOrg1として操作できるようにする環境変数を設定できます: ``` # Org1用の環境変数 export CORE_PEER_TLS_ENABLED=true export CORE_PEER_LOCALMSPID="Org1MSP" export CORE_PEER_TLS_ROOTCERT_FILE=${PWD}/organizations/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt export CORE_PEER_MSPCONFIGPATH=${PWD}/organizations/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp export CORE_PEER_ADDRESS=localhost:7051 ``` `CORE_PEER_TLS_ROOTCERT_FILE` および `CORE_PEER_MSPCONFIGPATH` 環境変数は、`organizations` フォルダ内のOrg1の暗号マテリアルを指しています。 `./network.sh deployCC -ccl go`を使用してasset-transfer (basic)チェーンコードをインストールして開始している場合、(Go)チェーンコードの `InitLedger` 関数を実行することで、台帳に初期資産を書き込むことができます。(もし、例えば `./network.sh deployCC -ccl javascript`を使って、typescriptやjavascriptを実行している場合には、それぞれの言語版のチェーンコードの `InitLedger` 関数を実行することになります) 次のコマンドを実行して、台帳を資産で初期化します。(CLI で peer コマンドを実行する場合、 Fabric Gateway ピアにはアクセスしないため、エンドースを依頼するピアをコマンド上で特定する必要があります。) ``` peer chaincode invoke -o localhost:7050 --ordererTLSHostnameOverride orderer.example.com --tls --cafile ${PWD}/organizations/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem -C mychannel -n basic --peerAddresses localhost:7051 --tlsRootCertFiles ${PWD}/organizations/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt --peerAddresses localhost:9051 --tlsRootCertFiles ${PWD}/organizations/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt -c '{"function":"InitLedger","Args":[]}' ``` このコマンドが成功した場合、次のような出力が見られるはずです: ``` -> INFO 001 Chaincode invoke successful. result: status:200 ``` これでCLIから台帳にクエリすることができるようになります。次のコマンドを実行して、チャネルの台帳に追加された資産のリストを取得してください。 ``` peer chaincode query -C mychannel -n basic -c '{"Args":["GetAllAssets"]}' ``` 成功すると、次のような出力が見られるはずです: ``` [ {"ID": "asset1", "color": "blue", "size": 5, "owner": "Tomoko", "appraisedValue": 300}, {"ID": "asset2", "color": "red", "size": 5, "owner": "Brad", "appraisedValue": 400}, {"ID": "asset3", "color": "green", "size": 10, "owner": "Jin Soo", "appraisedValue": 500}, {"ID": "asset4", "color": "yellow", "size": 10, "owner": "Max", "appraisedValue": 600}, {"ID": "asset5", "color": "black", "size": 15, "owner": "Adriana", "appraisedValue": 700}, {"ID": "asset6", "color": "white", "size": 15, "owner": "Michel", "appraisedValue": 800} ] ``` チェーンコードは、ネットワークのメンバーが台帳上の資産を移転したり変更しようとするときに実行されます。次のコマンドを使って、asset-transfer (basic)のチェーンコードを実行して台帳上のある資産の所有者を変更してください。 ``` peer chaincode invoke -o localhost:7050 --ordererTLSHostnameOverride orderer.example.com --tls --cafile ${PWD}/organizations/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem -C mychannel -n basic --peerAddresses localhost:7051 --tlsRootCertFiles ${PWD}/organizations/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt --peerAddresses localhost:9051 --tlsRootCertFiles ${PWD}/organizations/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt -c '{"function":"TransferAsset","Args":["asset6","Christopher"]}' ``` コマンドが成功すると、次のような応答が見られるはずです: ``` 2019-12-04 17:38:21.048 EST [chaincodeCmd] chaincodeInvokeOrQuery -> INFO 001 Chaincode invoke successful. result: status:200 ``` asset-transfer (basic)チェーンコードのエンドースメントポリシーでは、トランザクションがOrg1とOrg2によって署名される必要があるため、 chaincode invokeコマンドは、 `--peerAddresses` フラグを用いて `peer0.org1.example.com` と `peer0.org2.example.com` の両方をターゲットにする必要があります。 ネットワークに対してTLSが有効になっているため、本コマンドは `--tlsRootCertFiles` フラグを使用して各ピアのTLS証明書も参照する必要があります。 チェーンコードを呼び出した後、別のクエリを使用して、呼び出しによってブロックチェーン台帳上のアセットがどのように変更されたかを確認できます。 すでにOrg1のピアにクエリを実行しているので、この機会にOrg2のピアで動いているチェーンコードをクエリしてみます。 Org2として動作するように、次のように環境変数を設定します: ``` # Org2用の環境変数 export CORE_PEER_TLS_ENABLED=true export CORE_PEER_LOCALMSPID="Org2MSP" export CORE_PEER_TLS_ROOTCERT_FILE=${PWD}/organizations/peerOrganizations/org2.example.com/peers/peer0.org2.example.com/tls/ca.crt export CORE_PEER_MSPCONFIGPATH=${PWD}/organizations/peerOrganizations/org2.example.com/users/Admin@org2.example.com/msp export CORE_PEER_ADDRESS=localhost:9051 ``` ここで、`peer0.org2.example.com`上で動いているasset-transfer (basic)チェーンコードにクエリします: ``` peer chaincode query -C mychannel -n basic -c '{"Args":["ReadAsset","asset6"]}' ``` 結果は`"asset6"`がChristopherに譲渡されたことを示します: ``` {"ID":"asset6","color":"white","size":15,"owner":"Christopher","appraisedValue":800} ``` ## Bring down the network テストネットワークの使用が終了したら、次のコマンドを使用してネットワークを停止できます: ``` ./network.sh down ``` このコマンドは、ノードとチェーンコードのコンテナを停止して削除し、 組織の暗号マテリアルを削除し、Dockerレジストリからチェーンコードイメージを削除します。 このコマンドは、以前に実行したときのチャネルアーティファクトとDockerボリュームも削除し、 何か問題が発生した場合に`./network.sh up`を再度実行できるようにします。 ## Next steps ここまでで、テストネットワークを使用してHyperledgerFabricをローカルマシンにデプロイしたので、 チュートリアルを使用してあなた自身のソリューションの開発を開始できます: - [スマートコントラクトをチャネルにデプロイする](deploy_chaincode.html) チュートリアルを使用して、 あなた自身のスマートコントラクトをテストネットワークにデプロイする方法を学びます。 - [Fabricアプリケーションの実行](write_first_app.html) チュートリアルにアクセスして、 Fabric SDKが提供するAPIを使用して、クライアントアプリケーションからスマートコントラクトを呼び出す方法を学習してください。 Fabricのチュートリアルの完全なリストは、[チュートリアル](tutorials.html) ページにあります。 ## Bring up the network with Certificate Authorities Hyperledger Fabricは、公開鍵基盤 (Public Key Infrastructure, PKI) を使用して、 すべてのネットワーク参加者のアクションを検証します。 トランザクションを送信するすべてのノード、ネットワーク管理者、およびユーザーは、アイデンティティを検証するために公開証明書と秘密鍵を持っている必要があります。 これらのアイデンティティには、証明書がネットワークのメンバーである組織によって発行されたことを証明する、有効な信頼のルートが必要です。 `network.sh`スクリプトは、ピアノードとオーダリングノードを作成する前に、ネットワークをデプロイして運用するために必要なすべての暗号マテリアルを作成します。 デフォルトでは、本スクリプトはcryptogenツールを使用して証明書と鍵を作成します。 このツールは開発およびテスト用に提供されており、有効な信頼のルートを持つFabricの組織に必要な暗号マテリアルをすばやく作成できます。 `./network.sh up`を実行すると、cryptogenツールがOrg1、Org2、およびOrderer Orgの証明書と鍵を作成していることがわかります。 ``` creating Org1, Org2, and ordering service organization with crypto from 'cryptogen' /Usr/fabric-samples/test-network/../bin/cryptogen ########################################################## ##### Generate certificates using cryptogen tool ######### ########################################################## ########################################################## ############ Create Org1 Identities ###################### ########################################################## + cryptogen generate --config=./organizations/cryptogen/crypto-config-org1.yaml --output=organizations org1.example.com + res=0 + set +x ########################################################## ############ Create Org2 Identities ###################### ########################################################## + cryptogen generate --config=./organizations/cryptogen/crypto-config-org2.yaml --output=organizations org2.example.com + res=0 + set +x ########################################################## ############ Create Orderer Org Identities ############### ########################################################## + cryptogen generate --config=./organizations/cryptogen/crypto-config-orderer.yaml --output=organizations + res=0 + set +x ``` ただし、テストネットワークのスクリプトには、認証局 (CA) を使用してネットワークを起動するオプションもあります。 本番用ネットワークでは、各組織は、組織に属するアイデンティティを作成するCA (または複数の中間CA) を運用します。 組織が運用する1つのCAが作成したすべてのアイデンティティは、同じ信頼のルートを共有します。 cryptogenを使用するよりも時間がかかりますが、CAを使用してテストネットワークを立ち上げると、ネットワークが本番環境にどのようにデプロイされるかがわかります。 CAをデプロイすると、クライアントのアイデンティティをFabric SDKに登録し、アプリケーションの証明書と秘密鍵を作成することもできます。 Fabric CAを使用してネットワークを立ち上げたい場合は、まず以下のコマンドを実行して、実行中のネットワークをすべて停止させます: ``` ./network.sh down ``` そうすれば、CAフラグのついたネットワークを立ち上げることができます: ``` ./network.sh up -ca ``` このコマンドを発行すると、ネットワーク内の組織ごとに1つずつ、合計3つのCAが表示されることが確認できます。 ``` ########################################################## ##### Generate certificates using Fabric CA's ############ ########################################################## Creating network "net_default" with the default driver Creating ca_org2 ... done Creating ca_org1 ... done Creating ca_orderer ... done ``` CAがデプロイされた後、`./network.sh`スクリプトによって生成されたログを調べるのに時間をかける価値があります。 テストネットワークは、Fabric CAクライアントを使用して、ノードとユーザーのアイデンティティを各組織のCAに登録します。 次に、スクリプトはenrollコマンドを使用して、アイデンティティごとにMSPフォルダを生成します。 MSPフォルダには、各アイデンティティの証明書と秘密鍵が含まれており、CAを運用していた組織におけるアイデンティティの役割とメンバーシップを確立します。 次のコマンドを使用して、Org1の管理者ユーザーのMSPフォルダを調べることができます: ``` tree organizations/peerOrganizations/org1.example.com/users/Admin@org1.example.com/ ``` このコマンドは、MSPフォルダの構造と設定ファイルを表示します: ``` organizations/peerOrganizations/org1.example.com/users/Admin@org1.example.com/ └── msp ├── IssuerPublicKey ├── IssuerRevocationPublicKey ├── cacerts │   └── localhost-7054-ca-org1.pem ├── config.yaml ├── keystore │   └── 58e81e6f1ee8930df46841bf88c22a08ae53c1332319854608539ee78ed2fd65_sk ├── signcerts │   └── cert.pem └── user ``` 管理者ユーザーの証明書は`signcerts`フォルダにあり、 秘密鍵は`keystore`フォルダにあります。 MSPの詳細については、[メンバーシップサービスプロバイダ](membership/membership.html) のコンセプトトピックを参照してください。 cryptogenとFabric CAの両方が、`organizations`フォルダ内に各組織の暗号マテリアルを生成します。 ネットワークのセットアップに使用されるコマンドは、 `organizations/fabric-ca` ディレクトリの `registerEnroll.sh` スクリプト内にあります。 Fabric CAを使用してFabricネットワークをデプロイする方法の詳細については、[Fabric CA運用ガイド](https://hyperledger-fabric-ca.readthedocs.io/en/latest/operations_guide.html) にアクセスしてください。 [アイデンティティ](identity/identity.html) および[メンバーシップ](membership/membership.html) のコンセプトトピックにアクセスすると、FabricがPKIをどのように使用するかについて詳しく知ることができます。 ## What's happening behind the scenes? サンプルネットワークについて詳しく知りたい場合は、`test-network`ディレクトリにあるファイルとスクリプトを調べることができます。 以下の手順は、`./network.sh up`のコマンドを発行したときに何が起こるかについてのガイド付きツアーを提供します。 - `./network.sh` は、2つのピア組織とOrderer組織の証明書と鍵を作成します。 デフォルトでは、スクリプトは `organizations/cryptogen` フォルダにある設定ファイルを用いてcryptogenツールを使用します。 `-ca`フラグを使用して認証局を作成する場合、本スクリプトは `organizations/fabric-ca` フォルダにあるFabric CAサーバーの設定ファイルと `registerEnroll.sh` スクリプトを使用します。 cryptogenとFabric CAの両方とも、`organizations`フォルダ内に3つの組織すべての暗号マテリアルとMSPフォルダを作成します。 - 組織の暗号マテリアルが生成されると、`network.sh`はネットワークのノードを起動できます。 本スクリプトは、`docker` フォルダ内の ``docker-compose-test-net.yaml`` ファイルを使用して、ピアノードとOrdererノードを作成します。 `docker` フォルダには、3つのFabric CAとともにネットワークのノードを起動する ``docker-compose-e2e.yaml`` ファイルも含まれています (※訳注: このファイルは既に存在していない。代わりにCAを作成するための``docker-compose-ca.yaml``が存在する)。 このファイルは、Fabric SDKによるエンドツーエンドのテストを実行するために使用することを目的としています。これらのテストの実行の詳細については、[Node SDK](https://github.com/hyperledger/fabric-sdk-node) リポジトリを参照してください。 - `createChannel` サブコマンドを使用する場合、 `./network.sh` は `scripts` フォルダー内の `createChannel.sh` スクリプトを実行して、指定されたチャネル名を使用してチャネルを作成します。 このスクリプトは `configtxgen` ツールを用いて、 `configtx/configtx.yaml` ファイルの `TwoOrgsApplicationGenesis` チャネルプロファイルを元に、チャネルのジェネシスブロックを作成します。 チャネルを作成した後、スクリプトはピア CLIを使用してチャネルを作成し、 ``peer0.org1.example.com`` と ``peer0.org2.example.com`` をチャネルに参加させ、両方のピアをアンカーピアにします。 - `deployCC` コマンドを発行すると、`./network.sh` は ``deployCC.sh`` スクリプトを実行して両方のピアに **asset-transfer (basic)** チェーンコードをインストールし、チャネルにチェーンコードを定義します。 チェーンコード定義がチャネルにコミットされると、ピア CLIは `Init` を使用してチェーンコードを初期化し、チェーンコードを呼び出して初期データを台帳に格納します。 ## Troubleshooting チュートリアルで問題が発生した場合は、以下を確認してください: - ネットワークは常に新しく開始する必要があります。次のコマンドを使用して、過去の実行におけるアーティファクト、暗号マテリアル、コンテナ、Dockerボリューム、およびチェーンコードイメージを削除できます: ``` ./network.sh down ``` 古いコンテナ、イメージ、およびボリュームを削除しないと、**エラーが発生します**。 - Dockerエラーが表示された場合は、まずDockerのバージョン ([前提条件](prereqs.html)) を確認してから、Dockerプロセスを再起動してみてください。 Dockerの問題は、すぐにはわからないことが多いです。例えば、ノードがコンテナ内にマウントされた暗号マテリアルにアクセスできないことが原因で発生するエラーが表示される場合があります。 問題が解決しない場合は、以下の通りイメージを削除して一からやり直すことができます: ``` docker rm -f $(docker ps -aq) docker rmi -f $(docker images -q) ``` - もし、MacOSでDocker Desktopを動かしている場合に、チェーンコードのインストール時に、次のようなエラーになった場合: ``` Error: chaincode install failed with status: 500 - failed to invoke backing implementation of 'InstallChaincode': could not build chaincode: docker build failed: docker image inspection failed: Get "http://unix.sock/images/dev-peer0.org1.example.com-basic_1.0-4ec191e793b27e953ff2ede5a8bcc63152cecb1e4c3f301a26e22692c61967ad-42f57faac8360472e47cbbbf3940e81bba83439702d085878d148089a1b213ca/json": dial unix /host/var/run/docker.sock: connect: no such file or directory Chaincode installation on peer0.org1 has failed Deploying chaincode failed ``` この問題は、MacOS用のDocker Desktopの新しめのバージョンで発生します。この問題を解決するには、Docker Desktopの設定で、`Use gRPC FUSE for file sharing` のチェックを解除して、レガシーなosxfsファイル共有を代わりに使用するようにして、**Apply & Restart**をクリックしてください。 - もし、生成 (create)、承認 (approve)、コミット (commit)、呼び出し (invoke)、または参照 (query) コマンドでエラーが発生した場合は、 チャネル名とチェーンコード名が適切に更新されていることを確認してください。提供されているサンプルコマンドには、プレースホルダー値があります。 - 以下のエラーが表示された場合: ``` Error: Error endorsing chaincode: rpc error: code = 2 desc = Error installing chaincode code mycc:1.0(chaincode /var/hyperledger/production/chaincodes/mycc.1.0 exits) ``` 前回の実行におけるチェーンコードイメージ (例: ``dev-peer1.org2.example.com-asset-transfer-1.0`` や ``dev-peer0.org1.example.com-asset-transfer-1.0``）が残っている可能性があります。それらを削除して、再試行してください。 ``` docker rmi -f $(docker images | grep dev-peer[0-9] | awk '{print $3}') ``` - 以下のエラーが表示された場合: ``` [configtx/tool/localconfig] Load -> CRIT 002 Error reading configuration: Unsupported Config Type "" panic: Error reading configuration: Unsupported Config Type "" ``` ``FABRIC_CFG_PATH`` 環境変数が適切に設定できていません。configtxgenツールは、 configtx.yaml を見つけるためにこの環境変数を必要とします。 戻って ``export FABRIC_CFG_PATH=$PWD/configtx/configtx.yaml`` を実行してから、チャネルアーティファクトを再作成してください。 - 「アクティブなエンドポイント (active endpoints)」がまだあることを示すエラーが表示された場合は、Dockerネットワークを削除 (prune) します。 これにより、前回のネットワークが消去され、新しい環境で開始されるようになります: ``` docker network prune ``` 次のメッセージが表示されたら: ``` WARNING! This will remove all networks not used by at least one container. Are you sure you want to continue? [y/N] ``` ``y``を選んでください。 - `./network.sh createChannel` コマンドでチャネルを作成しようとした際、以下のエラーで失敗する場合があります。 ``` [comm.tls] ClientHandshake -> ERRO 003 Client TLS handshake failed after 1.908956ms with error: EOF remoteaddress=127.0.0.1:7051 Error: error getting endorser client for channel: endorser client failed to connect to localhost:7051: failed to create new connection: context deadline exceeded After 5 attempts, peer0.org1 has failed to join channel 'mychannel' ``` その場合、 Docker Desktop を一旦アンインストールし、推奨されるバージョンである 2.5.0.1 を再インストールする必要があります。 その際、コマンドを再実行する前に `fabric-samples` リポジトリを再度クローンする必要があります。 - 以下に似たエラーが表示された場合: ``` /bin/bash: ./scripts/createChannel.sh: /bin/bash^M: bad interpreter: No such file or directory ``` 問題のファイル (この例では **createChannel.sh**) がUnix形式でエンコードされていることを確認してください。 これは、Gitの設定で ``core.autocrlf`` を ``false`` に設定していないことが原因である可能性があります ([Windows](prereqs.html#windows) 参照)。 これを修正する方法はいくつかあります。例えば、Vimエディタにアクセスできる場合は、次のファイルを開きます: ``` vim ./fabric-samples/test-network/scripts/createChannel.sh ``` 開いたら次のVimコマンドを実行してフォーマットを変更します: ``` :set ff=unix ``` 引き続きエラーが発生する場合には、 Fabric の [Discord channels](https://discord.com/invite/hyperledger) または [StackOverflow](https://stackoverflow.com/questions/tagged/hyperledger-fabric) でログを共有してください。