管理流水线

流程预览

流程预览区域提供对流水线流程的可视化预览能力，并支持对任务基本内容、任务间关系的简单编辑，支持对模板任务的快捷创建添加。流程图节点主要分为三类，起始的代码源与触发方式节点、结束节点、任务节点。节点之间有表示依赖关系的连线连接。当鼠标移到任务节点上，会显示新建任务按钮和删除任务按钮，用于便捷地进行任务增删。

• 代码源与触发方式节点（开始节点）

  用于显示当前流水线代码源信息与触发方式，此处只作显示不支持编辑。如果您要修改流水线触发方式，可以到流水线配置中进行修改。

  重要

  如果需要修改代码仓库，请在应用详情处进行修改。具体操作，请参见管理应用。修改代码仓库后，会涉及到所有流水线的失效，请谨慎操作。

• 结束节点

  标志流水线流程的终点，流水线中的任务至此全部完成。该节点只读，不可编辑，无实际含义。

• 任务节点

  用于显示与维护指定任务的基本信息。任务节点默认显示任务名称，单击节点会弹出气泡框，用于查看和编辑任务名称、前置任务、是否开启任务等基本信息。如果选择不开启任务，则该任务会在执行时被自动跳过，并显示为灰色。

• 依赖关系

  反映任务之间关系的单向箭头。若箭头由任务A指向任务B，则代表A是B的前置任务，B依赖A，A被B依赖，B为依赖方，A为被依赖方。每个任务都可以被多个任务依赖，也可以依赖多个任务。

  依赖关系可以通过编辑被依赖方的前置任务来进行更改。例如，想取消B对A的依赖，可以单击B的任务节点，将A从B的前置任务中移除。

• 新建任务

  该按钮表现为“＋”图标，分别存在于任务节点的上、下、右三个方位。单击任务A的上方新建任务按钮，会创建一个A的前置任务B，A依赖B；单击任务A的下方新建任务按钮，会创建一个A的后继任务C，C依赖A，A是C的前置任务；点击任务A的右侧新建任务按钮，会创建一个A的兄弟任务D，D具有和A相同的依赖关系，即D和A有相同的前置任务，且所有依赖A的任务也都依赖D。

• 删除任务

  该按钮表现为“×”图标，存在于任务节点右上角，用于删除被选中的任务。平台会进行二次确认避免误删除。

任务模板

任务模板提供了一系列常用的流水线任务的YAML模板，包含代码检查、构建、部署、通用等四种任务的YAML模板，任务内部的高级配置YAML模板，以及任务插件的YAML模板。

您可以在模板列表中选择您所需要的模板，点击后可以查看模板的详细介绍和YAML内容，并将YAML内容复制粘贴到流水线YAML中的对应位置。

默认流水线流程

流水线的默认流程包含线上配置比对、人工审核、构建与部署三个任务，这三个任务依次执行。其中，人工审核默认不开启，需要手动开启。

• 线上配置比对

  判断流水线所涉及到的资源描述文件与线上配置内容是否一致，便于提前发现非预期的配置变化。

• 人工审核

  为确保应用的安全发布以及保障发布后的稳定，可以在此阶段开启人工审核机制，当流水线走到此处将被阻塞，并等待人工审核确认。只有人工审核通过后才能继续进行后续操作，否则将终止当前流水线。该任务默认不开启，需要手动开启。

• 构建与部署

  进行应用构建并将应用部署到云上，默认进行全量部署。

在流水线中指定s.yaml

Serverless开发平台和ServerlessDevs开发者工具进行了深度集成，您可以通过ServerlessDevs的资源描述文件来声明业务的资源配置。以阿里云函数计算FC为例，关于FC资源描述YAML的规范，请参见ServerlessDevs YAML规范。默认的资源描述文件名为s.yaml，您也可以指定其他文件名。指定资源描述文件后，在流水线中有两种使用方式：

• 当使用部署插件@serverless-cd/s-deploy时，插件执行时会自动使用指定的资源描述文件进行部署，执行的原理是在Serverless Devs的操作指令中增加-t/--template命令。下面的示例，指定的资源描述YAML文件为demo.yaml，插件执行的命令就是s deploy -t demo.yaml。

- name: deploy
  context:
    data:
      deployFile: demo.yaml
      steps:
      - plugin: '@serverless-cd/s-setup'
      - plugin: '@serverless-cd/checkout'
      - plugin: '@serverless-cd/s-deploy'
  taskTemplate: serverless-runner-task

• 当使用脚本方式执行时，可以通过${{ ctx.data.deployFile }}来引用具体的资源描述文件名。例如下面的示例，效果是当指定了资源描述文件时就使用指定文件执行s plan命令，否则使用默认的s.yaml执行s plan命令。

- name: pre-check
  context:
    data:
      steps:
      - run: s plan -t ${{ ctx.data.deployFile || s.yaml }}
      - run: echo "s plan finished."
  taskTemplate: serverless-runner-task