Skip to main content
版本：v1.2

内置工作流步骤

本文档将详细介绍 KubeVela 内置的各个工作流步骤。你可以通过自由的组合它们来设计完整的交付工作流。

suspend​

简介​

暂停当前工作流，可以通过 vela workflow resume appname 继续已暂停的工作流。

有关于 vela workflow 命令的介绍，可以详见 vela cli。

参数​

无参数。

示例​

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: first-vela-workflow
  namespace: default
spec:
  components:
  - name: express-server
    type: webservice
    properties:
      image: crccheck/hello-world
      port: 8000
    traits:
    - type: ingress
      properties:
        domain: testsvc.example.com
        http:
          /: 8000
  workflow:
    steps:
      - name: slack-message
        type: webhook-notification
        properties:
          slack:
            # Slack Webhook 地址，请查看：https://api.slack.com/messaging/webhooks
            url: xxx
            message:
              text: 准备开始部署应用，请管理员审批并继续工作流
      - name: manual-approval
        type: suspend
      - name: express-server
        type: apply-application

notification​

简介​

向指定的 Webhook 发送信息，支持邮件、钉钉、Slack 和飞书。

参数​

参数名类型说明
emailObject可选值，如果需要发送邮件，则需填写其 from、to 以及 content
email.from.addressString必填值，发送的邮件地址
email.from.aliasString可选值，发送的邮件别名
email.from.passwordValueOrSecret必填值，发送的邮件密码，可以选择直接在 value 填写或从 secretRef 中获取
email.from.hostString必填值，邮件的 Host
email.from.portInt可选值，邮件发送的端口号，默认为 587
email.to[]String必填值，邮件发送的地址列表
email.content.subjectString必填值，邮件的标题
email.content.bodyString必填值，邮件的内容
slackObject可选值，如果需要发送 Slack 信息，则需填写其 url 及 message
slack.urlValueOrSecret必填值，Slack 的 Webhook 地址，可以选择直接在 value 填写或从 secretRef 中获取
slack.messageObject必填值，需要发送的 Slack 信息，请符合 Slack 信息规范
dingdingObject可选值，如果需要发送钉钉信息，则需填写其 url 及 message
dingding.urlValueOrSecret必填值，钉钉的 Webhook 地址，可以选择直接在 value 填写或从 secretRef 中获取
dingding.messageObject必填值，需要发送的钉钉信息，请符合 钉钉信息规范
larkObject可选值，如果需要发送飞书信息，则需填写其 url 及 message
lark.urlValueOrSecret必填值，飞书的 Webhook 地址，可以选择直接在 value 填写或从 secretRef 中获取
lark.messageObject必填值，需要发送的飞书信息，请符合 飞书信息规范

ValueOrSecret 的格式为：

参数名类型说明
valueString可选值，直接填写值
secretRef.nameString可选值，从 secret 中获取值，secret 的名称
secretRef.keyString可选值，从 secret 中获取值，secret 的 key

示例​

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: first-vela-workflow
  namespace: default
spec:
  components:
  - name: express-server
    type: webservice
    properties:
      image: crccheck/hello-world
      port: 8000
  workflow:
    steps:
      - name: dingtalk-message
        type: notification
        properties:
          dingding:
            # 钉钉 Webhook 地址，请查看：https://developers.dingtalk.com/document/robots/custom-robot-access
            url:
              value: <your dingtalk url>
            message:
              msgtype: text
              text:
                context: 开始运行工作流
      - name: application
        type: apply-application
      - name: slack-message
        type: notification
        properties:
          slack:
            # Slack Webhook 地址，请查看：https://api.slack.com/messaging/webhooks
            url:
              secretRef:
                name: <the secret name that stores your slack url>
                key: <the secret key that stores your slack url>
            message:
              text: 工作流运行完成

webhook​

简介​

向指定 Webhook URL 发送请求，若不指定请求体，则默认发送当前 Application。

参数​

参数名类型说明
urlValueOrSecret需要发送的 Webhook URL，可以选择直接在 value 填写或从 secretRef 中获取
dataobject需要发送的内容

示例​

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: first-vela-workflow
  namespace: default
spec:
  components:
  - name: express-server
    type: webservice
    properties:
      image: crccheck/hello-world
      port: 8000
  workflow:
    steps:
      - name: express-server
        type: apply-application
      - name: webhook
        type: webhook
        properties:
          url:
            value: <your webhook url>

apply-application​

简介​

部署当前 Application 中的所有组件和运维特征。

该步骤默认在 VelaUX 中隐藏。

参数​

无需指定参数，主要用于应用部署前后增加自定义步骤。

示例​

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: first-vela-workflow
  namespace: default
spec:
  components:
  - name: express-server
    type: webservice
    properties:
      image: crccheck/hello-world
      port: 8000
  workflow:
    steps:
      - name: express-server
        type: apply-application

apply-component​

简介​

部署当前 Application 中的某个组件及其运维特征

该步骤默认在 VelaUX 中隐藏。

参数​

参数名类型说明
componentstring需要部署的 component 名称

示例​

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: first-vela-workflow
  namespace: default
spec:
  components:
  - name: express-server
    type: webservice
  workflow:
    steps:
      - name: express-server
        type: apply-component
        properties:
          component: express-server

depends-on-app​

简介​

等待指定的 Application 完成。

该步骤默认在 VelaUX 中隐藏。

depends-on-app 会根据 properties 中的 name 及 namespace，去查询集群中是否存在对应的应用。

如果应用存在，则当该应用的状态可用时，才会进行下一个步骤； 若该应用不存在，则会去查询同名的 configMap，从中读取出应用的配置并部署到集群中。

若应用不存在，则需要形如下的 configMap：name 与 namespace 和 properties 中声明的保持一致，在 data 中，以 name 为 key，实际的 value 为需要部署的 KubeVela Application yaml。

apiVersion: v1
kind: ConfigMap
metadata:
  name: myapp
  namespace: vela-system
data:
  myapp: ...

参数​

参数名类型说明
namestring需要等待的 Application 名称
namespacestring需要等待的 Application 所在的命名空间

示例​

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: first-vela-workflow
  namespace: default
spec:
  components:
  - name: express-server
    type: webservice
    properties:
      image: crccheck/hello-world
      port: 8000
  workflow:
    steps:
      - name: express-server
        type: depends-on-app
        properties:
          name: another-app
          namespace: default

deploy2env​

简介​

将 Application 在不同的环境和策略中部署。

参数​

参数名类型说明
policystring需要关联的策略名
envstring需要关联的环境名

示例​

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: multi-env-demo
  namespace: default
spec:
  components:
    - name: nginx-server
      type: webservice
      properties:
        image: nginx:1.21
        port: 80

  policies:
    - name: env
      type: env-binding
      properties:
        created: false
        envs:
          - name: test
            patch:
              components:
                - name: nginx-server
                  type: webservice
                  properties:
                    image: nginx:1.20
                    port: 80
            placement:
              namespaceSelector:
                name: test
          - name: prod
            patch:
              components:
                - name: nginx-server
                  type: webservice
                  properties:
                    image: nginx:1.20
                    port: 80
            placement:
              namespaceSelector:
                name: prod

  workflow:
    steps:
      - name: deploy-test-server
        type: deploy2env
        properties:
          policy: env
          env: test
      - name: deploy-prod-server
        type: deploy2env
        properties:
          policy: env
          env: prod

apply-object​

简介​

部署 Kubernetes 原生资源，该功能在 KubeVela v1.1.4 及以上版本可使用。

该步骤默认在 VelaUX 中隐藏。

参数​

参数名类型说明
valueobject必填值，Kubernetes 原生资源字段
clusterobject可选值，需要部署的集群名称。如果不指定，则为当前集群。在使用该字段前，请确保你已经使用 vela cluster join 纳管了你的集群

示例​

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: server-with-pvc
  namespace: default
spec:
  components:
  - name: express-server
    type: webservice
    properties:
      image: crccheck/hello-world
      port: 8000
      volumes:
        - name: "my-pvc"
          type: "pvc"
          mountPath: "/test"
          claimName: "myclaim"

  workflow:
    steps:
      - name: apply-pvc
        type: apply-object
        properties:
          # Kubernetes 原生字段
          value:
            apiVersion: v1
            kind: PersistentVolumeClaim
            metadata:
              name: myclaim
              namespace: default
            spec:
              accessModes:
              - ReadWriteOnce
              resources:
                requests:
                  storage: 8Gi
              storageClassName: standard
            # 需要部署的集群名称，如果不指定，则默认为当前集群
            cluster: <your cluster name>  
      - name: apply-server
        type: apply-component
        properties:
          component: express-server

read-object​

简介​

读取 Kubernetes 原生资源，该功能在 KubeVela v1.1.6 及以上版本可使用。

该步骤默认在 VelaUX 中隐藏。

参数​

参数名类型说明
apiVersionString必填值，资源的 apiVersion
kindString必填值，资源的 kind
nameString必填值，资源的 name
namespaceString选填值，资源的 namespace，默认为 default
clusterString选填值，资源的集群名，默认为当前集群，在使用该字段前，请确保你已经使用 vela cluster join 纳管了你的集群

示例​

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: read-object
  namespace: default
spec:
  components:
  - name: express-server
    type: webservice
    properties:
      image: crccheck/hello-world
      port: 8000
  workflow:
    steps:
    - name: read-object
      type: read-object
      outputs:
        - name: cpu
          valueFrom: output.value.data["cpu"]
        - name: memory
          valueFrom: output.value.data["memory"]
      properties:
        apiVersion: v1
        kind: ConfigMap
        name: my-cm-name
        cluster: <your cluster name>
    - name: apply
      type: apply-component
      inputs:
        - from: cpu
          parameterKey: cpu
        - from: memory
          parameterKey: memory
      properties:
        component: express-server

export2config​

简介​

导出数据到 ConfigMap，该功能在 KubeVela v1.1.6 及以上版本可使用。

该步骤默认在 VelaUX 中隐藏。

参数​

参数名类型说明
configNameString必填值，ConfigMap 的名称
namespaceString选填值，ConfigMap 的 namespace，默认为 context.namespace
dataMap必填值，需要导出到 ConfigMap 中的数据

示例​

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: export-config
  namespace: default
spec:
  components:
  - name: express-server
    type: webservice
    properties:
      image: crccheck/hello-world
      port: 8000
  workflow:
    steps:
      - name: apply-server
        type: apply-component
        outputs: 
          - name: status
            valueFrom: output.status.conditions[0].message
        properties:
          component: express-server
      - name: export-config
        type: export-config
        inputs:
          - from: status
            parameterKey: data.serverstatus
        properties:
          configName: my-configmap
          data:
            testkey: testvalue

export2secret​

简介​

导出数据到 Secret，该功能在 KubeVela v1.1.6 及以上版本可使用。

该步骤默认在 VelaUX 中隐藏。

参数​

参数名类型说明
secretNameString必填值，Secret 的名称
namespaceString选填值，Secret 的 namespace，默认为 context.namespace
dataMap必填值，需要导出到 Secret 中的数据

示例​

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: export-secret
  namespace: default
spec:
  components:
  - name: express-server
    type: webservice
    properties:
      image: crccheck/hello-world
      port: 8000
  workflow:
    steps:
      - name: apply-server
        type: apply-component
        outputs: 
          - name: status
            valueFrom: output.status.conditions[0].message
        properties:
          component: express-server
      - name: export-secret
        type: export-secret
        inputs:
          - from: status
            parameterKey: data.serverstatus
        properties:
          secretName: my-secret
          data:
            testkey: testvalue