arumugamsubramanian/mid-windows

Mid Server Windows 镜像文档

镜像概述

本镜像为基于Windows Server环境的Mid Server（中间服务器）容器化实现，专为ServiceNow等企业级平台设计，提供内部系统与外部服务间的安全通信桥梁，支持跨网络环境下的应用集成、数据传输与自动化任务执行，简化企业IT架构中的系统互联流程。

核心功能与特性

• 系统连接：建立内部系统（如ERP、CRM、数据库）与外部服务（如ServiceNow）的通信通道，支持跨网段、跨防火墙环境
• 脚本执行：运行自定义JavaScript/PowerShell脚本，实现数据转换、服务调用、业务逻辑处理等自动化任务
• 文件传输：支持SFTP、FTP等协议的安全文件传输，实现跨系统数据同步
• 安全通信：集成TLS加密、身份认证机制，保障数据传输过程中的机密性与完整性
• 配置灵活：通过环境变量快速配置核心参数，支持持久化存储配置文件与日志数据
• 状态监控：实时上报运行状态至管理平台（如ServiceNow），支持远程健康检查与故障排查

使用场景

• 企业系统集成：企业内部ERP、HR系统与ServiceNow平台的双向数据同步与流程对接
• 跨网络服务通信：在隔离网络环境中（如DMZ区与内网）代理服务请求，实现安全的数据中转
• 自动化任务执行：定时执行系统巡检、数据备份、日志收集等运维任务
• 服务扩展：通过多实例部署扩展Mid Server处理能力，应对高并发集成需求

使用方法

快速启动（docker run）

docker
docker run -d \
  --name midserver-windows \
  --hostname midserver-01 \
  -e MID_SERVER_NAME="Production-MID-01" \
  -e SN_INSTANCE_URL="https://your-instance.service-now.com" \
  -e SN_USERNAME="midserver_admin" \
  -e SN_PASSWORD="SecurePass123!" \
  -e LOG_LEVEL="INFO" \
  -v /host/path/midserver/config:/midserver/config \
  -v /host/path/midserver/logs:/midserver/logs \
  --restart unless-stopped \
  midserver-windows-image:latest

Docker Compose 配置示例

yaml
version: '3.8'
services:
  midserver:
    image: midserver-windows-image:latest
    container_name: midserver-windows
    hostname: midserver-prod
    restart: unless-stopped
    environment:
      # 核心配置
      MID_SERVER_NAME: "Production-MID-01"
      SN_INSTANCE_URL: "https://dev12345.service-now.com"
      SN_USERNAME: "midserver_admin"
      SN_PASSWORD: "SecurePass123!"
      # 可选配置
      PROXY_HOST: "proxy.corp.com"
      PROXY_PORT: 3128
      LOG_LEVEL: "INFO"
      MAX_THREADS: 20
    volumes:
      # 持久化配置文件（包含证书、自定义脚本等）
      - ./midserver/config:/midserver/config
      # 持久化日志数据
      - ./midserver/logs:/midserver/logs
    ports:
      # 如需外部访问Mid Server管理端口，可映射（默认不暴露）
      # - "8080:8080"

环境变量配置说明

启动与验证步骤

1. 配置准备：根据实际环境修改环境变量（如ServiceNow实例URL、凭证），创建本地配置与日志目录（如./midserver/config、./midserver/logs）
2. 启动容器：执行docker-compose up -d或上述docker run命令
3. 状态验证：
   • 查看容器运行状态：docker ps | grep midserver-windows
   • 检查启动日志：docker logs midserver-windows -f（首次启动需等待配置初始化，约1-2分钟）
   • 在ServiceNow平台验证：登录实例后，进入System Management > Mid Servers，确认目标Mid Server状态为"Up"

注意事项

• 系统要求：需运行在支持Windows容器的Docker环境（如Windows Server 2019+/Windows 10+专业版，启用Hyper-V与容器功能）
• 资源配置：建议分配至少2 CPU核心、4GB内存，日志与配置目录需确保读写权限
• 凭证安全：生产环境中建议通过Docker Secrets或外部密钥管理服务存储密码，避免明文配置
• 版本兼容性：需与目标ServiceNow实例版本兼容（参考ServiceNow官方Mid Server版本要求）