x/gateway/ipc 入门
x/gateway/ipc 入门
Section titled “x/gateway/ipc 入门”实验性 — API 兼容性未冻结。在生产环境采用前请先评估。当前成熟度状态见 发布策略。
当任务明确涉及进程之间显式的进程间通信传输时，打开本页——而不是通用消息流场景。如果不确定哪个扩展适用，请从 x/gateway 或 x/messaging 开始。
x/gateway/ipc 是 x/gateway 的下级原语，提供底层 IPC 辅助函数和显式传输适配器。它不是应用启动工具、消息抽象或工作流编排器。
稳定性与采用
Section titled “稳定性与采用”x/gateway/ipc 处于实验性状态，API 兼容性未冻结。在生产环境采用前：
- 检查
x/gateway/ipc/module.yaml了解当前状态、所有者和已知阻塞项。 - 阅读 发布策略 查看支持矩阵。
- 考虑
x/gateway是否能在更高抽象层级上覆盖你的使用场景。
以下情况使用 x/gateway/ipc：
- 任务涉及显式的 IPC 传输行为。
- 任务涉及进程之间的客户端/服务器通信。
- 需要在传输层面直接控制进程间通信。
以下情况不要使用 x/gateway/ipc：
- 应用启动——使用
core。 - 通用消息家族发现——从
x/messaging开始。 - 业务工作流编排——使用
x/messaging/scheduler或x/messaging。 - 进程内通信——使用
x/messaging/pubsub。 - 持久化队列——使用
x/messaging/mq。
首先阅读的文件
Section titled “首先阅读的文件”x/gateway/ipc/module.yaml— 职责、非目标和验证命令x/gateway/ipc/ipc.go— 主要传输契约x/messaging 入门— 面向应用的消息入口
x/gateway/ipc提供显式 IPC 传输；不要用它替代进程内消息（x/messaging/pubsub）或持久化队列（x/messaging/mq）。- 保持传输契约和进程级副作用的显式性和可审查性；不要在导入时添加隐式通道注册。
- 不要通过稳定根暴露 IPC 连接字符串或 socket 路径；将它们保留在
x/gateway/ipc适配器的本地范围内。 - 在扩大
x/gateway/ipc调用方之前，优先使用x/messaging作为跨进程消息的面向应用入口。
规范变更形态
Section titled “规范变更形态”- 保持传输契约显式。
- 保持进程级副作用的可审查性。
- 在扩大
x/gateway/ipc范围前，优先在x/gateway或x/messaging中进行家族级发现。
go test -timeout 20s ./x/gateway/ipc/...- x/gateway 入门 — 边缘和代理传输的父家族
- x/messaging 入门 — 面向应用的跨进程消息
- 扩展边界 — 下级原语与父家族的关系
- 发布策略 — 支持矩阵和成熟度读法