LJWX Health 数据平台
版本: 2.0.0
发布日期: 2026-01-21

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
                    变更日志
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

v2.0.0 (2026-01-21) - 镜像管理与部署优化
───────────────────────────────────────────────────────

✨ 新增功能:
  - 本地 Harbor 镜像缓存支持 (harbor.omniverseai.net)
  - 统一部署脚本 v2.0 (deploy-data-platform.sh)
  - 镜像缓存脚本 (cache-data-platform-images.sh)
  - Harbor 配置生成器 (generate-harbor-values.sh)
  - 完整的 ServiceMonitor 集成 (Prometheus/Tempo/Loki)

🔧 改进:
  - 升级 Redpanda: v24.1.1 → v24.2.11 (支持窗口内)
  - 升级 ClickHouse: 24.1-alpine → 24.3.12.75 (Debian LTS)
  - 添加镜像 digest pin 支持
  - 优化 Mac Studio Ultra 配置 (降低资源使用)
  - 完善可观测性集成 (metrics/traces/logs)

📚 文档:
  - 部署指南 v2.0 (DEPLOYMENT_GUIDE.md)
  - 镜像管理指南 (multi-arch-build-guide.md)
  - 版本管理规范 (image-versioning-guide.md)
  - 可观测性集成指南 (observability-stack-integration.md)
  - 部署完成报告 (OBSERVABILITY_INTEGRATION_COMPLETE.md)

⚠️ 重要变更:
  - 自研镜像必须使用版本化 tag (vYYYYMMDD-gitsha)
  - 禁止使用 latest 标签
  - 生产部署必须添加 digest pin
  - ClickHouse 基础镜像从 alpine 切换到 Debian

🐛 修复:
  - OpenTelemetry Collector 端点配置错误
  - ServiceMonitor 缺少 release: monitoring 标签
  - Mac 配置缺少 monitoring 章节

───────────────────────────────────────────────────────

v1.0.0 (2026-01-20) - 初始版本
───────────────────────────────────────────────────────

✨ 功能:
  - Redpanda 3 副本集群 (Kafka 兼容)
  - ClickHouse 3 副本集群 (时序数据库)
  - Writer Consumer (数据写入消费者)
  - Alert Consumer (实时告警消费者)
  - Aggregator CronJob (定时聚合任务)
  - Mac Studio Ultra 优化配置

📦 组件版本:
  - Redpanda: v24.1.1
  - ClickHouse: 24.1-alpine
  - BusyBox: 1.36

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
                    升级指南
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

从 v1.0.0 升级到 v2.0.0:

1. 缓存新版本镜像 (推荐):
   ./scripts/cache-data-platform-images.sh

2. 生成 Harbor 配置:
   ./scripts/generate-harbor-values.sh

3. 执行升级部署:
   ./scripts/deploy-data-platform.sh --use-harbor

4. 验证监控集成:
   kubectl get servicemonitor -n infra
   kubectl port-forward -n observability svc/prometheus-* 9090:9090

注意事项:
  - StatefulSet 会滚动升级，保持服务可用
  - Deployment 会先启动新 Pod 再停止旧 Pod
  - PVC 数据不会丢失
  - 建议在非高峰期升级

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
                    组件版本清单
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

基础设施镜像:
  ├── Redpanda:           v24.2.11       (multi-arch)
  ├── ClickHouse:         24.3.12.75     (Debian LTS, multi-arch)
  └── BusyBox:            1.36.1         (multi-arch)

自研服务镜像:
  ├── Writer Consumer:    v1.0.0         (⚠️ 占位符，需构建)
  ├── Alert Consumer:     v1.0.0         (⚠️ 占位符，需构建)
  └── Aggregator:         v1.0.0         (⚠️ 占位符，需构建)

可观测性集成:
  ├── Prometheus:         复用现有 (observability namespace)
  ├── Grafana:            复用现有 (observability namespace)
  ├── Tempo:              复用现有 (tracing namespace)
  └── Loki:               复用现有 (logging namespace)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
                    部署选项
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

标准生产部署:
  ./scripts/deploy-data-platform.sh

Mac Studio Ultra 部署:
  ./scripts/deploy-data-platform.sh --mac

使用本地 Harbor:
  ./scripts/deploy-data-platform.sh --use-harbor

Mac + Harbor 组合:
  ./scripts/deploy-data-platform.sh --mac --use-harbor

自定义命名空间:
  ./scripts/deploy-data-platform.sh -n my-namespace --use-harbor

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
                    技术规格
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

性能指标:
  - 数据吞吐量:         28.8M 记录/天 (~1000 RPS)
  - Kafka 保留时间:     24 小时
  - ClickHouse 存储:    500Gi (生产) / 200Gi (Mac)
  - 告警延迟:           <1s (P99)
  - 聚合频率:           每 5 分钟

资源配置 (生产):
  Redpanda:
    - CPU:              1000m - 2000m
    - Memory:           4Gi - 8Gi
    - Storage:          100Gi per replica

  ClickHouse:
    - CPU:              2000m - 6000m
    - Memory:           8Gi - 32Gi
    - Storage:          500Gi per replica

  Writer Consumer:
    - CPU:              500m - 1000m
    - Memory:           1Gi - 2Gi
    - Replicas:         2

  Alert Consumer:
    - CPU:              250m - 500m
    - Memory:           512Mi - 1Gi
    - Replicas:         1

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

维护者: LJWX Health DevOps Team
许可证: Internal Use Only
最后更新: 2026-01-21 16:00 UTC+8
