jambonz/webhook-test-scaffold

jambonz-feature-server

镜像概述和主要用途

jambonz-feature-server是jambones平台的核心功能服务器，用于实现该平台的核心语音通信功能。它通过与drachtio服务器、Freeswitch服务器、MySQL数据库、Redis等服务交互，处理平台关键业务逻辑，支持集成AWS、GCP等云服务，并可配置 metrics 生成。

核心功能和特性

• 作为jambones平台核心组件，处理语音通信核心业务逻辑
• 支持与AWS服务集成，提供TTS/STT及SNS通知功能
• 集成GCP服务，需通过密钥文件进行身份验证
• 可生成 metrics 数据，支持Telegraf格式输出
• 提供凭证加密功能，需配置加密密钥
• 与drachtio服务器建立控制连接，实现信令处理
• 连接Freeswitch服务器，处理媒体相关操作
• 依赖MySQL数据库存储业务数据，Redis用于缓存及状态管理

使用方法和配置说明

环境变量配置

以下环境变量用于配置服务运行参数，分为必填项和可选项：

在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'
      }
    }
  ]
};

运行测试套件

测试套件运行方法请参考此处。