Configuration
To be able to analyse and discover your infrastructure, Overmind requires read-only access to your AWS account. There are two ways to configure this:
- Temporarily: When you run the
overmind terraform
commands locally, the CLI uses the same AWS access that Terraform does to create a temporary local source. This gives Overmind access to AWS while the command is running, but not afterwards. - Permanently (Recommended): This is known as a "Managed Source". Managed sources are always running and assume an IAM role that you create in your AWS account that gives them read-only AWS access.
Configure a Managed Source​
To create an AWS source, open settings by clicking your profile picture in the top right of the screen, then clicking Account Settings, then Sources
Then click Add Source > AWS.
Then, use "Deploy with AWS CloudFormation" to be taken to the AWS console. You may need to sign in and reload the page. With the results from the CloudFormation deployment, choose a name for your source (e.g. "prod") and fill in "Region" and "AWSTargetRoleARN".
Press "Create source" to finish the configuration.