主题
fabric-x-committer · 配置
TIP
具体配置文件结构请见 docs/tls-configurations.md、docs/logging.md、docs/metrics_reference.md、docs/namespace-policy.md(mkdocs.yml:64-67)。本章只列源码可定位的事实。
服务名常量
来源:cmd/committer/config.go:17-21。
| 常量 | 值 |
|---|---|
| sidecar | sidecar |
| coordinator | coordinator |
| vc | vc |
| verifier | verifier |
| query | query |
start 与 healthcheck 子命令均使用上述 5 个 key。
test_node 镜像内置 env
来源:docker/images/test_node/Dockerfile:17-45。
| ENV | 值 |
|---|---|
CONFIGS_PATH | /root/config |
ARTIFACTS_PATH | /root/artifacts |
BINS_PATH | /root/bin |
其它本地端点(SC_COORDINATOR_VERIFIER_ENDPOINTS 等,line 23-32)、PostgreSQL 凭证(SC_VC_DATABASE_USERNAME/PASSWORD/DATABASE、SC_QUERY_DATABASE_*,line 36-41)、数据库 TLS 关闭(SC_VC_DATABASE_TLS_MODE="none"、SC_QUERY_DATABASE_TLS_MODE="none",line 44-45)。
镜像内置端口(Dockerfile:57):7050 4001 2114 7001 2117 2110,对应用途见 06-api 端口章节。
release 镜像 ENTRYPOINT
来源:docker/images/release/Dockerfile:30-58。
- 二进制 COPY 自
${SRC_BIN_PATH}/${TARGETOS}-${TARGETARCH}/${BIN}(line 30) /bin/entrypoint→/bin/${BIN}软链接(line 34)ENTRYPOINT /bin/entrypoint(line 58)- Dockerfile 未设置
HEALTHCHECK,仅以注释给出建议示例healthcheck <service>(line 54-55)
DB 后端
依赖:github.com/yugabyte/pgx/v5 v5.7.6-yb-1(go.mod:32,PostgreSQL / YugabyteDB 驱动)+ github.com/jackc/puddle/v2 v2.2.2(go.mod:25,连接池)。
make ci-local(Makefile:212)自动管理 PostgreSQL 与 YugabyteDB 的生命周期。
配置加载
spf13/viper v1.21.0(go.mod:30)。各服务的 YAML 读取与默认值在 cmd/config/app_config.go、cmd/config/viper.go(Read<Service>YamlAndSetupLogging / NewViperWith<Service>Defaults,由 cmd/committer/config.go:31-46 调用);示例配置在 cmd/config/samples。
文档配置参考
来源:mkdocs.yml:64-67。
| 文档 | 用途 |
|---|---|
docs/tls-configurations.md | TLS 配置 |
docs/logging.md | 日志 |
docs/metrics_reference.md | 指标参考(可由 make generate-metrics-doc 生成) |
docs/namespace-policy.md | 命名空间策略 |
各文档具体字段 [未核]。
镜像 tag 规范
命名空间 image_namespace=docker.io/hyperledger(Makefile:90)。
| 镜像 | tag 模式 | 出处 |
|---|---|---|
test_node | ${image_namespace}/committer-test-node:${version} | Makefile:348 |
release(committer / loadgen) | ${namespace}/fabric-x-committer:${version}、${namespace}/fabric-x-loadgen:${version} | scripts/build-release-image.sh:21,50-51 |