README
¶
component-base
Scheme, typing, encoding, decoding, and conversion packages for FangcunMont project.
消息职责退役
v0.7.0 已不再提供 pkg/messaging、pkg/event、pkg/eventcatalog、
pkg/eventcodec、pkg/eventmessaging、pkg/outbox 和 pkg/outboxcore。
NSQ 发布订阅、消息封装、重试及 Outbox 共性职责由
reliable-messaging 承接；
首期 SDK 仅支持 NSQ，旧 RabbitMQ 入口在本次退役，不承诺替代支持。
业务事件、事务边界、业务幂等和失败处置仍由服务负责。
这是删除公开 API 的不兼容变更，已以 v0.7.0 发布。升级前须清理
运行代码及测试的旧包导入，并通过固定旧版本的消息格式和恢复契约验证。
IAM 和 QS 的新链路使用可靠消息 SDK；其他调用者不能仅修改模块版本。
原数据库事务和宿主持久记录不会因更换模块自动消失。
旧实现仍可从固定 v0.6.11 获取。历史互通及回退验证应使用固定旧版本的
独立模块或二进制，不能将旧算法复制回服务，也不能将当前 SDK 对端当作旧版本。
本仓库不提供空实现或静默成功的兼容入口。
临时发布订阅归属收口
下一版本 v0.8.0 删除剩余 pkg/signaling 及 Redis 适配器。通用
Signal／Notifier／Watcher 和最佳努力 Redis 唤醒能力由 reliable-messaging
的 signaling 与 signaling/redis 承接；宿主必须使用包含这些包的固定 SDK
发布版本，并通过消息格式、取消、连接归属与业务兜底核验后再升级。
Redis 信号不是可靠 broker，不保证有订阅者、业务处理或持久回执。
SDK 的可靠 broker 支持范围仍为 NSQ。
宿主仍负责业务信号、权威状态、缓存和轮询兜底。不改变数据库事务、
历史消息、任务授权、模型调用或原配置。旧接口可从固定 v0.7.0 取得，
当前版本不保留转发门面。日志、数据库、锁和其他非消息基础能力不受影响。
Directories
¶
| Path | Synopsis |
|---|---|
|
pkg
|
|
|
backpressure
Package backpressure 提供通用并发背压机制。
|
Package backpressure 提供通用并发背压机制。 |
|
errors
Package errors provides simple error handling primitives.
|
Package errors provides simple error handling primitives. |
|
grpc/interceptors
Package interceptors 提供服务级 ACL 权限控制拦截器
|
Package interceptors 提供服务级 ACL 权限控制拦截器 |
|
grpc/mtls
Package mtls 提供 mTLS 双向认证配置和管理功能
|
Package mtls 提供 mTLS 双向认证配置和管理功能 |
|
locklease
Package locklease 定义分布式租约锁的通用领域端口。
|
Package locklease 定义分布式租约锁的通用领域端口。 |
|
locklease/redisadapter
Package redisadapter 提供基于 Redis 的 locklease.Manager 实现。
|
Package redisadapter 提供基于 Redis 的 locklease.Manager 实现。 |
|
log
Package log is a log package used by TKE team.
|
Package log is a log package used by TKE team. |
|
log/distribution
Package distribution implements a logger which compatible to logrus/std log/prometheus.
|
Package distribution implements a logger which compatible to logrus/std log/prometheus. |
|
log/example
command
|
|
|
log/example/advanced
command
Package main 展示日志模块的高级功能组合使用
|
Package main 展示日志模块的高级功能组合使用 |
|
log/example/colorful
command
Package main 展示带颜色和方括号的日志输出
|
Package main 展示带颜色和方括号的日志输出 |
|
log/example/compare
command
Package main 对比展示带颜色和不带颜色的日志输出
|
Package main 对比展示带颜色和不带颜色的日志输出 |
|
log/example/comparison
command
对比三种日志分级输出模式
|
对比三种日志分级输出模式 |
|
log/example/context
command
|
|
|
log/example/dailyrotation
command
Package main 展示按天轮转日志功能
|
Package main 展示按天轮转日志功能 |
|
log/example/duplicatemode
command
演示 duplicate 模式：app.log 记录所有日志，error.log 额外记录错误
|
演示 duplicate 模式：app.log 记录所有日志，error.log 额外记录错误 |
|
log/example/exactlevel
command
Package main 展示精确级别输出模式
|
Package main 展示精确级别输出模式 |
|
log/example/hourlyrotation
command
Package main 展示按小时轮转日志功能
|
Package main 展示按小时轮转日志功能 |
|
log/example/leveloutput
command
Package main 展示日志分级输出功能
|
Package main 展示日志分级输出功能 |
|
log/example/microservices
command
Package main 展示微服务间的链路追踪
|
Package main 展示微服务间的链路追踪 |
|
log/example/nocolor
command
Package main 展示不带颜色但有方括号的日志输出
|
Package main 展示不带颜色但有方括号的日志输出 |
|
log/example/production
command
演示实际生产环境的日志配置：app.log 记录所有，error.log 额外记录错误，按天轮转
|
演示实际生产环境的日志配置：app.log 记录所有，error.log 额外记录错误，按天轮转 |
|
log/example/simple
command
|
|
|
log/example/tracing
command
Package main 展示链路追踪集成功能
|
Package main 展示链路追踪集成功能 |
|
log/example/typed-logs
command
演示类型化日志的使用
|
演示类型化日志的使用 |
|
log/example/vlevel
command
|
|
|
log/klog
Package klog init klog logger.
|
Package klog init klog logger. |
|
log/logrus
Package logrus adds a hook to the logrus logger hooks.
|
Package logrus adds a hook to the logrus logger hooks. |
|
log/otel
Package otel 提供 OpenTelemetry 集成
|
Package otel 提供 OpenTelemetry 集成 |
|
logger
Package logger 提供请求范围的日志工具
|
Package logger 提供请求范围的日志工具 |
|
logger/examples
Package examples 提供 logger 包的使用示例
|
Package examples 提供 logger 包的使用示例 |
|
processruntime
Package processruntime 提供进程启动与关闭编排的基础机制。
|
Package processruntime 提供进程启动与关闭编排的基础机制。 |
|
ratelimit
Package ratelimit 提供通用限流机制。
|
Package ratelimit 提供通用限流机制。 |
|
ratelimit/redisadapter
Package redisadapter 提供 ratelimit.Backend 的 Redis 实现。
|
Package redisadapter 提供 ratelimit.Backend 的 Redis 实现。 |
|
redis
Package rediskit 提供 component-base Redis Foundation 的兼容门面。
|
Package rediskit 提供 component-base Redis Foundation 的兼容门面。 |
|
shutdown
Package shutdown Providing shutdown callbacks for graceful app shutdown
|
Package shutdown Providing shutdown callbacks for graceful app shutdown |
|
shutdown/shutdownmanagers/posixsignal
Package posixsignal provides a listener for a posix signal.
|
Package posixsignal provides a listener for a posix signal. |
|
util/idutil
Package idutil 提供各种 ID 生成和验证工具
|
Package idutil 提供各种 ID 生成和验证工具 |
|
util/idutil/example
command
|
|