Connecting to AWS
Step-by-step guide to connect an AWS account to Bluebricks using a CloudFormation stack
Prerequisites
A valid AWS account
Permissions to create CloudFormation stacks and IAM roles in your AWS account
How to connect in the Bluebricks app
Create a collection and launch CloudFormation
Go to the Collections page
Click Create Collection
Name the collection (for example,
productionorstaging)Select AWS as the cloud provider
In the Account Number dropdown, click New Account
Click Launch CloudFormation stack
This opens the AWS CloudFormation console with the Bluebricks template, stack name, and your External ID prefilled.
Copy the Role ARN
Open the Outputs tab in the CloudFormation console. The stack provisions IAM roles that Bluebricks uses to access your AWS account. You need at least one Role ARN, but we recommend providing both for full visibility and deployment capabilities.
Discovery Role ARN: grants read-only access for resource discovery, inventory, and the context layer. Required for the agent to see what is running in your account
Orchestration Role ARN: grants read/write access for deploying and managing infrastructure through blueprints. Required for making changes through the orchestration platform
Copy the Discovery Role ARN and, if available, the Orchestration Role ARN. See Connect your Cloud for more details on permission types.
How to connect via the API
Use the Cloud Accounts API to create a cloud account. Pass the Stack ID as cloudFormationStackId and the Role ARN as roleArnId.
Next steps
Connect your Cloud: overview of all supported providers
Kubernetes Integration: live cluster indexing through discovery
Connect your Code: give the agent access to your infrastructure repositories
Last updated

