Cloud resources
Overview
A Cloud resource is a building block of any architecture in Brainboard and could be one of the following:
Any resource available at the cloud provider that has either a Terraform resource or data source associated with it.
Terraform module.
Brainboard reference object that doesn't have a Terraform equivalent resource, but helps you build accurate architecture and generate a correct Terraform code. For example, Containers like Azure location, AWS region.
Characteristics of a Cloud Resource
Types of cloud resources
Brainboard supports all the Terraform/OpenTofu resource types.
Resources
For a specific cloud provider, these represent all the resources available at any selected version of the Terraform provider.
Data sources
Data sources allow you to reference existing resources and access their information in a read-only mode.
Switching between resource types
You can switch between the data types and resources in two ways:
From the left panel Select either the resource or data source option as demonstrated below.


Inside the design area: If you want to switch any resource into data or vice-versa, right-click on the resource and select either
Switch to dataorSwitch to resource.


Agnostic nodes
Converting Cloud resource into an Icon
You can convert any cloud resource into an icon by right-clicking on the resource and choosing the option Omit from code.
Converting an icon into a Cloud resource
You can change an icon back into a cloud resource by right-clicking on the icon and choosing the option Add to code.
Terraform modules
These are special cloud resources as they are containers and abstract a group of cloud resources.
In the left panel, there is a section where you can import your modules and access a modules' Catalog to manage them.

Import module
To import your module, click on the Import button under Modules in the left panel. It will open the "Import Terraform module" window that allows you to specify information about the module.

Import module from registry
You can import your Terraform / OpenTofu modules from your Terraform registry, which could be public or private. You need to specify:
The name of the module: this will be used as a Terraform resource name when you use the module later. If needed, you can customize it for every module in the Resource Configuration panel when you use the module.
The source path: The path of the module in the registry.
The version: You can specify the version you want to import or keep the latest and later change it in the Resource Configuration panel when you use it.

Importing from a private registry
To import from a private registry, click on the toggle button Use terraform registry credentials below the source path, select the credentials of the registry.
Importing from Git repository
You can also import your Terraform / OpenTofu modules from any Git repository, public or private.



Importing from files
This option allows you to upload your local Terraform files and create a module from them.

Modules catalog
When you import your modules into Brainboard, you build a catalog of modules that anyone within the team can browse and use. It encourages the culture of reuse.
To access this catalog, click on the Catalog button under Modules in the left panel. It will open the gallery.

Modules Catalog Popup Window
You can find the following options on the Module Catalog popup window:
Search bar.
Pinned visibility button: It helps you select/unselect only modules that are pinned in the current architecture.
Global actions: You can select all the modules of the catalog and apply bulk actions such as:
Pin: It adds all the selected modules to the left panel, so even if you switch architectures, the modules stay available.
Unpin: It removes all the selected modules from the left panel, but doesn't delete them.
Delete: Deletes all the selected modules from Brainboard.
Module's card: This will contain all the information about the module.
Pin/unpin the module: It adds/removes a specific module to/from the left panel.
Edit module: Helps you edit the information of the module. It will open the same configuration window as theImport module.
Delete module: It permanently deletes the module from Brainboard.
Terraform code
When you add a module to the design area, the initial Terraform code generated will contain the following.
Last updated