创建方案
操作步骤
1.登录个性化算法开发平台控制台。
2.在左侧导航栏,单击“个性化算法开发平台->实例列表”。
3.在顶部菜单栏,选择要查看的实例所在的目标区域。
4.单击实例ID链接,单击方案管理菜单,在右侧对话框中单击“创建方案”。
在弹出的页面中,填充方案基础信息,基础信息说明参见下表:
参数 | 说明 |
基于现有方案克隆 | 即支持您基于一个已有方案快速克隆,会同时克隆方案基础信息以及方案配置。 如果您是首次创建方案,请勿勾选。 |
方案名称 | 方案展示名称。 |
代码源 | 暂时只支持阿里云云效Codeup,后续考虑支持更多的代码源 |
仓库地址 | 即代码库地址。 |
分支 | 分支名称。 |
Git账号 | 即云效个人设置中填写的HTTPS密码的账号 |
Git密码 | 即云效个人设置中填写的HTTPS密码的密码 |
方案目录名称 | 代码库中的方案代码所在的子目录。 |
6.单击确定,完成方案创建。
方案代码发布
预发环境发布
方案正式上线之前,建议客户现在预发进行调试,预发环境调试通过之后,再部署到正式环境,降低试错成本。
操作步骤
1.登录个性化算法开发平台控制台。
2.在左侧导航栏,单击“个性化算法开发平台->实例列表”。
3.在顶部菜单栏,选择要查看的实例所在的目标区域。
4.单击实例ID链接,单击方案管理菜单,在右侧页面中选择您所需要的方案,进入方案详情。
5.单击左侧“发布”菜单,右侧页面展开发布流程,单击“预发发布”,触发预发发布流程。
说明:发布过程中可以随时通过单击“取消发布"中止发布流程或者重新发布触发发布重新执行。
6.如果发布过程中没出现编译错误或者发布异常,发布流程的“编译”、“预发部署“节点将会自动完成,并且将发布流程推进到预发测试环节,你可以单击“预发测试”跳转到预发测试页面进行测试。
7.调试通过后,您可以单击“测试通过”,推进发布流程,发布准入节点校验通过后,单击“进入正式”,进入线上环境部署环节。
正式环境发布
操作步骤
1.登录个性化算法开发平台控制台。
2.在左侧导航栏,单击“个性化算法开发平台->实例列表”。
3.在顶部菜单栏,选择要查看的实例所在的目标区域。
4.单击实例ID链接,单击方案管理菜单,在右侧页面中选择您所需要的方案,进入方案详情。
5.单击左侧“发布”菜单,单击“代码线上”tab,预发发布进入正式之后就会在线上环境生成一个待发布的版本。
6.单击“正式发布”,触发正式发布流程,当没有扫描出问题时,发布流程会自动推进到正式部署节点。
7.TPP支持业务级别灰度,即在正式部署的时候,您可以选择您想要发布的实验进行发布,选择实验结束之后,单击“发布”,设置发布策略,您可以按需选择发布策略,一般建议选择“第一批结束后暂停”,这样在首批发布
之后发布会自动暂停,等待您完成业务以及流量指标的确认,以后再继续发布。
说明:正式部署过程中,您可以单击发布单上的“暂停发布”以及“取消发布”,来中断当前或者终止当前发布。
8.重复步骤7直到您的所有实验发布完成。
方案配置发布
您可以将需要用来实验的参数,抽象为方案的配置。在不同环境或者不同规则下,TPP可以获取到同一配置项的不同取值,方便您用来进行配置实验或者配置灰度(是否需要配置方案默认配置取决于您后续是否要进行配置实验,如果不需要配置实验,您可以不配置方案默配置)。
不同类型配置如下:
配置类型 | 说明 |
方案默认配置 | 配置项需要在跟随方案声明,你可以在方案声明中设置缺省值。配置项加上配置项缺省值 即方案的默认配置。当同一个请求命中多层配置时,方案的默认配置值优先级最低。 |
方案预发环境配置 | 在预发环境上,方案配置取值。一般用于方案的预发调试。预发环境配置值优先级高于 方案的默认配置值。 |
AB实验配置 | AB实验粒度的配置取值,用于进行配置实验。在预发环境下,AB实验配置值优先级高于预发环境配置值。在正式环境,AB实验配置值优先级高于方案默认配置。 |
场景预发绑定配置 | 一个场景只有一套预发环境,所以当一个场景在进行多个代码实验,需要进行代码实验预发环境 调试时,需要进行场景预发绑定。场景预发绑定配置值优先级高于方案默认配置,低于AB实验配置。 当您在预发环境下,请求只指定了场景ID没有指定ABID时,生效的优先级预发绑定配置值高于方案默认配置,如果指定了ABID,生效的即为AB实验配置值。 |
方案默认配置发布
操作步骤
1.登录个性化算法开发平台控制台。
2.在左侧导航栏,单击“个性化算法开发平台->实例列表”。
3.在顶部菜单栏,选择要查看的实例所在的目标区域。
4.单击实例ID链接,单击方案管理菜单,在右侧页面中选择您所需要的方案,进入方案详情。
5.单击左侧“配置管理”菜单,根据页面引导创建方案默认配置。
6.单击“新增默认配置”,配置方案默认配置,配置参数说明如下:
配置参数 | 说明 |
key | 配置项名称,用来识别配置项的主键。 |
数据类型 | 配置项的数据类型,用来约束校验配置取值。 |
预发值 | 方案配置在预发环境的取值。 |
方案默认值 | 配置项需要在跟随方案声明,你可以在方案声明中设置缺省值。配置项加上配置项缺省值 即方案的默认配置。当同一个请求命中多层配置时,方案的默认配置值优先级最低。 |
7.完成方案默认配置后,单击“发布配置”,提交方案默认配置发布,带提交发布后,单击“提交”,触发方案默认配置发布流程。
8.待方案配置发布流程推进到正式部署节点后,单击“开始部署”,配置发布策略,建议进行分批发布。
9.等待分批逐步发布完毕,当首批发布暂停时,您可以单击继续发布推进部署进度,直到发布完成。
方案预发环境配置
操作步骤
1.登录个性化算法开发平台控制台。
2.在左侧导航栏,单击“个性化算法开发平台->实例列表”。
3.在顶部菜单栏,选择要查看的实例所在的目标区域。
4.单击实例ID链接,单击方案管理菜单,在右侧页面中选择您所需要的方案,进入方案详情。
5.单击左侧“配置管理”菜单,单击“编辑预发配置”。
6.修改预发环境配置值,并且提交发布。
预发调试
tpp支持场景以及方案的预发调试,调试说明如下:
方案调试
调试时使用方案代码的最新发布版本(包含预发版本)、使用方案的配置(优先级:预发配置>默认配置优先级),不支持指定场景ID和abid。
代码 | 使用方案代码的最新发布版本, 包括【预发版本】。 | 例如:当前方案发布,已经部署到预发(预发是版本B),还未部署到正式(正式是版本A),这时调试的代码是版本B。 |
配置 | 使用方案自己的配置, 和场景、AB实验无关 | 优先级: 预发配置>默认配置 |
调试请求参数 | 可以设置调试请求参数,请求参数不支持指定appid(场景ID)、abId(ab实验ID) | 例如:您可以指定模拟用户信息 |
场景调试
参见快速创建场景章节,调试时使用方案代码的最新发布版本(包含预发版本)、按分流规则进入AB实验,使用AB实验的配置(优先级:AB实验的配置>默认配置优先级)。