[DEPRECATED] Add an AWS account

Introduction

Chronom uses a read-only IAM User and Role to collect data from your AWS account.

To make it easier for you to add your AWS account to Chronom, we have created a cli tool that will help you create the IAM User and Role and add them to Chronom in a few simple steps.

The tool is based on the AWS CLI and the AWS CloudShell, so you can use it from any terminal that has the AWS CLI installed and configured.

We suggest that you use the AWS CloudShell to add your AWS account to Chronom using the following guide.
But if you prefer to use your own terminal, you can follow the instructions below.

AWS CloudShell

To add additional AWS Accounts to your Chronom, first open the AWS CloudShell in the account that will be added, in any available region, and execute the following commands:

Enter the following commands to prepare the CloudShell:

curl -O https://raw.githubusercontent.com/chronom-ai/chronom-cli/main/chronom-cli
chmod +x chronom-cli
./chronom-cli setup cloudshell

Enter the following command to configure the user that will grant Chronom Read Only access

./chronom-cli create chronom user-iam --name chronom-ro-user

Once the script is complete run the following command to retrieve the values (NOTE those are sensitive credentials):

cat ./chronom-ro-user-details.yaml

Open your Chronom settings page: CHRONOM_URL/settings → Click on Credentials and click Connect a new account

Then fill in the information from the yaml file.

Once you completed please make sure to delete the yaml file from the cloudshell:

rm ./chronom-ro-user-details.yaml

In case you are not using AWS CloudShell - Not recommended

Although we strongly recommend using the AWS CloudShell, you can also use the Chronom CLI to add an AWS account from any bash terminal.

The tricky part is that you are using "any" terminal, you will need to have the AWS CLI installed and configured with the credentials of the account you want to add.
Once you have the AWS CLI installed and configured, you can follow the commands below.

Install the Chronom CLI

curl -O https://raw.githubusercontent.com/chronom-ai/chronom-cli/main/chronom-cli
chmod +x chronom-cli

Optional: Use Chronom CLI to install the AWS CLI

./chronom-cli setup install awscli

Then follow the instructions to install the AWS CLI.

Create a Chronom user with read-only access

./chronom-cli create chronom user-iam --name chronom-ro-user

Once the script is complete run the following command to retrieve the values (NOTE those are sensitive credentials):

cat ./chronom-ro-user-details.yaml

Open your Chronom settings page: CHRONOM_URL/settings → Click on Credentials and click Connect a new account

Then fill in the information from the yaml file.

Once you completed please make sure to delete the yaml file from the cloudshell:

rm ./chronom-ro-user-details.yaml