tsw.jstsw.js

测试环境

用户维度切换测试环境

添加

增加如下配置项,重启,测试环境列表里会自动出现

this.isTest = true;
this.testInfo = {
    "name"      : "神秘商店",
    "group"     : "TSW",
    "groupName" : "TSW团队",
    "desc"      : "没有人能知道这里在售卖什么",
    "order"     : 30,
    "owner"     : "TSW"
};

切换

  1. 开放平台切换
    1. 登录https://tswjs.org
    2. 选择要切换的应用
    3. 点击测试环境,进行切换
  2. 私有化部署切换
    1. 直接访问http://${host}/group
      • host -- 表示实际部署的管理端域名或IP
    2. 选择分组,进行切换

注意事项

  1. 生效时间 -- 切换测试环境后,1分钟后全网生效
  2. 有效期 -- 测试环境当天有效,0点自动失效
  3. 用户标识 -- 在请求周期内可以设置用户UID用来染色,但对测试环境联动只有以下两种途径
    1. 在路由的name阶段,设置UID
    2. config.js中,重新定义从request解析UID的实现
      this.extendMod = {
          getUin: function(request){
              const uid;
               //code...
              return uid;
          }
      }
      

原理

  1. TSW会维护一个UID到测试环境IP+PORT的路由表
  2. 命中路由表的请求,流式转发给测试环境

故障排除

  • 配置测试环境后,未出现在测试环境列表里时,排查清单
    1. 确认是Linux环境
    2. 确认config.isTest是否为true
      • 可使用工具TSW/bin/proxy/dump.config.sh查看目前生效的配置文件对象
    3. 排查TSW/log/run.log.0日志中是否有错误日志
    4. 排查openapi.tswjs.org域名是否连通,特别是443端口
    5. 确认appid+appkey无误,并重启使其生效
    6. 如果以上还不能解决,直接联系TSW协助排查