configtxgen¶
configtxgen
は、ユーザーがチャネル設定に関連するアーティファクトを作成したり中身を確認できるコマンドです。
configtx.yaml
の内容によって、生成されるアーティファクトの内容が決まります。
Syntax¶
configtxgen
ツールにはサブコマンドはありませんが、いくつかのタスクを行うためのフラグをサポートしています。
configtxgen¶
Usage of configtxgen:
-asOrg string
Performs the config generation as a particular organization (by name), only including values in the write set that org (likely) has privilege to set
-channelCreateTxBaseProfile string
Specifies a profile to consider as the orderer system channel current state to allow modification of non-application parameters during channel create tx generation. Only valid in conjunction with 'outputCreateChannelTx'.
-channelID string
The channel ID to use in the configtx
-configPath string
The path containing the configuration to use (if set)
-inspectBlock string
Prints the configuration contained in the block at the specified path
-inspectChannelCreateTx string
Prints the configuration contained in the transaction at the specified path
-outputAnchorPeersUpdate string
[DEPRECATED] Creates a config update to update an anchor peer (works only with the default channel creation, and only for the first update)
-outputBlock string
The path to write the genesis block to (if set)
-outputCreateChannelTx string
The path to write a channel creation configtx to (if set)
-printOrg string
Prints the definition of an organization as JSON. (useful for adding an org to a channel manually)
-profile string
The profile from configtx.yaml to use for generation.
-version
Show version information
Usage¶
Output a genesis block¶
プロファイル SampleSingleMSPRaftV1_1
のチャネル orderer-system-channel
のためのジェネシスブロックを genesis_block.pb
として書き出します。
configtxgen -outputBlock genesis_block.pb -profile SampleSingleMSPRaftV1_1 -channelID orderer-system-channel
Output a channel creation tx¶
プロファイル SampleSingleMSPChannelV1_1
のチャネル作成トランザクションを create_chan_tx.pb
として書き出します。
configtxgen -outputCreateChannelTx create_chan_tx.pb -profile SampleSingleMSPChannelV1_1 -channelID application-channel-1
Inspect a genesis block¶
genesis_block.pb
という名前のジェネシスブロックの内容をスクリーンにJSON形式で出力します。
configtxgen -inspectBlock genesis_block.pb
Inspect a channel creation tx¶
create_chan_tx.pb
という名前のチャネル作成トランザクションの内容をスクリーンにJSON形式で出力します。
configtxgen -inspectChannelCreateTx create_chan_tx.pb
Print an organization definition¶
パラメータ (例えば configtx.yaml
内のMSPDir など) に従って組織の定義を生成し、スクリーンにJSON形式で出力します。
(この出力は、メンバーを追加する場合など、チャネルを再設定するワークフローで役に立ちます)
configtxgen -printOrg Org1
Output anchor peer tx (deprecated)¶
configtx.yaml
内のプロファイル SampleSingleMSPChannelV1_1
とOrg1で定義されているアンカーピアをもとに、チャネル設定更新トランザクションを anchor_peer_tx.pb
として出力します。このトランザクションは、Org1に対してそのチャネルでアンカーピアが設定されていなかった場合には、アンカーピアを設定します。
configtxgen -outputAnchorPeersUpdate anchor_peer_tx.pb -profile SampleSingleMSPChannelV1_1 -asOrg Org1
この -outputAnchorPeersUpdate
出力フラグは非推奨です。チャネルのアンカーピアを設定するには、configtxlatorを使ってチャネル設定を更新してください。
Configuration¶
configtxgen
ツールの出力の多くは、configtx.yaml
の内容に左右されます。
このファイルは FABRIC_CFG_PATH
から探され、configtxgen
が動作するためには、このファイルが存在している必要があります。
設定可能な全オプションについては、Fabricに同梱しているconfigtx.yaml
サンプルを参照してください。
このファイルは、リリースのアーティファクトのtarファイル内の config
ディレクトリ、もしくは、ソースからビルドする場合には sampleconfig
フォルダにあります。
This work is licensed under a Creative Commons Attribution 4.0 International License.