移动端部署
打开浏览器访问链接 ,使用企业微信扫码登录,注意需要使用有管理员权限的用户。
企业微信新建应用
点击导航中”应用管理”,在自建应用中点击”新建应用”,应用logo请上传标准运维SaaS的logo,应用名称填写”标准运维”,应用介绍可以选填,可见范围根据企业内需求配置,如果希望企业内所有人都可以访问,请选择组织架构中的根节点。
企业微信应用管理
在”开发者接口”中找到”网页授权及JS-SDK”,并设置可信域名为 {BK_PAAS_OUTER_HOST}。
在”开发者接口”中找到”企业微信授权登录”,并设置授权回调域为 {BK_PAAS_OUTER_HOST}。其中,{BK_PAAS_OUTER_HOST} 为你部署的蓝鲸外网域名,如果是 HTTPS 协议,”企业微信授权登录”中授权回调域请添加端口号 443,即 。
以蓝鲸管理员身份访问蓝鲸开发者中心,进入”API网关”的”通道管理”,选择”[CMSI]蓝鲸消息管理”,编辑”[CMSI]发送微信消息”,在”组件配置”中修改配置,具体方法参考”API网关”的”使用指南”中”微信消息组件”章节,注意:
- wx_type 选择”企业微信”
- wx_qy_corpid 填写企业微信后台管理中”我的企业”页面的”企业ID”
- wx_qy_agentid 填写企业微信后台的应用管理中标准运维应用的 AgentId,该应用会作为默认微信消息通知渠道
- wx_qy_corpsecret 填写企业微信后台的应用管理中标准运维应用的 Secret
1. 安装依赖包
进入 frontend/mobile/,执行以下命令安装 NPM 包
2. 打包前端资源
在 frontend/mobile/ 目录下,继续执行以下命令打包前端静态资源
3. 收集静态资源
回到项目根目录,执行以下命令收集前端静态资源到 static/weixin/ 目录下
应用打包
在 CentOS 机器上,通过 git 拉取你的标准运维定制版仓库代码后,在项目根目录下运行以下命令执行打包操作。
注意,该脚本会把项目依赖的 python 包都下载到生成的版本包中,请务必保证把项目依赖的 python 包都加入到 requirements.txt 文件中。打包完成后会在当前目录下生成一个名为 “bk_sops-当前时间串.tar.gz” 格式的文件,即版本包。
环境变量配置
标准运维首次部署默认不开启移动端,如果需要开启移动端,需要在蓝鲸”开发者中心”或者PaaS Admin配置标准运维应用的环境变量,如下图所示:
- BKAPP_USE_WEIXIN(是否开启移动端)值设置为 1
- BKAPP_IS_QY_WEIXIN(是否使用企业微信)值设置为 1
- BKAPP_WEIXIN_APP_ID(企业ID) 的值设置为企业微信后台管理中”我的企业”页面的”企业ID”
- BKAPP_WEIXIN_APP_EXTERNAL_HOST(蓝鲸外网域名) 的值设置为你部署的蓝鲸外网域名 {BK_PAAS_OUTER_HOST}
设置标准运维应用运行时的环境变量后,需要重新部署才能生效.
已授权的移动端用户首次使用标准运维前,需要在蓝鲸 PaaS 平台绑定企业微信。在蓝鲸 PaaS 平台的”个人中心”中点击头像(企业版点击”绑定微信”),通过企业微信扫描二维码绑定。在完成企业微信绑定后,请再次访问标准运维 SaaS 以便同步企业微信账号信息,然后就可以在企业微信的”工作台”访问标准运维移动版了。
蓝鲸个人中心找不到绑定企业微信入口
可能是蓝鲸消息通知渠道配置错误,请确认按照上述教程配置并保证变量值正确。
移动端打开后报错”redirect_uri需使用可信域名”
可能是企业微信后台管理中”网页授权及JS-SDK”配置错误,请设置可信域名为你部署的蓝鲸外网域名。
可能是标准运维SaaS的环境变量配置错误,请检查BKAPP_WEIXIN_APP_ID(企业ID)、BKAPP_WEIXIN_APP_SECRET(企业应用Secret)、BKAPP_WEIXIN_APP_EXTERNAL_HOST(蓝鲸外网域名)配置是否正确。
移动端打开后业务列表为空
请在蓝鲸”个人中心”绑定企业微信后,先访问一次 PC 端标准运维SaaS,并确保能访问业务数据,然后再访问移动端。