Connect an AWS cloud account

This guide walks through connecting an AWS account to Vantage so the platform can provision and manage compute resources on your behalf. Two setup methods are available: assisted CloudFormation setup and existing ARN configuration.

Prerequisites

• A Vantage account with admin permissions
• An AWS account with permission to create CloudFormation stacks (assisted setup) or an existing IAM role ARN configured for Vantage

Option A: Assisted setup (recommended)

1. Click the Settings gear icon in the bottom-left sidebar and select Cloud Accounts.
2. Click + Create Cloud Account and select AWS.
3. Enter an Account Name (required, max 45 characters) and an optional Description.
4. Under Assisted Setup, click Access the AWS Stack Creation page. A new tab opens to AWS CloudFormation.
5. In AWS: provide a Stack Name, check the acknowledgement box for CloudFormation resource creation, then click Create Stack.
6. Wait for the stack status to change from blue IN PROGRESS to green CREATE_COMPLETE (typically 2--3 minutes).
7. Close the AWS tab, return to Vantage, and click Next.
8. Vantage validates the connection. If successful, the account appears in the Cloud Accounts list.

tip

For multi-region deployments, create one cloud account per AWS region. Each account can target a different region when creating clusters.

Option B: Existing ARN configuration

If you already have an IAM role configured for Vantage:

1. Follow steps 1--3 above.
2. Select Existing ARN Configuration.
3. Paste your IAM Role ARN in the field provided.
4. Click Create Cloud Account.

Required IAM permissions

The Vantage IAM role needs the following permission categories:

• EC2 -- launch instances, manage security groups, describe VPCs and subnets
• CloudFormation -- create and describe stacks
• EKS -- create and manage Kubernetes clusters (if using Kubernetes)
• S3 -- read/write to storage buckets for job data
• IAM -- pass-role permissions for the Vantage service role

The assisted setup CloudFormation template configures these permissions automatically.

Validate the connection

1. In the Cloud Accounts list, click the ... menu on the AWS account row.
2. Select Validate. Vantage tests connectivity and reports the result.

If validation fails, verify that the CloudFormation stack is still active in your AWS console and that the IAM role has not been modified.

Related

• Manage cloud accounts
• Create a Slurm cluster
• Create a Kubernetes cluster