在IaC代码中定义流水线

在哪里定义流水线

component间的编排在spec包中的meta.yaml文件中描述，涉及applyPipeline/pipelines两个字段。pipelines中支持定义多个流程，applyPipeline描述本次变更要使用的流程。pipeline能力丰富，通过设计pipeline可以实现精巧的多阶段部署、部分变更、主动暂停等复杂场景的变更编排。

图1 meta.yaml

如何定义流水线

meta.yaml文件涉及applyPipeline/pipelines两个字段。pipelines中支持定义多个流程，applyPipeline描述本次变更要使用的流程。pipeline能力丰富，通过设计pipeline可以实现精巧的多阶段部署、部分变更、主动暂停等复杂场景的变更编排。

样例如下：

type: WiseCloud::Environment      # 保留字，声明这是一个针对环境的IAC代码
applyPipeline: default            # 代码中指定的默认pipeline，指定的pipeline必须是在pipelines中声明的
pipelines:                        # 列表，可以定义多个pipeline，并在执行任务时选择
  - name: default                 # pipeline名称
    action: Serial                # 此pipeline执行任务的策略 Serial（串行）/ Parallel（并行）
    tasks:                        # 声明流水线的子任务，通过声明pipeline的任务，实现对资源部署流程的编排
      - name: apply-chaosmonkey-stage1
        action: Serial
        tasks:
          - name: deploy
            action: Serial
            tasks:
              - name: apply-chaosmonkey-por
                action: Apply
                component:
                  name: WiseEyeChaosMonkeyPortal
  - name: all
    action: Serial
    tasks:
      - name: apply-chaosmonkey-stage1
        action: Serial
        tasks:
          - name: deploy
            action: Serial
            tasks:
              - name: apply-chaosmonkey-por
                action: Apply
                component:
                  name: WiseEyeChaosMonkeyPortal
      - name: apply-chaosmonkey-stage2
        action: Serial
        tasks:
          - name: deploy
            action: Serial
            tasks:
              - name: apply-chaosmonkey-mgr
                action: Apply
                component:
                  name: WiseEyeChaosMonkeyMgrService

pipeline的任务声明

name/action都是一个流水线的基本信息，任务的编排是需要声明不同类型的task实现；当前支持的任务类型包括：Serial（串行）/Parallel（并行）/Apply（声明式任务执行），其中，Serial/Parallel不涉及资源部署，我们仅通过此类任务将需要部署的资源串联起来，从而环境变更的过程。如果把pipeline比作一棵树的声明，那么所有tasks都是这棵树的子节点，Apply是这棵树的叶子节点，只有叶子节点被执行时才会对环境产生影响。

图2 pipeline任务声明

• Serial（串行）/Parallel（并行）任务定义

  定义Serial（串行）/Parallel（并行）任务将环境的资源变更流程串联起来。

  • Serial，串行执行，其参数tasks下的子任务会根据定义的顺序依次执行。
  • Parallel，并行行执行，其参数tasks下的子任务会同时执行。

  - name: deploy    # 任务名称
    action: Serial  # 此任务下其子任务的执行策略 Serial（串行）/ Parallel（并行）
    tasks:          # 子任务，必填，子任务可以是任意类型的的任务；
      - name: apply-chaosmonkey-mgr
        action: Apply
        component:
          name: WiseEyeChaosMonkeyMgrService

• Apply（声明式任务执行）任务定义

  我们可以通过定义Apply类型的任务声明一个环境的资源，这些资源可以是NuwaContainer，数据库，配置等等；

  - name: apply-chaosmonkey-por      # 任务名称
    action: Apply                    # 任务类型
    inform:                          # 执行后通知配置
      message: finish stage2 notification
    confirm:                         # 执行前确认配置
      message: pause before execute task
    component:                       # 需要执行变更的component
      name: WiseEyeChaosMonkeyPortal # component名称
      resources:                     # component下需要执行变更的资源
        - name: por-nghbfcj1
          type: WiseCloud::MicroService::NuwaContainer #
          properties:
            grayStage:
              grayInstances: 100    # 灰度百分比
              grayStatus: 2         # 表灰度
              grayProcess: FINISHED # 表完成

任务的数据结构在设计上支持了无限层级嵌套，配合action属性可以实现任意的任务串并行编排。