cnfltraining/node-webserver-avro Docker 镜像 - 轩辕镜像

Docker镜像文档

镜像概述和主要用途

该Docker镜像为应用提供基础运行环境，通常包含监控拦截器以支持请求跟踪、性能指标采集等监控功能。请注意，在arm64架构版本中，监控拦截器组件未被包含，相关监控能力将不可用。主要用于部署对监控拦截器无强依赖的应用场景，或在非arm64架构环境中需使用监控功能的场景。

核心功能和特性

• 基础运行支持：提供应用所需的基础运行环境，确保核心业务逻辑正常执行
• 监控拦截能力（非arm64）：在x86等非arm64架构下，包含完整监控拦截器，支持请求拦截、指标收集、日志增强等功能
• 架构兼容性：支持x86_64和arm64双架构部署，自动适配不同硬件环境

使用场景和适用范围

适用场景

• 需在x86架构环境中使用监控拦截功能的应用部署
• 对监控拦截器无依赖的arm64架构应用部署
• 需要跨架构统一部署策略的应用场景

不适用场景

• 必须在arm64架构下使用监控拦截功能的场景
• 对监控指标采集有强依赖的arm64环境部署

使用方法和配置说明

前提条件

• Docker Engine 20.10+
• 目标主机架构为x86_64或arm64

镜像拉取

bash
# 自动匹配当前架构
docker pull [镜像仓库地址]/[镜像名]:latest

# 手动指定x86_64架构（含监控拦截器）
docker pull --platform linux/amd64 [镜像仓库地址]/[镜像名]:latest

# 手动指定arm64架构（不含监控拦截器）
docker pull --platform linux/arm64 [镜像仓库地址]/[镜像名]:latest

容器运行

x86_64架构（含监控拦截器）

bash
docker run -d \
  --name app-container \
  --platform linux/amd64 \
  -p 8080:8080 \
  [镜像仓库地址]/[镜像名]:latest

说明：此模式下监控拦截器自动启用，可通过镜像默认监控端口（通常为9090）访问指标数据

arm64架构（不含监控拦截器）

bash
docker run -d \
  --name app-container \
  --platform linux/arm64 \
  -p 8080:8080 \
  [镜像仓库地址]/[镜像名]:latest

说明：此模式下监控相关端口不会开放，应用仅提供基础功能

注意事项

• 部署前需确认目标架构及对监控功能的需求，避免架构选择错误导致功能缺失
• arm64架构下启动后，应用日志中会显示"monitoring-interceptors not loaded"提示，属正常现象
• 如需在arm64架构下实现监控，需额外部署独立监控代理或使用第三方监控方案