新增节点插件包括基本设置、发布到开发环境、在开发环境测试和发布到生产环境四个步骤。
背景信息
插件是节点的核心处理逻辑,目前仅支持Java语言。以ODPS SQL节点为例,您在编辑器中编写的SQL,提交运行后,会使用后台对应的插件来解析并执行。新增一个自定义节点,首先需要开发自定义插件的处理逻辑。
操作步骤
新增节点插件。
登录DataWorks控制台,单击左侧导航栏的 ,在下拉框中选择对应工作空间后单击进入数据开发。
单击页面右上方的节点配置,默认进入节点插件列表。
在节点插件列表页面,单击右上方的新增。
在请选择插件类型对话框中,选中需要新增的类型(示例为引擎型),单击确认。
插件类型包括引擎型和业务型:
引擎型:通过上传JAR或其它格式的代码包定义插件的功能,通常用于驱动自定义计算引擎。
业务型:以开发手动业务流程的方式定义插件的功能,通常用于封装多个基础节点实现特定的业务逻辑。
在基本设置页面,配置各项参数。
参数
描述
名称
插件的名称。仅支持字母、下划线(_)和数字,且以字母开头。
负责人
根据工作空间的成员进行选择。当选择其他用户时:
如果您是项目管理员,则不能编辑其他用户的自定义插件。
如果您是项目所有者,则可以编辑其他用户的插件。
资源文件
包括上传本地文件、使用OSS文件、AppStudio三种方式。
说明仅选择引擎型的插件类型时,显示该参数。
本地文件上传方式最大支持50 MB,OSS下载方式最大支持200 MB。
类名
插件实现的类的全路径名称。
说明仅选择引擎型的插件类型时,显示该参数。
参数模板
根据您上传的资源文件设计您的参数内容。
说明仅选择引擎型的插件类型时,显示该参数。
手动业务流程
单击选择手动业务流程,在下拉列表中选择需要的手动业务流程名称,单击确认。
说明仅选择业务型的插件类型时,显示该参数。
版本号
新增时,请选择使用新版本。编辑和回滚时,请选择覆盖当前版本。
版本描述
对插件进行简单描述。
单击保存后,再单击下一步。
单击保存后,您可以保存修改的配置至数据库:
如果修改的是基本信息(非插件包),您只需要保存即可生效,无需进行发布。
如果修改的是JAR包,您必须进行发布才会生效。
在发布到开发环境页面,确认内容无误后,单击提交开发环境发布,实时查看发布进度。
发布成功后,单击下一步。
在开发环境测试插件。
在在开发环境测试页面,输入参数、环境变量和代码。
单击开始测试。
确认测试结果无误后,选中已检查,确认测试通过。
单击下一步。
在发布到生产环境页面,单击提交生产环境发布,实时查看发布进度。
说明提交至生产环境的版本必须是在开发环境已经部署、测试通过的最新版本,否则生产环境会提示发布失败。
单击完成,进入插件列表。
您可以在该页面查看新建的插件,并进行配置、查看全部版本和删除等操作:
配置:单击配置后,会根据插件的状态,自动跳转至相应的页面。
查看全部版本:单击查看全部版本,在全部版本对话框中,查看、回滚或下载插件的版本,单击确认:
查看:单击后进入新增节点插件的基本信息页面。
回滚:提示使用旧版JAR和配置重新发布插件,但会更新版本号。回滚的版本号为全部版本页面中最大的版本号+1。
下载:单击下载,即可下载对应的资源文件。
删除:单击删除,在删除插件对话框中,单击确认。
重要仅支持删除没有节点关联的插件。