創建方案
操作步驟
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實驗的配置>默認配置優先級)。