Brainboard's documentation
Go to the app ↗
  • Welcome
  • Getting started
    • Fast track
    • Start with a template
    • Start with AI
    • Use cases videos
    • Brainboard philosophy
  • Cloud design
    • Left bar
      • Cloud resources
      • Input & output
    • Design area
      • Node
      • ID card
      • Connectors
      • Versioning
      • Graphical options
    • One action
    • Code Edition
  • Data
    • Data structure
      • Project
      • Environment
      • Cloud architecture
        • Terraform files
        • Readme file
        • Architecture Synchronization
        • Remote backend
      • Template
    • Cloud providers
      • Supported cloud providers
      • Customize provider configuration
      • Unsupported cloud providers
    • Terraform / OpenTofu
      • Modules
        • Module
        • Import modules
        • Manage module
        • Terraform registry credentials
        • Use modules
    • Disaster recovery
  • Automation
    • CI/CD engine
    • Supported plugins
      • Terraform
      • Security
        • Trivy
        • Tfsec
        • Terrascan
        • OPA
        • Checkov
      • Infracost
      • Notifications
        • Email
        • Slack
        • Microsoft Teams
      • Webhooks
    • Pipelines
    • Workflow templates
    • Drift detection
      • Types of drift
      • Remediation
    • Self-Hosted Runner
      • Deploy runner with Kubernetes
      • Deploy runner with docker-compose
  • Settings
    • Overview
    • Authentication
      • Login into Brainboard
      • Single sign-on (SSO)
    • Account management
    • Organization
    • Members
    • Teams
    • Roles & Permissions (RBAC)
      • Level of access
      • Organization RBAC
      • Project RBAC
    • Integrations
      • Git configuration
        • GitHub
        • Azure DevOps (ADO)
        • Bitbucket
        • GitLab
        • How to use
      • Cloud providers
        • AWS
        • Azure
        • GCP
        • OCI
  • Security
    • Data managed by Brainboard
    • SOC 2 Type II
    • Role Based Access Control
  • Help & FAQ
    • Shortcuts
    • FAQ
    • Migration
      • Import from cloud provider
    • Support
    • Glossary
  • Changelog
Powered by GitBook
On this page
  • Description
  • Workflow
  • Task
  • Stage
  • Create workflow template
  • Run pipeline
  • Best practice

Was this helpful?

Edit on GitHub
  1. Automation

CI/CD engine

PreviousDisaster recoveryNextSupported plugins

Last updated 6 months ago

Was this helpful?

Description

Brainboard CI/CD designer is a visual editor that allows you to build your pipelines without any YAML knowledge.

Workflow

A workflow is a set of orchestrated stages that contain tasks which run either in parallel or sequentially.

So, it is a list of steps that you want your infrastructure to go through before, during and after the provisioning of your infrastructure.

When you create a new architecture, Brainboard by default creates an empty workflow named New workflow.

Rename workflow

Task

Task, is an individual action that you want to run to do a specific job. E.g. Terraform apply, send Slack notification or update your ticketing system like ServiceNow.

Tasks can be created from the list of available plugins. Refer to the sections below to learn how to create tasks.

Refer to the supported plugins page to see the options for each kind of task and how to configure it.

Task approval

Every task contains an approval option. When activated, the tasks will not be executed until approved by people or teams added in the approvers list.

This allows you to gate the execution of actions until explicitly approved by the right people or teams, and the approver has all the information needed to take a decision to approve the task or not.

When a task has an approval, it is called manual execution.

Stage

A stage is a logical grouping of parallel tasks that will be executed at the same time. They are represented vertically in the CI/CD designer.

Stages, in the other hand, are horizontal and looks like columns. So there is an implicit dependency between them, which means that any given stage will not be executed until all tasks in the stage before complete successfully.

You can ignore errors in tasks of a stage to not block the execution of following stages if it makes sense in your workflow.

Add a stage

As a stage is just a logical grouping of tasks, to add a new stage, click on the plus button on the right of any tasks

Then, add vertically the tasks you want to be executed in parallel.

Delete a stage

To delete a stage, you need to delete all its vertically stacked tasks.

Create workflow template

When your workflow is complete and all information of tasks are filled, you can create a template from it to use it on any other architecture you have or you will create.

Run pipeline

Once your workflow is configured, you can trigger the execution of the pipeline by clicking on the button Run pipeline.

When the pipeline is triggered, it switches to the Pipelines page where you can see the output of the execution in real time.

Refer to the pipelines page for detailed information about pipelines.

Best practice

  • It's always a good practice to introduce hygiene in the way you build the infrastructure by triggering pipelines to analyze your architecture before pushing into the git repository.

  • Don't use generic email in task's approval unless the email is already a Brainboard user.

To rename a workflow, click on the wheel button on the right of the workflow name:

workflow
Add stage
Add stage after task
Create workflow template
Run pipeline
Pipeline output