Set up AWS integration
Automate TurboScale helps you to create a browser automation grid hosted on your AWS account. With this setup, you get a self-hosted, private and auto-scaling grid that supports browser automation testing at scale with on-demand resource consumption along with other tools to monitor the grid utilization.
Use this document if you want to set up a browser automation grid from scratch. This document explains the steps required to create an IAM user and access key and secret with relevant permissions to create and manage a fully functional grid with dependent services using BrowserStack CLI.
Setting up your AWS account
Once you visit our setup guide, you can select the desired region to set up your automation grid on AWS. Once you’ve selected the region, you need to create a new IAM user and access keys.
- The prerequisite is to have an AWS account and associated credentials that allow you to create a user on AWS.
- Use the correct account where BrowserStack can create your automation grid and make use of relevant AWS services like EKS, S3, etc. for different grid-related functionalities.
- The recommendation is to use the same AWS account where development or staging services are hosted.
Create IAM user and access keys
Once you’ve selected the region, you can start the process of creating a new IAM user on AWS using the CloudFormation link.
In a new window, you will be prompted to sign into your AWS account to complete the setup. Once you sign in, provide a secure password for the new IAM user. This CloudFormation stack will create the required IAM user in your AWS account and generate the access key and secret once the new user is created. Use this access key and secret key with BrowserStack CLI to create and manage your grids.
This is just a user creation stack and it will not yet set up any compute resources in your AWS account.
Once the CloudFormation stack creation is successful, AWS creates the following resources in your account.
-
accessKey: The access key for the newly created IAM user. -
BrowserStackIAMUser: New dedicated IAM user with appropriate permissions. You can also use this user to log in on the AWS console using the usernameBrowserStackIAMUserand the password provided while accepting the CloudFormation stack. -
EKSManagedPolicy: This policy allows the newly created IAM user to create required resources on AWS for creating a new automation grid.
You can now use this AccessKey and SecretKey from the Outputs tab with BrowserStack CLI to create and manage your grids.
Troubleshooting
Visibility on resources
BrowserStack adds AWS tags whenever a new resource(Compute or Non-Compute) is being created as part of Automate TurboScale in your AWS account.
Tags are key-value pairs that you can use to view your AWS resources and identify, organize, or search for resources. Here is a list of tags added by BrowserStack on all the resources.
| Tag Key | Tag value |
|---|---|
browserstack:managedBy |
BrowserStack |
browserstack:service |
BrowserStack-Automate-TurboScale |
browserstack:grid |
<grid name> used while creating a browser Automation Grid |
browserstack:cluster |
<cluster name> used while creating a browser Automation Grid |
browserstack:creationDate |
Epoch Timestamp of resource creation |
Contact us
Need help? Reach out to us here.
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
Thank you for your valuable feedback!