Creating Artifacts

Create reusable Infrastructure as Code artifacts in Bluebricks to standardize infrastructure and enable consistent deployments across environments.

Overview

Artifacts serve as the foundation of Bluebricks automation by turning raw Infrastructure as Code into reusable, versioned building blocks that you can use across environments. Each Artifact encapsulates infrastructure logic behind clean, well-defined inputs and outputs, so you can standardize your infrastructure without duplicating code.

Artifacts can be composed together inside blueprints for repeatable deployments across environments.

Supported IaC types

Bluebricks supports multiple IaC technologies:

• Terraform

• OpenTofu

• Helm

• CloudFormation

• Bicep

• Generic (container-based execution)

Don't have cade that defines your resources yet? Let the Cloud Import Agent codify them for you.

How to publish artifacts via CLI

An artifact is automatically generated through a single CLI command from the code's directory.

Prerequisites

• Installed bricks command line

1

Navigate to your code's root folder

For example:

my_s3_module/
├── main.tf              # Infrastructure definitions
├── variables.tf         # Input variables
├── outputs.tf           # Output values
└── versions.tf          # Provider versions

Your code must be self-contained and executable with its native tool, such as terraform init/plan/apply or helm install. For Terraform or OpenTofu, this means the root module you would normally navigate into and run directly.

2

Publish with the CLI

Publish it from the artifact directory:

bricks bprint publish

This command generates a slim metadata file (bricks.json) and publishes it into the Bluebricks catalog.

3

View your artifacts

Go to the Artifacts page in Bluebricks to see your new artifact.

How to update your artifacts with CLI

Following any change to the underlying IaC you should update your artifact and re-publish it.

1

Navigate to your code's root folder

2

Change the artifacts version

Run the following command to update the semantic version

bricks bprint bump

You can also manually open the bricks.json file of the artifact, change the version and save it.

3

Publish the new version

Publish the new version using

bricks bprint publish

Artifact example

Every artifact is defined by a bricks.json file at its root.

This file describes:

• The artifact name

• Semantic version

• Inputs (props)

• Outputs (outs)

• The native IaC implementation (native)

Example:

{
  "name": "aws_vpc",
  "description": "Creates a VPC with public and private subnets",
  "version": "1.2.0",
  "native": {
    "type": "terraform",
    "path": "./terraform"
  }
}

A standard artifact repository:

my_s3_artifact/
├── bricks.json          # Artifact definition
├── main.tf              # Infrastructure definitions
├── variables.tf         # Input variables
├── outputs.tf           # Output values
└── versions.tf          # Provider versions
├── README.md            # Documentation
└── examples/            # Usage examples
    └── basic/
        ├── main.tf