dbx 的 Pulsar 4.2 冒烟测试环境:public/default 命名空间与 dbx-smoke 主题实战

发布时间:2026/10/10 5:11:30
dbx 的 Pulsar 4.2 冒烟测试环境:public/default 命名空间与 dbx-smoke 主题实战 数据库开发者工具桌面应用CLIMCP 服务AI 应用【免费下载链接】dbx15MB轻量级跨平台数据库客户端、数据库管理工具。支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、DuckDB、ClickHouse、SQL Server 等。15MB, lightweight, cross-platform database client. Supports MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, ClickHouse, SQL Server and more.项目地址https://gitcode.com/t8y2/dbx点击查看免费下载导读本文围绕 dbx 仓库中deploy/database/pulsar/4.2/这套 Pulsar 4.2 数据库测试配方展开讲解如何在本地以 Docker Compose 拉起 Pulsar standalone并通过make db-verify向persistent://public/default/dbx-smoke发布DBX smoke冒烟消息来验证环境可用性。读完本文你将掌握 Pulsar 独立模式的命名空间自动创建机制、冒烟主题的完整语义解析以及 dbx 中从配方启动、验证到接入桌面客户端的一整套实操方法。Pulsar 4.2 配方在 dbx 测试环境中的定位dbx 仓库在 deploy/database/README.md 中维护了一套可重复创建的 Docker Compose 数据库测试环境每个版本配方都遵循统一约定固定镜像版本、命名卷、仅绑定回环地址的端口、健康检查以及初始化数据或验证阶段的冒烟数据。Pulsar 4.2 配方位于 deploy/database/pulsar/4.2/其目录结构遵循统一布局deploy/database/pulsar/4.2/ ├── recipe.json # 连接字段和冒烟命令 ├── compose.yaml # Docker Compose 环境 └── init/ # 环境初始化数据其中init/README.md就是本次冒烟数据的说明文档它记录了一个关键事实Pulsar standalone 会自动创建public/default命名空间verify命令会把DBX smoke发布到persistent://public/default/dbx-smoke主题。Pulsar standalone 自动创建 public/default 命名空间为什么不需要手动建命名空间在 Pulsar 中消息主题通过tenant/namespace/topic三段式组织每个主题必须归属于某个命名空间。多租户模式下需要先创建租户和命名空间但在standalone 独立模式下Pulsar 启动时预置了默认的public租户和public/default命名空间。正如 init/README.md 所述这套配方正是利用了这一机制——容器启动后即可直接向public/default下的主题发布消息无需执行pulsar-admin namespaces create等额外初始化步骤。这也是为什么该配方的init/目录无需放置 SQL/脚本初始化文件仅需一份说明性 README 的原因与 Redis 配方的处理方式类似见 deploy/database/README.md。standalone 模式的容器化实现看 compose.yaml 即可还原这一机制的实际落地services: database: image: docker.cnb.cool/znb/images/pulsar:4.2.3 container_name: dbx-pulsar-4.2 restart: always command: [bin/pulsar, standalone, --advertised-address, localhost] ports: - ${DB_BIND_ADDRESS:-127.0.0.1}:${DB_PORT:-11400}:6650 - ${DB_BIND_ADDRESS:-127.0.0.1}:${PULSAR_WEB_PORT:-11401}:8080 volumes: - data:/pulsar/data - conf:/pulsar/conf healthcheck: test: [CMD-SHELL, bin/pulsar-admin brokers healthcheck] interval: 10s timeout: 10s retries: 60 start_period: 30s volumes: data: conf:要点解析入口命令bin/pulsar standalone --advertised-address localhost即以 standalone 模式启动并强制广告地址为localhost保证容器内外通过 localhost 访问时地址一致。双端口6650 为 broker 的二进制协议端口客户端连接用8080 为 HTTP 管理端口Pulsar Admin/Web UI 用。健康检查通过bin/pulsar-admin brokers healthcheck探测retries: 60、start_period: 30s为慢启动留足余量dbx的启动脚本依赖该健康检查结果才能进入后续冒烟阶段。持久化data与conf两个命名卷分别保存 Pulsar 的数据和配置。配方元数据中的连接约定recipe.json 给出了面向 dbx 的连接字段与验证命令{ database: pulsar, name: Pulsar, version: 4.2.3, displayVersion: 4.2, image: docker.cnb.cool/znb/images/pulsar:4.2.3, platforms: [linux/amd64, linux/arm64], service: database, defaultPort: 6650, connection: { host: 127.0.0.1, port: 11400, authentication: none, database: dbx, namespace: public/default, webPort: 11401 }, hostPorts: { DB_PORT: 11400, PULSAR_WEB_PORT: 11401 }, shell: [/bin/bash], smoke: { steps: [{ name: produce a smoke message, command: [bin/pulsar-client, produce, persistent://public/default/dbx-smoke, --messages, DBX smoke], expect: 1 messages successfully produced }] } }值得注意的连接细节宿主端口映射Pulsar 属于 dbx 测试环境默认端口段11400–11499见 scripts/database-env.mjs 的DEFAULT_HOST_PORT_RANGESpulsar: [11400, 11499]。因此二进制端口 6650 映射到宿主11400Web 端口 8080 映射到宿主11401与 Kafka 的113xx段错开互不冲突。连接参数authentication: none本地测试无鉴权、namespace: public/default、数据库名为dbx。镜像双平台声明支持linux/amd64与linux/arm64。冒烟消息persistent://public/default/dbx-smoke 的完整语义冒烟验证的核心目标是向persistent://public/default/dbx-smoke发布一条DBX smoke消息。这条主题 URL 由三段构成逐层解读如下组成部分含义在本配方中的取值持久化类型persistent://表示消息会被持久化存储broker 重启不丢与之相对的non-persistent://则不会落盘persistent://租户tenantPulsar 多租户体系的第一层public是 standalone 预置的默认租户public命名空间namespace租户下的逻辑隔离单元default是 standalone 自动创建的默认命名空间包含全部默认策略如持久化、保留策略default主题名topic命名空间下的具体消息通道本配方固定为dbx-smokedbx-smoke整条地址persistent://public/default/dbx-smoke正是依赖了 init/README.md 中standalone 自动创建 public/default这一前提才能做到零初始化即可发布。冒烟命令的等价手动执行make db-verify实际执行的命令等价于通过docker compose exec进入容器bin/pulsar-client produce persistent://public/default/dbx-smoke --messages DBX smoke该命令向主题发布一条内容为DBX smoke的消息成功时pulsar-client会输出1 messages successfully produced——这正是 recipe.json 中smoke.steps[0].expect期望捕获的文本。只有输出包含该字符串验证才会被判定为通过。如需在本地手动复现验证过程可在仓库根目录依次执行# 1. 启动 Pulsar 4.2 并等待健康检查通过 make db DBpulsar4.2 # 2. 运行冒烟验证启动 发布 dbx-smoke 消息 make db-verify DBpulsar4.2 # 3. 停止并移除容器保留命名卷数据 make db-down DBpulsar4.2 # 4. 彻底重置删除容器与命名卷需显式确认 make db-reset DBpulsar4.2 CONFIRM1这些目标在 Makefile 中统一定义底层统一转发给pnpm db:env即 scripts/database-env.mjs。make db-verify 的底层执行链路理解验证命令的实际行为需要阅读 scripts/database-env.mjs 中verify分支的实现case verify: runCompose(recipe, [up, -d, --wait]); ensureBootstrap(recipe); for (const step of recipe.smoke.steps) { const command expandSmokeCommand(step.command, recipe); const output runCompose(recipe, [exec, -T, recipe.service, ...command], { capture: true }); if (step.expect !output.includes(step.expect)) throw new Error(Smoke check did not contain expected text: ${step.expect}\n${output}); console.log(OK ${step.name}); } break;执行链路共四步拉起环境docker compose up -d --wait等待 compose.yaml 中定义的健康检查通过即bin/pulsar-admin brokers healthcheck成功确保 broker 已就绪。引导检查ensureBootstrap(recipe)处理可选的初始化步骤Pulsar 配方未定义bootstrap字段直接跳过——因为 standalone 已自动就绪。执行冒烟步骤通过docker compose exec -T database进入容器运行bin/pulsar-client produce persistent://public/default/dbx-smoke --messages DBX smokeexpandSmokeCommand仅负责替换${DB_PORT}/${DB_PASSWORD}占位符本命令不含占位符原样执行。断言输出捕获命令输出用output.includes(step.expect)检查是否包含1 messages successfully produced通过则打印OK produce a smoke message不通过则抛出明确错误。配方校验方面scripts/database-env.mjs 还要求每个冒烟步骤都必须具备name、command数组与expect期望输出执行make db-check会逐条校验所有配方的结构与 Compose 文件合法性见 Makefile。在 dbx 中连接 Pulsar 4.2Pulsar 属于消息中间件类别。在 dbx 的连接类型目录 plugins/connection-types/profiles/catalog.yaml 中Apache Pulsar 被注册为mq类型默认端口 8080、默认主机127.0.0.1。容器启动后可用的连接信息如下参数值说明主机127.0.0.1配方默认绑定回环地址Broker 端口11400宿主映射对应容器 6650二进制协议Web 端口11401宿主映射对应容器 8080HTTP 管理命名空间public/defaultstandalone 自动创建认证无authentication: none需要说明的是make db启动后打印的dbx://connection/new预填深链依赖 scripts/database-env.mjs 中的DBX_DEEP_LINK_TYPES映射表而该表暂未包含pulsar因此脚本会输出DBX connection link: unavailable见 scripts/database-env.mjs。此时可手动在 dbx 新建连接中选择 Apache PulsarMQ 类别按上表填写主机与端口即可。小结本文从 deploy/database/pulsar/4.2/init/README.md 这一冒烟数据说明出发完整还原了 dbx 中 Pulsar 4.2 测试配方的运作机制standalone 自动预置public/default命名空间使persistent://public/default/dbx-smoke可零初始化直接发布make db-verify DBpulsar4.2的完整链路Compose 健康检查 → 容器内pulsar-client produce→ 断言1 messages successfully produced端口映射与连接参数宿主 11400/11401 对应容器 6650/8080本地无鉴权连接。这套配方与make db-list、make db-check等目标共同构成了 dbx 可复现的数据库验证体系也为后续在 dbx 中开发、测试 Pulsar 消息能力提供了标准化的本地环境。赞分享数据库开发者工具桌面应用CLIMCP 服务AI 应用【免费下载链接】dbx15MB轻量级跨平台数据库客户端、数据库管理工具。支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、DuckDB、ClickHouse、SQL Server 等。15MB, lightweight, cross-platform database client. Supports MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, ClickHouse, SQL Server and more.项目地址https://gitcode.com/t8y2/dbx点击查看免费下载相关推荐DBX 中的 Pulsar 4.2 测试环境standalone 部署与 DBX smoke 冒烟验证指南DBX 中的 Pulsar 4.2 测试环境standalone 部署与 DBX smoke 冒烟验证指南 DBX 仓库在 deploy/database/数据库客户端数据库桌面应用CLI后端MCP 服务AI 应用dbx 仓库中 Elasticsearch 6.8 冒烟测试环境make db-verify 与 dbx-smoke 索引验证实战dbx 仓库中 Elasticsearch 6.8 冒烟测试环境make db verify 与 dbx smoke 索引验证实战 导读 deploy/dat数据库开发者工具桌面应用CLIMCP 服务AI 应用DBX 仓库 ZooKeeper 3.9 测试环境Digest ACL 初始化与冒烟验证实战DBX 仓库 ZooKeeper 3.9 测试环境Digest ACL 初始化与冒烟验证实战 本文以仓库中 deploy/database/zookeeper数据库客户端数据库桌面应用CLI后端MCP 服务AI 应用上一篇【亲测免费】 基于51单片机DS18B20温度传感器设计的温控系统打造您的智能温度监测解决方案下一篇【免费下载】 探索OFDM技术一个完整的Matlab仿真资源【matlab下载】创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

关于本文作者

来自尧图内容编辑团队

尧图内容编辑团队 内容团队

尧图内容编辑团队

本文由尧图网络内容编辑团队执笔。团队由资深项目经理、前端工程师与设计师组成,所有内容均来自亲手交付的真实项目,先讲清问题、再给出可落地的解法。尧图深耕北京网站建设十年,服务过京华建材集团、智造科技等各行业客户,把一线经验沉淀为可复用的行业观察。

  • 十年建站经验,覆盖建材、制造、服务、文创等
  • 项目经理把关选题与事实准确性
  • 工程师与设计师联合撰写专业细节
  • 统一编辑规范,保证文风与排版一致
  • 每月复盘转化数据,迭代选题方向

延伸阅读

相关资讯与近期热门内容

深度阅读推荐

建站决策前值得细读的三篇

网站改版的5个关键决策
2024-08-12

网站改版的5个关键决策

什么时候该改版、改到什么程度、如何避免流量掉光,京华建材集团改版复盘给出答案。

获取专属建站方案

看完文章,把您的行业与预算告诉我们,免费获取一份量身定制的官网建设方案与报价。

立即免费咨询