jambonz/feature-server

jambonz-feature-server

镜像概述和主要用途

jambonz-feature-server是jambones平台的核心功能服务器，实现平台核心功能逻辑。该服务器负责处理SIP通信控制、媒体资源管理、与其他组件（如Drachtio服务器、Freeswitch媒体服务器、数据库、缓存服务）的集成，以及AWS/GCP云服务对接（如TTS/STT、通知等），是构建jambones通信平台的关键组件。

核心功能和特性

• SIP控制集成：与Drachtio服务器建立控制连接，处理SIP信令交互
• 媒体处理管理：通过Freeswitch服务器进行媒体资源管理和处理
• 数据存储与缓存：连接MySQL数据库存储业务数据，使用Redis进行缓存管理
• 云服务对接：支持AWS（TTS/STT、SNS通知）和GCP服务集成（通过应用凭据）
• 监控与指标：支持生成指标数据，可配置为Telegraf格式，便于监控集成
• 安全特性：提供加密密钥用于凭据加密，保障数据安全
• 日志管理：支持日志级别控制（info/debug），便于问题排查

使用场景和适用范围

适用于jambones通信平台的部署环境，用于构建基于SIP的语音通信应用，如呼叫中心、语音通知、交互式语音应答（IVR）、语音录制与转写等场景，需与jambones平台其他组件（如SBC、API服务器）协同工作。

详细的使用方法和配置说明

环境变量配置

该应用通过环境变量进行配置，以下是主要配置项说明：

使用pm2运行

该应用通常使用pm2进程管理工具运行，通过ecosystem.config.js文件配置环境变量和运行参数。以下是典型配置示例：

js
module.exports = {
  apps: [
    {
      name: 'jambonz-feature-server',
      cwd: '/home/admin/apps/jambonz-feature-server',
      script: 'app.js',
      instance_var: 'INSTANCE_ID',
      out_file: '/home/admin/.pm2/logs/jambonz-feature-server.log',
      err_file: '/home/admin/.pm2/logs/jambonz-feature-server.log',
      exec_mode: 'fork',
      instances: 1,
      autorestart: true,
      watch: false,
      max_memory_restart: '1G',
      env: {
        NODE_ENV: 'production',
        GOOGLE_APPLICATION_CREDENTIALS: '/home/admin/credentials/gcp.json',
        AWS_ACCESS_KEY_ID: 'XXXXXXXXXXXX',
        AWS_SECRET_ACCESS_KEY: 'YYYYYYYYYYYYYYYYYYYYY',
        AWS_REGION: 'us-west-1',
        ENABLE_METRICS: 1,
        STATS_HOST: '127.0.0.1',
        STATS_PORT: 8125,
        STATS_PROTOCOL: 'tcp',
        STATS_TELEGRAF: 1,
        AWS_SNS_TOPIC_ARN: 'arn:aws:sns:us-west-1:xxxxxxxxxxx:terraform-20201107200347128600000002',
        JAMBONES_NETWORK_CIDR: '172.31.0.0/16',
        JAMBONES_MYSQL_HOST: 'aurora-cluster-jambonz.cluster-yyyyyyyyyyy.us-west-1.rds.amazonaws.com',
        JAMBONES_MYSQL_USER: 'admin',
        JAMBONES_MYSQL_PASSWORD: 'foobarbz',
        JAMBONES_MYSQL_DATABASE: 'jambones',
        JAMBONES_MYSQL_CONNECTION_LIMIT: 10,
        JAMBONES_REDIS_HOST: 'jambonz.zzzzzzz.0001.usw1.cache.amazonaws.com',
        JAMBONES_REDIS_PORT: 6379,
        JAMBONES_LOGLEVEL: 'debug',
        HTTP_PORT: 3000,
        DRACHTIO_HOST: '127.0.0.1',
        DRACHTIO_PORT: 9022,
        DRACHTIO_SECRET: 'sharedsecret',
        JAMBONES_SBCS: '172.31.32.10',
        JAMBONES_FREESWITCH: '127.0.0.1:8021:sharedsecret'
      }
    }
  ]
};

运行测试套件

有关运行回归测试套件的详细说明，请参考贡献文档。