Hyperledger Fabric フレームワークでは、チェーンコードはスマートコントラクトを実装します。 チェーンコードは Node.js、Go、または Java で記述できます。 今後、さらに多くの言語がサポートされる予定です。 このトピックでは、チャネルにチェーンコードをデプロイする方法について説明します。
この章は、Fabric V2.2 または V2.5 のインスタンスを購入したユーザーに適用されます。 Fabric V1.4 のインスタンスを購入した場合は、「チェーンコードの管理 (V1.4)」のチェーンコードのデプロイに関するセクションをご参照ください。
チェーンコードのパッケージ化
チェーンコードをデプロイする前に、Hyperledger Fabric の開発環境でチェーンコードを開発、テスト、およびパッケージ化する必要があります。
チェーンコードを開発します。
チェーンコードをテストした後、
peer lifecycle chaincode packageコマンドを実行してチェーンコードをパッケージ化します。 必要な依存関係をパッケージに含めることをお勧めします。 次の例は、必要な依存関係を Go チェーンコードの vendor ディレクトリに配置する方法を示しています。govendor を使用して依存関係を読み込みます。
次のコマンドを実行して govendor をインストールします。
go get -u -v github.com/kardianos/govendorチェーンコードのプロジェクトディレクトリに移動し、次のコマンドを実行して vendor ディレクトリを初期化します。
govendor init次のコマンドを実行して、このプロジェクトで使用されている依存関係を GOPATH から vendor ディレクトリに自動的に移動します。
govendor add +external
go mod コマンドを実行して依存関係を読み込みます。
次のコマンドを実行して go mod を初期化します。
go mod init次のコマンドを実行して、依存関係を vendor フォルダに自動的にパッケージ化します。
go mod vendor
パッケージ化コマンドの詳細については、「peer lifecycle chaincode commands」をご参照ください。 注意:
Go チェーンコードの場合は、-p オプションに $GOPATH/src 内のメインパッケージディレクトリの相対パスを指定します。 Java チェーンコードの場合は、-p オプションにチェーンコードのプロジェクトディレクトリを指定します。 Node.js チェーンコードの場合は、-p オプションに package.json ファイルを含むチェーンコードプロジェクトのルートディレクトリを指定します。 -p オプションには、./xxx 形式の相対パスを指定しないでください。
Go で記述されたチェーンコードの場合は、-l オプションを無視できます。 Node.js の場合は、-l node を指定します。 Java の場合は、-l java を指定します。
--labelを使用して、デフォルトのチェーンコード名とバージョンを指定します。
次の例では、$GOPATH/src/github.com/hyperledger/fabric-samples/chaincode/sacc ディレクトリにある Go チェーンコードが、チェーンコードラベル sacc_1_0 を使用して sacc.tar.gz パッケージに圧縮されます。
peer lifecycle chaincode package -p github.com/hyperledger/fabric-samples/chaincode/sacc --label sacc_1_0 -l golang sacc.tar.gzpeerパッケージ:
チェーンコードをデプロイするには、次の 3 つのステップを実行します。 チャネル内の既存のチェーンコードをアップグレードする方法の詳細については、「チェーンコードのアップグレード」をご参照ください。
チェーンコードをアップロードする
チェーンコードをインストールする
チェーンコード定義を送信する
チェーンコードのアップロード
Alibaba Cloud Blockchain as a Service (BaaS) コンソール にログインします。
概要ページの 所属組織 セクションで、管理する組織を見つけ、組織の名前をクリックします。
表示されるページで、チェーンコードパッケージの管理 タブをクリックします。
チェーンコードパッケージの管理チェーンコードのアップロード タブで、 をクリックします。
表示されるパネルで、開発環境でパッケージ化したチェーンコードをアップロードします。 チェーンコードをパッケージ化する方法の詳細については、「チェーンコードのパッケージ化」セクションをご参照ください。
[OK] をクリックします。
チェーンコードがアップロードされると、チェーンコードパッケージの管理ラベル タブのチェーンコード リストに表示されます。 列に表示されるチェーンコード名は、チェーンコードをパッケージ化するときに指定した名前です。
チェーンコードのインストール
前提条件
チェーンコードがアップロードされていること。
手順
Alibaba Cloud BaaS コンソール にログインします。
概要ページの 所属組織 セクションで、管理する組織を見つけ、組織の名前をクリックします。
表示されるページで、チェーンコードパッケージの管理 タブをクリックします。
チェーンコード パッケージ管理インストールアクション タブで、インストールするチェーンコードを見つけ、 列の をクリックして、現在の組織にチェーンコードをインストールします。
インストール中に、チェーンコードは自動的にプリコンパイルされ、チェーンコード パッケージに潜在的な問題がないかチェックされます。
プリコンパイルには、チェーンコードの依存関係の複雑さに応じて数秒から数分かかる場合があります。インストールが完了すると、[ステータス] 列のチェーンコードステータスが [未インストール] から [インストール済み] に変わり、[アクション] 列のボタンが [インストール] から [定義を送信] に変わります。
チェーンコード定義の送信
前提条件
チェーンコードがアップロードされ、インストールされていること。
手順
Alibaba Cloud BaaS コンソール にログインします。
概要ページの 所属組織 セクションで、管理する組織を見つけ、組織の名前をクリックします。
表示されるページで、チェーンコード パッケージ管理 タブをクリックします。
チェーンコードパッケージ管理定義を送信アクション タブで、定義を送信するチェーンコードを見つけ、 列の をクリックします。
表示されるパネルで、手順に基づいてパラメーターを設定します。
パラメーター | 説明 |
[名前] | チェーンコードをパッケージ化するときにチェーンコードに指定した名前。 名前をそのまま使用することも、チェーンコードに新しい名前を付けることもできます。 注: 別のチェーンコードですでに使用されている名前のチェーンコードの定義を送信することはできません。 |
[バージョン] | チェーンコード定義を送信するときに定義するバージョン。 |
[デプロイチャネル] | チェーンコードをデプロイするチャネル。 チェーンコードがデプロイされると、このチャネル内のすべての組織でチェーンコードが表示されます。 チャネルを作成する方法の詳細については、「チャネルの作成」をご参照ください。 |
[初期化するかどうか] | チェーンコードを初期化するかどうかを指定します。 有効な値:
|
[エンドースメントポリシー] | トランザクションを有効とみなすために、チェーンコードを実行し、実行結果をエンドースする必要があるチャネル上のピアのセットを指定するポリシー。 例:
説明
|
[上位] | [Superior] をクリックすると、[プライバシー設定の構成] フィールドに、チェーンコードの非公開データコレクションの JSON データを入力できます。チェーンコードで非公開データを使用しない場合は、この手順をスキップできます。非公開データコレクションの JSON データの例: |
プライベートデータコレクションの name パラメータまたは blockToLive パラメータを設定した後、後のアップグレードで変更することはできません。 詳細については、Fabric でのプライベートデータの使用に関するドキュメントをご参照ください。
[送信] をクリックします。
その後、チェーンコードチャネルの状態コンセンサスで組織内のステータス処理完了承認の詳細アクション タブでチェーンコードのステータスを確認できます。チェーンコード定義を送信すると、 列のステータスが に変わり、 列のステータスが に変わります。 列の をクリックすると、チェーンコードの基本情報を確認できます。
チャネル内の他の組織がチェーンコード定義を確認して送信するまで待ちます。
説明デフォルトでは、チェーンコード定義は、チャネル内の組織の 50% によって確認された後にのみ送信できます。
別の組織のメンバーとして、Alibaba Cloud BaaS コンソール にログオンします。
組織概要 ページの セクションで、管理する組織を見つけ、組織名をクリックします。
表示されたページで、チェーンコードチェーンコードハンドルアクション タブをクリックします。 タブで、管理するチェーンコードを見つけ、 列の をクリックします。
[チェーンコード処理] パネルで、送信された定義が要件を満たしていることを確認し、定義を確認する場合は [送信] をクリックします。
チャネル内の組織の 50% が定義を確認すると、チェーンコードがデプロイされます。 チェーンコードチャネルの状態コンセンサスで実行中アップグレードログの表示アクション タブの 列のステータスが から に変わります。 列に と が表示されます。
説明送信したチェーンコード定義が要件を満たしていない場合、他の組織はチェーンコード定義を処理しないことを選択できます。 チェーンコード パッケージをアップロードし、チェーンコードをインストールし、チェーンコード定義を再送信する必要があります。 この場合、送信するパラメーターは元のパラメーターとは異なり、[チェーンコード] タブには複数のコンセンサス レコードが表示されます。 ある組織が 1 つのコンセンサス レコードを処理すると、チェーンコードの他のコンセンサス レコードは表示されなくなります。