确认与发布工作流方案¶
对接工作流编辑器的应用在用户审阅通过后,可确认采用服务端保存的候选方案,并将其发布为可运行的工作流。
任务流程¶
确认调用使用同一方案的任务 ID、产物 ID 与提案 ID 生成已接受记录;发布调用将该接受记录部署为工作流并返回工作流 ID。
任务 ID + 候选产物 ID + 确认提案 ID + 幂等键
│
▼
确认采用候选方案
│
▼
已接受方案记录
│
▼
发布工作流并取得工作流 ID
准备¶
已完成 使用 SDK 中的服务地址、个人访问令牌与工作区配置。
待确认方案引用(
TASK_ID、ARTIFACT_ID、PROPOSAL_ID):从同一工作流生成任务或历史恢复结果中保存该方案的任务 ID、候选产物 ID 和确认提案 ID(前置流程见 测试与提交工作流项目 或 查看与恢复工作流历史),确认前先核对该方案的编译与测试结果。确认幂等键(
ACCEPT_KEY):为本次确认操作生成并保存唯一幂等标识;网络结果未明时继续复用原幂等键重试。
确认并发布方案¶
使用服务端保存的方案引用与确认信息接受候选并提交发布。发布前先核对原生成任务绑定的目标工作流:若方案已绑定已有工作流,即使发布调用中的工作流 ID 参数留空,服务端仍会更新该绑定工作流;若显式传入工作流 ID,其值必须与绑定目标一致。未绑定已有工作流的方案在工作流 ID 留空时执行首次发布(或重放同一次发布)。
import os
import moi_product_sdk as sdk
client = sdk.new_with_personal_access_token(
os.environ["PRODUCT_API_BASE_URL"], os.environ["PRODUCT_API_KEY"]
)
workspace = client.workspace(os.environ["WORKSPACE_ID"])
accepted = workspace.accept_workflow_candidate(
sdk.WorkflowCandidateRef(
task_id=os.environ["TASK_ID"], artifact_id=os.environ["ARTIFACT_ID"]
),
sdk.WorkflowCandidateConfirmation(
proposal_id=os.environ["PROPOSAL_ID"], idempotency_key=os.environ["ACCEPT_KEY"]
),
)
workflow, deployment = workspace.deploy_workflow_candidate(
"Document processing", accepted, "",
sdk.with_workflow_execution_mode("one_shot"),
)
print("Workflow:", workflow.id)
print("Warnings:", deployment.warnings)
package main
import (
"context"
"fmt"
"os"
sdk "github.com/matrixorigin/matrixflow/sdk/go-sdk"
)
func main() {
ctx := context.Background()
client, err := sdk.NewWithPersonalAccessToken(
os.Getenv("PRODUCT_API_BASE_URL"),
os.Getenv("PRODUCT_API_KEY"),
)
if err != nil {
panic(err)
}
workspace, err := client.Workspace(os.Getenv("WORKSPACE_ID"))
if err != nil {
panic(err)
}
ref := sdk.WorkflowCandidateRef{
TaskID: os.Getenv("TASK_ID"),
ArtifactID: os.Getenv("ARTIFACT_ID"),
}
confirmation := &sdk.WorkflowCandidateConfirmation{
ProposalId: os.Getenv("PROPOSAL_ID"),
IdempotencyKey: os.Getenv("ACCEPT_KEY"),
}
accepted, err := workspace.AcceptWorkflowCandidate(ctx, ref, confirmation)
if err != nil {
panic(err)
}
workflow, deployment, err := workspace.DeployWorkflowCandidate(
ctx,
"Document processing",
accepted,
"",
sdk.WithWorkflowExecutionMode("one_shot"),
)
if err != nil {
panic(err)
}
fmt.Println("Workflow:", workflow.ID())
fmt.Println("Warnings:", deployment.GetWarnings())
}
完整保留服务端返回的接受记录并原样传入发布调用;服务端在发布时会重新解析其中的方案引用及绑定目标。若发布阶段失败,保留已取得的接受记录,修正发布配置后重新调用发布接口,随后保存返回的工作流 ID。
下一步¶
最后更新于