快速发布TPP方案

创建方案

操作步骤

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)

例如:您可以指定模拟用户信息

image

场景调试

参见快速创建场景章节,调试时使用方案代码的最新发布版本(包含预发版本)、按分流规则进入AB实验,使用AB实验的配置(优先级:AB实验的配置>默认配置优先级)。