fxconfig Playbooks¶

The fxconfig playbooks prepare and submit Fabric-X configuration transactions, including namespace creation. fxconfig is a control-plane tool that uses generated artifacts, endorser information from the inventory, and runtime endpoints.

Playbooks flow¶

flowchart LR
  BIN[binaries] --> CONFIGS[configs]
  CONFIGS --> CREATE[create_namespaces]
  CREATE -. cleanup .-> WIPE[wipe]

binaries.yaml¶

binaries.yaml prepares the fxconfig CLI used for configuration transactions. It handles control-node install/build decisions first, then ensures remote hosts that declare fxconfig_use_bin: true have the binary available by transfer, local build, or install.

ansible-playbook hyperledger.fabricx.fxconfig.binaries

Properties:

Target hosts: localhost for control-node build/install decisions, then all by default for remote binary setup.
Binary activation: only hosts with fxconfig_use_bin: true run the remote binary setup step.
Build location: set bin_build_on_control_node: true with fxconfig_build_bin: true to build on the control node and transfer the result to remote hosts. In that case, go must be installed on the control node. If fxconfig_build_bin: true is set without bin_build_on_control_node, the build happens on each remote binary host and go is needed there.

configs.yaml¶

configs.yaml renders and transfers fxconfig configuration for hosts that declare namespace and user data. It selects the endorser identity, discovers the orderer router, committer query service, and committer sidecar endpoints, and writes the local configuration that later namespace operations use.

ansible-playbook hyperledger.fabricx.fxconfig.configs

Properties:

Target hosts: all by default.
Nuance: run this during setup after core crypto and genesis/config artifacts exist and before namespace creation.

create_namespaces.yaml¶

create_namespaces.yaml performs the full namespace transaction workflow. It groups namespace definitions from the inventory, creates unsigned namespace transactions on the control node, asks the relevant organizations to endorse them, merges the endorsements, and submits the finalized transactions to the running Fabric-X network.

ansible-playbook hyperledger.fabricx.fxconfig.create_namespaces

Properties:

Target hosts: all by default, with transaction construction and submission coordinated by the fxconfig role.

Warning

Run this after the network is started and the required committer endpoints are reachable. Running it too early fails by design because namespace transactions must be endorsed and submitted through live Fabric-X endpoints.

wipe.yaml¶

wipe.yaml removes generated fxconfig files from targeted hosts so namespace/configuration artifacts can be rebuilt cleanly during another setup or debug cycle.

ansible-playbook hyperledger.fabricx.fxconfig.wipe

Properties:

Target hosts: all by default.
Nuance: removes generated fxconfig files so namespace/configuration artifacts can be rebuilt cleanly.