Function Compute:Manage pipelines

Configure a pipeline

To configure a pipeline, you must configure the following parameters: Pipeline Trigger Mode, YAML, DingTalk Chatbot Notification Settings, and Pipeline Execution Environment. When you create an application and an environment, you can configure only the Pipeline Trigger Mode and Pipeline Execution Environment parameters. After you create an application and an environment, you can click Modify to the right of Pipeline Configurations on the Pipeline Management tab to modify the preceding four parameters.

Pipeline Trigger Mode

Serverless Application Center allows you to specify a method to trigger the Git events of the pipeline. Serverless Application Center uses webhooks to receive Git events. When an event that meets the trigger condition is received, Serverless Application Center creates and executes the pipeline based on the YAML file that you specify for the pipeline. The following trigger modes are supported:

• Triggered by branch: The environment must be associated with a specific branch and all push events in the branch are matched.

• Triggered by tag: All tag creation events of a specific tag expression are matched.

• Triggered by branch merging: Merge and pull request events from the source branch to the destination branch with which the environment is associated are matched.

Pipeline Execution Environment

You can set this parameter to Default Environment or Custom Environment.

Default Environment

If you set the Pipeline Execution Environment parameter to Default Environment, Serverless Application Center fully manages the pipeline resources and Function Compute settles the fees during pipeline execution. Each task of the pipeline runs on an independent and sandboxed virtual machine. Serverless Application Center ensures the isolation of the pipeline execution environment. The following items describe the limits that are imposed on the default environment:

• Instance specification: 4 vCPUs and 8 GB of memory.

• Temporary disk space: 10 GB.

• Task execution timeout period: 15 minutes.

• Region: If you create an environment by using a template or source code from GitHub, specify the Singapore region. If you create an environment by using Gitee, GitLab, or Codeup, specify the China (Hangzhou) region.

• Network: You cannot use fixed IP addresses or CIDR blocks. You cannot configure an IP address whitelist to access specific websites. You cannot access resources in a virtual private cloud (VPC).

Custom Environment

If you set the Pipeline Execution Environment parameter to Custom Environment, the pipeline is executed in your Alibaba Cloud account. Compared with the default environment, a custom environment provides more custom capabilities. Serverless Application Center fully manages tasks in the custom environment and schedules Function Compute instances in real time to run the pipeline based on your authorization. Similar to the default environment, a custom environment provides the serverless feature, which eliminates the need to maintain infrastructure.

Custom environments provide the following custom capabilities:

• Region and network: You can specify the region and the VPC for the execution environment to access internal code repositories, artifact repositories, image repositories, and Maven internal repositories. For information about the supported regions, see Supported regions.

• Instance specification: You can specify the CPU and memory for the execution environment. For example, you can specify an instance that has high specification to accelerate the build speed.

  Note

  The ratio of vCPU capacity to memory capacity (in GB) ranges from 1:1 to 1:4.

• Persistence storage: You can configure File Storage NAS (NAS) or Object Storage Service (OSS) mounting. For example, you can use NAS to cache files to accelerate the build speed.

• Log: You can specify a Simple Log Service project and Logstore to persist the execution logs of a pipeline.

• Timeout period: You can specify custom timeout periods for pipeline tasks. Default value: 600. Maximum value: 86400. Unit: seconds.

YAML

Serverless Application Center is integrated with Serverless Devs. You can use the YAML files of Serverless Devs to declare the resource configurations of your applications. For information about the specifications of YAML files, see YAML specifications. The default YAML file is named s.yaml. You can also specify another YAML file. After you specify the YAML file, you can use it in the pipeline by using the following methods:

• If you use the @serverless-cd/s-deploy plug-in, you can use the YAML file to deploy resources when the plug-in is executed. The execution of the plug-in is achieved by adding -t/--template to the corresponding command in Serverless Devs. In the following example, the YAML file is named demo.yaml. To execute the plug-in, run the s deploy -t demo.yaml command.

- 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

• If you execute the pipeline by using scripts, you can use ${{ ctx.data.deployFile }} to reference a specific YAML file. In the following example, the s plan command is run by using the specified file if you specify a YAML file. Otherwise, the s plan command is run by using the default s.yaml file.

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

DingTalk Chatbot Notification Settings

After you enable this feature, configure the following parameters: Webhook address, Signing key, Notify only on failure, and custom message. You can manage the tasks that require notifications in a centralized manner. You can also use the YAML file of the pipeline to enable notifications for each task. After you configure notifications, you can configure notifications for each task in the Pipeline Details section.

Pipeline Details section

In the Pipeline Details section, you can configure the tasks in the pipeline and the relationships between the tasks. The platform automatically generates a default pipeline process based on which you can modify configurations.

You can manage pipelines by using YAML. When you configure this item, you can select Hosting on Platform or Read from Repository.

Hosting on Platform

By default, the YAML files of pipelines are configured in and managed by Serverless Application Center in a centralized manner. After you update the YAML file of a pipeline, the new configurations take effect in the next deployment.

Read from Repository

The YAML file of the pipeline is stored in a Git repository. After you modify and save the configurations in the Function Compute console, Serverless Application Center commits the modifications to the Git repository in real time. This does not trigger the execution of the pipeline. When an event in your code repository triggers the execution of the pipeline, Serverless Application Center creates and executes the pipeline by using the specified YAML file in the Git repository.

You can select Read from Repository in the upper part of the Pipeline Details section and enter the name of the YAML file. The following figure shows the configurations.

The Pipeline Details section consists of a tool subsection on the left and a YAML editing subsection on the right.

• In the YAML editor, you can modify the YAML file of the pipeline to modify the pipeline process. For more information, see Use a .yaml file to describe a pipeline.

• The tool subsection provides auxiliary tools for editing YAML files. The following tabs are included in the subsection:

  • Process Preview tab: You can preview and modify the pipeline process. Process Preview tab

  • Task Template tab: You can view common YAML templates that are provided. Task Template tab

In the upper-right corner of the subsection, the Save, Fullscreen, and Reset buttons are provided.

• You can click Save to save all modifications in the YAML file. Then, all saved data is synchronized to the YAML file of the pipeline.

• You can click Fullscreen to fully display the editing subsection.

• You can click Reset to undo the most recent modifications to the YAML file.

View the execution records of a pipeline

You can click the execution version of a pipeline to view the execution details of the pipeline. Then, you can use the details to view the execution logs and status of the pipeline and troubleshoot issues.

Update the runtime of a pipeline

You can specify the runtime version of a pipeline by using the runtime-setup plug-in or modifying the variables in the YAML file.