astronomerinc/ap-nats-server

NATS Server (Astronomer Platform专用镜像)

镜像概述

本镜像为Astronomer平台提供专用的NATS Server部署，基于NATS（Neural Autonomic Transport System）轻量级消息系统构建。NATS以高性能、低延迟、分布式特性著称，专为云原生和微服务架构设计。该镜像针对Astronomer平台进行了优化，确保与平台内其他组件（如Airflow、微服务等）的无缝集成，提供可靠的消息传递基础设施，支持平台内微服务间的实时通信、数据交换及事件驱动工作流。

核心功能与特性

• 高性能消息传递：采用无代理（broker-less）架构设计，减少中间开销，支持每秒数百万消息的处理能力，满足实时通信需求。
• 多消息模式支持：原生支持发布/订阅（Pub/Sub）、请求/回复（Request/Reply）、队列订阅（Queue Subscriptions）等多种消息模式，灵活适应不同业务场景。
• 轻量级设计：镜像体积小，资源占用低，适合容器化部署，可在资源受限环境中高效运行。
• 分布式架构支持：内置集群功能，支持多节点部署，提供高可用性和水平扩展能力，适应平台规模增长。
• Astronomer平台集成优化：预配置与Astronomer平台组件的兼容性参数，简化部署流程，减少集成复杂度。
• 安全特性：支持TLS加密、认证授权机制，保障消息传输安全，符合平台安全标准。

使用场景

• Astronomer平台微服务通信：作为平台内微服务间的通信枢纽，实现服务间低延迟消息传递，解耦服务依赖。
• 实时数据流处理：支持平台内实时数据流的传输与处理，如监控指标、日志数据、事件通知等。
• 事件驱动架构实现：为平台内事件驱动型应用提供基础消息层，支持基于事件的服务协作（如任务调度、状态更新等）。
• 服务解耦与弹性扩展：通过消息队列机制解耦发送方与接收方服务，提高系统弹性，支持服务独立扩展。

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动Astronomer NATS Server容器：

bash
docker run -d \
  --name astronomer-nats \
  -p 4222:4222 \  # 客户端连接端口
  -p 8222:8222 \  # 监控端口
  astronomer/nats-server:latest

Docker Compose配置示例

在Astronomer平台部署中，可通过docker-compose.yml集成NATS Server：

yaml
version: '3.8'
services:
  nats:
    image: astronomer/nats-server:latest
    container_name: astronomer-nats
    ports:
      - "4222:4222"  # 客户端通信端口
      - "8222:8222"  # 监控端口（用于健康检查、指标）
      - "6222:6222"  # 集群通信端口（集群部署时启用）
    environment:
      - NATS_PORT=4222  # 客户端连接端口
      - NATS_MAX_PAYLOAD=1048576  # 最大消息 payload 大小（字节）
      - NATS_CLUSTER_NAME=astronomer-nats-cluster  # 集群名称（集群模式）
      - NATS_DEBUG=false  # 是否启用调试日志
    volumes:
      - nats-data:/data  # 持久化数据卷（如需消息持久化）
    restart: unless-stopped

volumes:
  nats-data:

环境变量配置说明

集群部署说明

如需在Astronomer平台中部署NATS集群以提高可用性，可通过以下配置实现多节点集群（示例为3节点集群）：

yaml
# docker-compose-cluster.yml
version: '3.8'
services:
  nats-1:
    image: astronomer/nats-server:latest
    container_name: astronomer-nats-1
    ports:
      - "4222:4222"
      - "8222:8222"
      - "6222:6222"
    environment:
      - NATS_PORT=4222
      - NATS_CLUSTER_PORT=6222
      - NATS_CLUSTER_NAME=astronomer-nats-cluster
      - NATS_CLUSTER_ADVERTISE=nats://nats-1:6222
      - NATS_ROUTES=nats://nats-2:6222,nats://nats-3:6222  # 其他集群节点地址
    restart: unless-stopped

  nats-2:
    image: astronomer/nats-server:latest
    container_name: astronomer-nats-2
    ports:
      - "4223:4222"
      - "8223:8222"
      - "6223:6222"
    environment:
      - NATS_PORT=4222
      - NATS_CLUSTER_PORT=6222
      - NATS_CLUSTER_NAME=astronomer-nats-cluster
      - NATS_CLUSTER_ADVERTISE=nats://nats-2:6222
      - NATS_ROUTES=nats://nats-1:6222,nats://nats-3:6222
    restart: unless-stopped

  nats-3:
    image: astronomer/nats-server:latest
    container_name: astronomer-nats-3
    ports:
      - "4224:4222"
      - "8224:8222"
      - "6224:6222"
    environment:
      - NATS_PORT=4222
      - NATS_CLUSTER_PORT=6222
      - NATS_CLUSTER_NAME=astronomer-nats-cluster
      - NATS_CLUSTER_ADVERTISE=nats://nats-3:6222
      - NATS_ROUTES=nats://nats-1:6222,nats://nats-2:6222
    restart: unless-stopped

注意事项

• 该镜像专为Astronomer平台设计，建议仅在Astronomer环境中使用，以确保与平台组件的兼容性。
• 生产环境中建议启用持久化存储（通过volumes挂载数据卷）及集群部署，提高服务可用性。
• 如需自定义NATS配置，可通过挂载nats.conf配置文件实现（如-v ./nats.conf:/etc/nats/nats.conf）。