Connecting to AWS
Step-by-step guide to connect an AWS account to Bluebricks using a CloudFormation stack
Last updated
Step-by-step guide to connect an AWS account to Bluebricks using a CloudFormation stack
First time using Bluebricks? The onboarding wizard walks you through connecting your cloud automatically. Follow the Quick Start instead.
A valid AWS account
Permissions to create CloudFormation stacks and IAM roles in your AWS account
Go to the Collections page
Click Create Collection
Name the collection (for example, production or staging)
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.
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.
Use the Cloud Accounts API to create a cloud account. Pass the Stack ID as cloudFormationStackId and the Role ARN as roleArnId.
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