Workflow Editor

After configuring the Build Configurations and Base Configurations, the next step is to create a workflow using the Workflow Editor.

In Devtron, a Workflow is a logical sequence of different stages(pipelines) used for continuous integration and continuous deployment of an application.

Figure 1: Workflow Editor

Create Workflow

The Build and Deploy from Source Code provides a simple way to create both CI and CD pipelines in one step. It is for users who want to set up a complete workflow quickly using minimal required information, such as the source repository branch and the target environment.

To create a quick workflow with both build and deployment pipelines, follow the steps below:

  1. Click New Workflow in the workflow editor.

    Figure 2: Selecting 'New Workflow'
  2. Select Build and Deploy from Source Code; a window appears.

    Figure 3: Selecting 'Build and Deploy from Source Code'
  3. Enter the required information in the following fields.

Field Name
Required/Optional
Description

Source type

Required

Source type to trigger the CI. Available options: Branch Fixed, Branch Regex, Pull Request, Tag Creation

Branch Name

Required

Branch that triggers the CI build

Environment

Required

Select the environment where you want to deploy your application

Namespace

Required (Auto Filled)

Automatically populated based on the selected environment

Figure 4: Entering Information

Source Types

Source Type
Description
Additional Requirements

Branch Fixed

Triggers a CI build whenever changes are pushed to a specified branch.

Requires a predefined branch name.

Branch Regex

Allows dynamic branch selection based on a regex pattern

Requires a regex pattern to be defined. For example, if the user sets the Branch Regex as feature-*, then users can trigger the build from branches such as feature-1450, feature-hot-fix, etc..

Pull Request (PR)

Triggers a CI build when a new pull request is created. You can also define filters (such as PR author, title, or branch) to control which pull requests trigger the pipeline.

Requires configuring a webhook configuration for GitHub or Bitbucket.

Tag Creation

Triggers a build whenever a new tag is created. You can also define filters (such as author and tag name) to control which tags trigger the pipeline.

Requires webhook configuration for GitHub or Bitbucket.

  1. Click Create Workflow; a workflow with both build and deployment pipelines will be created.

    Figure 5: Clicking 'Create Workflow'
  2. If you want to configure advanced configurations in the build pipeline, such as Custom image tag pattern, Vulnerability Scanning, etc., refer to the CI Pipeline page to learn more.

  3. If you want to configure advanced configurations in the deployment pipeline, such as adding pre/post tasks, Custom image tag pattern, configure different deployment strategies, etc., refer to the CD Pipeline page to learn more.

  4. If you want, you can also add Pre/Post Tasks in both build and deployment pipelines. To do so, refer to the Pre/Post tasks page to learn more.

Types of CI Pipelines

Apart from configuring advanced options, you can create five types of CI pipelines depending on your use case.

  • Build from Source Code: Choose this option if you want Devtron to build the image of the source code.

  • Linked Build Pipeline: Choose this option if you want to use an image created by an existing CI pipeline in Devtron.

  • Deploy Image from External Service: Choose this if you want to build your image outside Devtron; it will receive a Docker image from an external source via the incoming webhook.

  • Sync with Environment

  • Create a Job

Figure 6: Selecting an Image Source

Last updated

Was this helpful?