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
  • Components of a version
  • Create a version
  • List versions
  • Restore a version
  • Push to git

Was this helpful?

Edit on GitHub
  1. Cloud design
  2. Design area

Versioning

Description

Brainboard provides a native versioning mechanism that allows you to keep track of your changed and be able to rollback/restore any specific point-in-time version.

Components of a version

When you create a version, Brainboard saves the following information:

  • The architecture design.

  • The version of the cloud provider selected to create the architecture.

  • Variables.

  • Output.

  • The README file.

  • The structure of the Terraform files.

  • Timestamp in UTC when the version is created.

  • The person who created the version.

  • The commit message.

The Terraform code is automatically generated, and it is not saved as code.

Create a version

To create a version of your architecture:

  1. Click on the Create new version button in the options bar:

  2. Write a description of the version: This could the same commit message that you would write when you do a pull request. You can write multiline text, if you want to provide more details.

  3. Click on Create version to create the new version.

    1. When you create a new version, if there are no changes between the current version and the new one, you'll receive this message:

List versions

To list all the versions of your infrastructure:

  • Click on the Show versions button in the options bar:

  • This will open the versions table:

Restore a version

To check out or restore any version, click on the button Restore of the version you want to restore:

Import notes:

  • Brainboard versions are immutable snapshots of your infrastructure. You cannot delete them.

  • You can checkout any version and work on it without altering the history of the versioning.

  • When you clone an architecture or create a template from it, its versions will be removed.

  • When you checkout a version, both the diagram and the Terraform code will be updated.

Push to git

Please refer to the page: Pull requests, for detailed information about how to do pull requests and save the generated code into git.

PreviousConnectorsNextGraphical options

Last updated 7 months ago

Was this helpful?