发布
创建/编辑 Schema
进入万事屋创建/编辑 Schema,注意前端类型选择非 fekit 编译
,其它按项目实际情况填写。
设置 build 参数
点击进入编辑界面,首先设置 build_method 为 ykit
。
注意:对于已经存在的 job,build_method 更改以后需要更新 job 才会生效(进入万事屋 job 编辑菜单,点击保存)。
将 beta
和 prod
标签下的 build_command 都设置为空。
后续字段按项目实际情况填写,如无特殊需求可不进行更改。
创建/编辑 Job
在万事屋的Job 菜单中新建/编辑 Job。YKit 对于 Job 并没有特殊的要求,按项目实际情况填写。
Build 项目
添加 Job 的 devqa 权限
首先,Job 创建后需要手动添加 Job 的执行权限才能在 Jenkins 中 Build,否则在 qdr 等平台无法执行 build 操作。
Build 前检查(重要)
确保 pom.xml 里面的artifactId
字段,已经从默认的**
改为项目名称,并且当前分支不落后于 master。
确保项目中不存在 node_modules。由于 build 机器与本地的系统和 node 版本原因,有些 node_modules 包在 build 机器版本无法正常工作。因此请不要提交 node_modules,在 ykit 编译之前会进行模块安装。**建议在项目中添加 yarn.lock 或者 npm-shrinkwrap 来控制模块版本,否则可能会造成编译结果与预期不符(详见 [shrinkwrap 文档][3])。
开始 Build
在 Jenkins 刚刚创建的 Job 页面中,选择 Build with Parameters。如果是分支开发方式,需要在tag_name
字段填写分支号,其它参数按项目需求填写即可。
如何使用 beta 环境变量
在 ykit 中允许使用 beta 环境变量来区分 beta 和线上环境。在使用前请了解这可能导致未经测试的代码上线而带来风险。
- 首先确保你的工程中
@qnpm/ykit-config-qunar
或@qnpm/ykit-config-fekit
版本在 0.8.0 或以上。 - 在
package.json
中添加enableBeta
字段并置为 true。
好了,此时你可以在 ykit.js 的 this.env 中获取到 beta 环境变量了(在进行 beta 发布时)。具体环境变量的使用可以参考这里。