管理流水线

流水线配置

流水线配置主要包括流水线触发方式、流水线执行环境、资源描述YAML、钉钉机器人通知四个配置项，其中只有流水线触发方式、流水线执行环境可以在创建应用、创建环境阶段进行配置，这四项都可以在创建成功后单击编辑按钮配置。

流水线触发方式

应用中心支持用户自定义触发流水线的Git事件。应用中心通过Webhook来接收Git事件，当接收到满足触发规则的事件时，将按照用户配置的流水线YAML创建并执行流水线。当前支持的触发方式如下：

• 分支触发：需要环境关联指定分支，匹配指定分支所有的Push事件。

• Tag触发：匹配指定Tag表达式的所有Tag创建事件。

• 分支合并触发：匹配指定来源分支到环境所关联的目标分支的Merge/Pull Request合并事件。

流水线执行环境

流水线执行环境分为默认执行环境和专有执行环境两种模式。

默认执行环境

默认执行环境下，流水线的资源由平台完全托管，由阿里云函数计算为您承担流水线执行过程中的费用成本，您无需付出任何费用。流水线的每个任务都会运行在独立安全沙箱环境中，平台会保证您的流水线执行环境的安全隔离。默认执行环境的使用限制如下：

• 实例资源规格：4vCPU、8GB内存。

• 临时磁盘空间：10 GB。

• 任务执行超时：15分钟。

• 地域限制：模板直接部署、GitHub代码源使用海外新加坡地域，Gitee、公网GitLab、Codeup使用中国杭州地域。

• 网络限制：不支持固定IP地址以及网段，不支持IP白名单方式访问指定网站，不支持访问您的VPC内的资源。

专有执行环境

专有执行环境会将流水线任务在用户的账号下执行，提供更多自定义的能力。应用中心会根据用户的授权完全代管专有执行环境的任务，实时在用户账户下调度函数计算实例运行流水线。和默认执行环境类似，专有执行环境提供完全Serverless化的能力，用户无需运维基础设施。

通过专有执行环境，您可以使用如下自定义能力：

• 地域及网络：您可以指定执行环境的地域以及VPC，实现访问内网代码仓库、制品仓库、镜像仓库、Maven私服等场景。支持的地域请参见开服地域。

• 实例资源规格：您可以指定执行环境的CPU、内存规格。例如，指定更大规格的实例来加快构建速度。

  说明

  vCPU大小（单位为核）与内存大小（单位为GB）的比例必须设置在1:1到1:4之间。

• 持久化存储：您可以指定NAS挂载以及OSS挂载配置。例如通过NAS挂载来进行文件缓存，实现加速构建的效果。

• 日志：您可以指定SLS的日志项目和日志仓库，实现流水线执行日志的持久化。

• 超时时间：您可以自定义流水线任务的执行超时。默认为600秒，最长为86400秒。

资源描述YAML

Serverless应用中心和ServerlessDevs开发者工具进行了深度集成，你可以通过ServerlessDevs的资源描述文件来声明业务的资源配置。关于资源描述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

钉钉机器人通知

开启该配置后，需要配置钉钉机器人的Webhook地址、加签密钥、通知规则以及自定义消息等。您可以在此集中管理需要通知的任务，也可以通过流水线YAML对各个任务分别开启通知。在此处完成通知的整体配置后，您也可以进一步在流水线详情中进行各个任务的通知细化配置。

流水线环境变量

在流水线环境变量区域，点击编辑，选择配置环境的方式，按照下方步骤完成配置，然后单击部署。

• 使用表单编辑（默认方式）

  1. 单击+添加变量。

  2. 配置环境变量的键值对：

     • 变量：自定义。

     • 值：自定义。

• 使用JSON格式编辑

  1. 单击使用JSON格式编辑。

  2. 在文本框内，输入对应的JSON格式的键值对，格式如下。

     {
         "key": "value"
     }

     示例如下。

     {
         "REGION": "MY_REGION",
         "LOG_PROJECT": "MY_LOG_PROJECT"
     }

当前环境变量会在Serverless Devs流水线中生效，可以通过${env(key)} 在s.yaml中引用，也可以通过 $Key在Shell命令中引用，示例如下。

vars:
  region: ${env(REGION)}
  service:
    name: demo-service-${env(prefix)}
    internetAccess: true
    logConfig:
      project: ${env(LOG_PROJECT)}
      logstore: fc-console-function-pre
    vpcConfig:
      securityGroupId: ${env(SG_ID)}
      vswitchIds:
        - ${env(VSWITCH_ID)}
      vpcId: ${env(VPC_ID)}

流水线详情

在流水线详情区域，您可以配置流水线流程，对流水线中的任务、任务间的关系进行详细配置。平台会自动生成默认流水线流程，您可以基于该流程进行二次编辑。

流水线通过YAML进行管理，当前提供了平台托管和仓库读取两种配置方式：

平台托管

流水线YAML默认由平台托管，即配置在平台中心化管理，更新后下次部署时生效。

仓库读取

流水线的YAML描述文件存储在远端Git仓库，在控制台中编辑保存后平台会实时向您的Git仓库提交Commit，该提交不触发流水线的执行。当您的代码仓库事件触发流水线执行时，平台使用您指定的Git仓库中的流水线YAML创建流水线并执行。

您可以在流水线详情区域上方指定仓库读取，输入YAML的文件名。如下图所示。

流水线详情区域的主体由左侧的辅助工具区与右侧的YAML编辑区构成：

• YAML编辑区：您可以直接对流水线YAML进行编辑，来实现对流水线流程的修改，参考使用YAML文件描述流水线。

• 辅助工具区：提供了针对YAML编辑的辅助工具，包含：

  • 流程预览：提供了对流水线流程的可视化预览与简单编辑能力。

  • 任务模板：提供了一系列常用的任务YAML模板。

区域右上角有保存、全屏模式、重置三个按钮：

• 保存按钮会保存页面中对YAML的更改，并同步到流水线YAML中。

• 全屏模式按钮可以将主题编辑区域放大到全屏操作。

• 重置按钮则将取消从上次保存YAML之后的所有更改，退回初始状态。

查看流水线执行历史

您可以点击具体的流水线执行版本，查看当前流水线历史的具体信息。通过此信息，可以快速地查看流水线的执行日志以及状态等，便于掌握流水线的执行情况或排查问题。

升级流水线构建环境运行时

您可以使用流水线runtime-setup插件或者修改资源描述文件环境变量的方式来设置流水线运行时版本。