Fabricネットワーク環境起動プロセスの詳細
16269 ワード
この記事では、fabricのネットワーク環境の起動プロセスについて説明します.つまり、前節で説明したfabricネットワーク環境の起動テスト時にnetworkを実行します.setup.shこのファイルの実行フロー
前節ではfabricネットワーク環境の起動テストについて説明します.主に./network_setup.sh upというコマンドなのでfabricネットワーク環境の起動のポイントはnetwork_setup.shというファイルの中にあります.次にnetwork_を分析しますsetup.shこのファイルnetwork_setup.shは、generateArtifactsを用いる2つの部分を含む.shスクリプトファイルの構成組織関係と発行証明書、公開/秘密鍵、チャネル証明書など、もう1つはdocker-compose-cliである.yamlは、構成に基づいてクラスタを起動し、chaincodeのサンプルコードをテストするために使用されます.具体的なフローチャートを次に示します.
まずgenerateArtifactsを見てみましょう.shスクリプトファイル.次の3つの関数が含まれます.
次はdocker-compose-cliです.yamlファイルdocker-compose-cli.yamlファイルは組織関係に基づいてdockerクラスタを起動し、cliコンテナでcommandコマンドを実行します./scripts/script.shスクリプトファイル.それはscripts/script.shスクリプトは具体的に何をしましたか?
またdocker-compose-cli.yamlというファイルにはもう一つの構成項目があります.それは:
ここのdocker-compose-base.yamlは、Ordererやpeerのベースプロファイルで、指定したポートなどが含まれています.
crypto-configに基づく.yaml(このファイルは.../fabric/examples/e 2 e_cli)は、公開、秘密鍵、証明書情報を生成し、crypto-configフォルダに保存します.またcrypto-config.yamlはまた、組織メンバーおよび組織下のpeerノードの数も定義します.crypto-config.yamlファイルの説明:フィールドNameとDomainは、この組織の名前とドメイン名についてです.これは主に証明書を生成するときに使用され、証明書にはこの情報が含まれます.そしてTemplate.Count=2は、2つの公開秘密鍵と証明書を生成するということです.1つはpeer 0です.org 1の、もう1セットはpeer 1です.org 1の(すなわち、orgにpeer 0とpeer 1の2つのノードが存在することを指定します).最後にCount=1は、各Templateの下にいくつかの一般的なUserがあるということです(注意、AdminはAdminで、このカウントには含まれていません)、ここでは1を構成しています.つまり、私たちは普通のユーザーが1人しか必要ありません[email protected]実際のニーズに合わせてこのプロファイルを調整したり、Org Usersなどを削除したりすることができます.ファイルの内容は次のとおりです.
注意:peer:Fabricネットワーク内のノードは、実行中のdockerコンテナとして表現されます.ネットワーク内の他のpeerと通信することができ、各peerはledgerのコピーをローカルに保持します.これはorgの下の組織メンバーです.org:1つ以上のpeerからなる組織.Orderer:アライアンスメンバーが共有する中心ノード.取引をソートするために使用されるのは、Fabric共通認識メカニズムの重要な構成部分である.
configtxに基づく.yaml(このファイルは.../fabric/examples/e 2 e_cli)では、創世ブロックとチャネルに関する情報を生成し、channel-artifactsフォルダに保存します.裏書きポリシーを指定することもできます.configtx.yamlファイルの説明:1.公式提供examples/e 2 e_cli/configtx.yamlこのファイルには、2つのOrgが参加するOrdererコンセンサス構成TwoOrgsOrdererGenesisと、2つのOrgが参加するChannel構成:TwoOrgsChannelが構成されています.2.また、このファイルのOrdererセクションで共通認識のアルゴリズムがSoloかKafkaか、共通認識時のブロックサイズ、タイムアウト時間などを設定することができます.デフォルト値を使用すれば、変更する必要はありません.Peerノードの構成にはMSPの構成,アンカーノードの構成が含まれている.より多くのOrgがあるか、より多くのChannelがある場合は、テンプレートに基づいて対応する修正を行うことができます.3.Policiesの構成も特に注意してください.この構成項目は異なるロールの権限を定義しています.Reader、Writer、Adminはそれぞれ読み取り、書き込み、admin権限に対応しています.読み取り権限ロールは他のpeerノードから帳簿を同期して取引を開始できません.writer定義項目の下のロールのみが取引を開始する、すなわちchaincodeのinvokeメソッドを呼び出す権限を有します(必ずしもinvokeスキーマではありません.chaincodeでのステータス変更の方法に関連する限り、writer権限またはadmin権限を持つロールのみが呼び出すことができます).この構成のOrganizations構成におけるOrg 1構成を例にとると、「OR('Org 1 MSP.admin','Org 1 MSP.client')」は、org 1のmspサービスにおけるadminまたはclientロールが取引を開始する権限を有することを示す.ファイルの内容は次のとおりです.
fabricネットワーク環境起動プロセスの詳細
前節ではfabricネットワーク環境の起動テストについて説明します.主に./network_setup.sh upというコマンドなのでfabricネットワーク環境の起動のポイントはnetwork_setup.shというファイルの中にあります.次にnetwork_を分析しますsetup.shこのファイルnetwork_setup.shは、generateArtifactsを用いる2つの部分を含む.shスクリプトファイルの構成組織関係と発行証明書、公開/秘密鍵、チャネル証明書など、もう1つはdocker-compose-cliである.yamlは、構成に基づいてクラスタを起動し、chaincodeのサンプルコードをテストするために使用されます.具体的なフローチャートを次に示します.
まずgenerateArtifactsを見てみましょう.shスクリプトファイル.次の3つの関数が含まれます.
1.generateCerts：
cryptogen crypto-config.yaml 。
2.replacePrivateKey：
docker-compose-e2e-template.yaml ca 。
3.generateChannelArtifacts：
configtxgen configtx.yaml ， 。
次はdocker-compose-cliです.yamlファイルdocker-compose-cli.yamlファイルは組織関係に基づいてdockerクラスタを起動し、cliコンテナでcommandコマンドを実行します./scripts/script.shスクリプトファイル.それはscripts/script.shスクリプトは具体的に何をしましたか?
1.createChannel： channel。
2. joinChannel： peer channel。
3. updateAnchorPeers：
4. installChaincode： chaincode。
5. instantiateChaincode： chaincode。
6. chaincodeQuery：chaincode
またdocker-compose-cli.yamlというファイルにはもう一つの構成項目があります.それは:
file: base/docker-compose-base.yaml
ここのdocker-compose-base.yamlは、Ordererやpeerのベースプロファイルで、指定したポートなどが含まれています.
いくつかの重要なプロファイル
1.crypto-config.yaml
crypto-configに基づく.yaml(このファイルは.../fabric/examples/e 2 e_cli)は、公開、秘密鍵、証明書情報を生成し、crypto-configフォルダに保存します.またcrypto-config.yamlはまた、組織メンバーおよび組織下のpeerノードの数も定義します.crypto-config.yamlファイルの説明:フィールドNameとDomainは、この組織の名前とドメイン名についてです.これは主に証明書を生成するときに使用され、証明書にはこの情報が含まれます.そしてTemplate.Count=2は、2つの公開秘密鍵と証明書を生成するということです.1つはpeer 0です.org 1の、もう1セットはpeer 1です.org 1の(すなわち、orgにpeer 0とpeer 1の2つのノードが存在することを指定します).最後にCount=1は、各Templateの下にいくつかの一般的なUserがあるということです(注意、AdminはAdminで、このカウントには含まれていません)、ここでは1を構成しています.つまり、私たちは普通のユーザーが1人しか必要ありません[email protected]実際のニーズに合わせてこのプロファイルを調整したり、Org Usersなどを削除したりすることができます.ファイルの内容は次のとおりです.
# ---------------------------------------------------------------------------
# Orderer
# ---------------------------------------------------------------------------
- Name: Orderer
Domain: example.com
# ---------------------------------------------------------------------------
# "Specs" - See PeerOrgs below for complete description
# ---------------------------------------------------------------------------
Specs:
- Hostname: orderer
# ---------------------------------------------------------------------------
# "PeerOrgs" - Definition of organizations managing peer nodes
# ---------------------------------------------------------------------------
PeerOrgs:
# ---------------------------------------------------------------------------
# Org1
# ---------------------------------------------------------------------------
- Name: Org1
Domain: org1.example.com
# ---------------------------------------------------------------------------
# "Specs"
# ---------------------------------------------------------------------------
# Uncomment this section to enable the explicit definition of hosts in your
# configuration. Most users will want to use Template, below
#
# Specs is an array of Spec entries. Each Spec entry consists of two fields:
# - Hostname: (Required) The desired hostname, sans the domain.
# - CommonName: (Optional) Specifies the template or explicit override for
# the CN. By default, this is the template:
#
# "{{.Hostname}}.{{.Domain}}"
#
# which obtains its values from the Spec.Hostname and
# Org.Domain, respectively.
# ---------------------------------------------------------------------------
# Specs:
# - Hostname: foo # implicitly "foo.org1.example.com"
# CommonName: foo27.org5.example.com # overrides Hostname-based FQDN set above
# - Hostname: bar
# - Hostname: baz
# ---------------------------------------------------------------------------
# "Template"
# ---------------------------------------------------------------------------
# Allows for the definition of 1 or more hosts that are created sequentially
# from a template. By default, this looks like "peer%d" from 0 to Count-1.
# You may override the number of nodes (Count), the starting index (Start)
# or the template used to construct the name (Hostname).
#
# Note: Template and Specs are not mutually exclusive. You may define both
# sections and the aggregate nodes will be created for you. Take care with
# name collisions
# ---------------------------------------------------------------------------
Template:
Count: 2
# Start: 5
# Hostname: {{.Prefix}}{{.Index}} # default
# ---------------------------------------------------------------------------
# "Users"
# ---------------------------------------------------------------------------
# Count: The number of user accounts _in addition_ to Admin
# ---------------------------------------------------------------------------
Users:
Count: 1
# ---------------------------------------------------------------------------
# Org2: See "Org1" for full specification
# ---------------------------------------------------------------------------
- Name: Org2
Domain: org2.example.com
Template:
Count: 2
Users:
Count: 1
注意:peer:Fabricネットワーク内のノードは、実行中のdockerコンテナとして表現されます.ネットワーク内の他のpeerと通信することができ、各peerはledgerのコピーをローカルに保持します.これはorgの下の組織メンバーです.org:1つ以上のpeerからなる組織.Orderer:アライアンスメンバーが共有する中心ノード.取引をソートするために使用されるのは、Fabric共通認識メカニズムの重要な構成部分である.
2.configtx.yaml
configtxに基づく.yaml(このファイルは.../fabric/examples/e 2 e_cli)では、創世ブロックとチャネルに関する情報を生成し、channel-artifactsフォルダに保存します.裏書きポリシーを指定することもできます.configtx.yamlファイルの説明:1.公式提供examples/e 2 e_cli/configtx.yamlこのファイルには、2つのOrgが参加するOrdererコンセンサス構成TwoOrgsOrdererGenesisと、2つのOrgが参加するChannel構成:TwoOrgsChannelが構成されています.2.また、このファイルのOrdererセクションで共通認識のアルゴリズムがSoloかKafkaか、共通認識時のブロックサイズ、タイムアウト時間などを設定することができます.デフォルト値を使用すれば、変更する必要はありません.Peerノードの構成にはMSPの構成,アンカーノードの構成が含まれている.より多くのOrgがあるか、より多くのChannelがある場合は、テンプレートに基づいて対応する修正を行うことができます.3.Policiesの構成も特に注意してください.この構成項目は異なるロールの権限を定義しています.Reader、Writer、Adminはそれぞれ読み取り、書き込み、admin権限に対応しています.読み取り権限ロールは他のpeerノードから帳簿を同期して取引を開始できません.writer定義項目の下のロールのみが取引を開始する、すなわちchaincodeのinvokeメソッドを呼び出す権限を有します(必ずしもinvokeスキーマではありません.chaincodeでのステータス変更の方法に関連する限り、writer権限またはadmin権限を持つロールのみが呼び出すことができます).この構成のOrganizations構成におけるOrg 1構成を例にとると、「OR('Org 1 MSP.admin','Org 1 MSP.client')」は、org 1のmspサービスにおけるadminまたはclientロールが取引を開始する権限を有することを示す.ファイルの内容は次のとおりです.
# Copyright IBM Corp. All Rights Reserved.
#
# SPDX-License-Identifier: Apache-2.0
#
---
################################################################################
#
# Profile
#
# - Different configuration profiles may be encoded here to be specified
# as parameters to the configtxgen tool
#
################################################################################
Profiles:
TwoOrgsOrdererGenesis:
Orderer:
<<: organizations:="" consortiums:="" sampleconsortium:="" twoorgschannel:="" consortium:="" sampleconsortium="" application:="" class="hljs-comment">################################################################################
#
# Section: Organizations
#
# - This section defines the different organizational identities which will
# be referenced later in the configuration.
#
################################################################################
Organizations:
# SampleOrg defines an MSP using the sampleconfig. It should never be used
# in production but may be used as a template for other definitions
- &OrdererOrg
# DefaultOrg defines the organization which is used in the sampleconfig
# of the fabric.git development environment
Name: OrdererOrg
# ID to load the MSP definition as
ID: OrdererMSP
# MSPDir is the filesystem path which contains the MSP configuration
MSPDir: crypto-config/ordererOrganizations/example.com/msp
- &Org1
# DefaultOrg defines the organization which is used in the sampleconfig
# of the fabric.git development environment
Name: Org1MSP
# ID to load the MSP definition as
ID: Org1MSP
MSPDir: crypto-config/peerOrganizations/org1.example.com/msp
AnchorPeers:
# AnchorPeers defines the location of peers which can be used
# for cross org gossip communication. Note, this value is only
# encoded in the genesis block in the Application section context
- Host: peer0.org1.example.com
Port: 7051
- &Org2
# DefaultOrg defines the organization which is used in the sampleconfig
# of the fabric.git development environment
Name: Org2MSP
# ID to load the MSP definition as
ID: Org2MSP
MSPDir: crypto-config/peerOrganizations/org2.example.com/msp
AnchorPeers:
# AnchorPeers defines the location of peers which can be used
# for cross org gossip communication. Note, this value is only
# encoded in the genesis block in the Application section context
- Host: peer0.org2.example.com
Port: 7051
################################################################################
#
# SECTION: Orderer
#
# - This section defines the values to encode into a config transaction or
# genesis block for orderer related parameters
#
################################################################################
Orderer: &OrdererDefaults
# Orderer Type: The orderer implementation to start
# Available types are "solo" and "kafka"
OrdererType: solo
Addresses:
- orderer.example.com:7050
# Batch Timeout: The amount of time to wait before creating a batch
BatchTimeout: 2s
# Batch Size: Controls the number of messages batched into a block
BatchSize:
# Max Message Count: The maximum number of messages to permit in a batch
MaxMessageCount: 10
# Absolute Max Bytes: The absolute maximum number of bytes allowed for
# the serialized messages in a batch.
AbsoluteMaxBytes: 98 MB
# Preferred Max Bytes: The preferred maximum number of bytes allowed for
# the serialized messages in a batch. A message larger than the preferred
# max bytes will result in a batch larger than preferred max bytes.
PreferredMaxBytes: 512 KB
Kafka:
# Brokers: A list of Kafka brokers to which the orderer connects
# NOTE: Use IP:port notation
Brokers:
- 127.0.0.1:9092
# Organizations is the list of orgs which are defined as participants on
# the orderer side of the network
Organizations:
################################################################################
#
# SECTION: Application
#
# - This section defines the values to encode into a config transaction or
# genesis block for application related parameters
#
################################################################################
Application: &ApplicationDefaults
# Organizations is the list of orgs which are defined as participants on
# the application side of the network
Organizations: