配置服務集成
通過服務集成,您可以創建一個服務,并定義服務的入參、出參、調用的模型等信息。當服務創建成功并完成服務驗證后,您可以鎖定服務并將服務部署到對應節點中,以便對外提供服務調用。
前提條件
確保已完成服務所需模型的部署。
與發起調用的系統確認服務的出參和入參。
步驟一:創建服務
進行服務集成之前,您需要先創建服務。
登錄多方安全建模控制臺。
在左側導航欄,單擊 模型部署 > 服務集成。
在 服務集成 頁面,單擊 新建服務,完成以下配置。
參數
描述
版本編排模板
根據實際業務需求,選擇空白模板或選擇系統提供的模板。
服務名稱
設置服務名稱,命名要求如下:
由中文、英文字母、數字或下劃線組成。
長度不超過 40 個字符。
唯一標識
唯一標識由英文字母、數字或下劃線組成,且要求全局唯一。
如果已經線下約定了服務標識,則服務唯一標識為服務標識中最后一個“.”之后的部分。例如,服務標識為
dx.datalab.NODE_TEST_PREDICTION_bvyYhN7z.HB_MODEL
,則服務唯一標識為HB_MODEL
。服務描述(可選)
服務對應的描述。
版本名稱
服務的版本名稱,僅支持數字、英文字母和英文句號(.)。
版本描述
版本對應的描述。
單擊 新建,即可成功創建服務。
步驟二:編排流程
成功創建服務后,需進行流程編排。
登錄多方安全建模控制臺。
在左側導航欄,單擊 模型部署 > 服務集成。
在 服務集成 頁面,單擊指定服務名稱,再單擊指定版本號,進入服務的流程編排頁面。
編排流程。
將左側工具欄中的組件拖動到右側的畫布中,并以連線的方式串接服務流程。
說明編排流程必須以開始組件作為流程的開始,以結束組件作為流程的終止。
規則集:支持類似
CASE WHEN
語句的條件判斷規則。腳本:支持加入 Java 代碼作為變量的處理。
模型:在“模型部署”中部署成功的模型,支持在此處引用。
分叉:支持類似
IF ELSE
語句的條件判斷規則。
步驟三:驗證服務
完成服務的流程編排后,可以開始驗證服務。
在服務的流程編排頁面,單擊右上角的 驗證 > 單條驗證。
在 單條驗證 頁面,配置服務驗證信息。
決策入參:根據實際情況設置決策入參信息。
決策出參(可選):建議填寫預期的正確值,方便后續進行正確驗證時對比數值。
選擇發起調用的節點:選擇需要主動發起服務驗證的節點。
配置完成,單擊 確認。
步驟四:提交服務
在服務的流程編排頁面,單擊右上角的 提交。
在彈出的確認提交對話框中,單擊 確認。
已經提交的服務不能再編排服務流程,但仍可以在服務流程編排頁面驗證服務。
已經提交的服務如果未進行服務部署或部署后已被下線,則可以刪除服務。
步驟五:部署服務
您可以將驗證通過的服務部署到節點上,部署成功即可發起服務調用,完成模型投產。
在 服務集成 頁面,單擊指定服務名稱,再單擊指定服務版本右側的 部署。
在 服務部署 頁面,配置服務部署信息。
參數
描述
服務名稱
選擇待部署服務的名稱。
版本名稱
選擇待部署服務的版本。
部署節點
選擇作為主動方發起調用的節點,雙向調用時,需同時選擇兩個節點。
單擊 提交申請,開始部署服務。
步驟六:調整流量
當某節點上部署的同一個服務存在多個版本時,這些版本的調用接口都相同。線上調用服務時,系統會根據設置的分流比例,隨機將線上流量分發給不同版本的服務,實現服務版本的灰度調整。
在 服務集成 頁面,單擊指定服務名稱右側的 部署詳情。
在服務詳情頁面,單擊 調整分流。
調整分流的策略:當在某個節點中部署了一個服務的多個版本時,各版本的流量比例相加需為 100%。
調整完成,單擊 確定。