Create and Integrate new Grid

Automate TurboScale helps you create an on-demand browser automation grid that supports popular testing frameworks like Selenium on your cloud.

With Automate TurboScale, you can create a browser automation grid either in your existing Kubernetes setup or you can use BrowserStack’s CLI to set up a fully functional grid from scratch.

We recommend the latter approach because it supports the end-to-end needs of creating a scalable automation grid, that involves managing all the services with a cloud provider. If you are re-using your Kubernetes cluster, cloud platform configuration about auto-scaling or other dependencies like tests storage need to be managed separately using the cloud provider console/utilities.

Create a fully-functional Automation Grid

This option helps you create a fully-functional auto-scaling Automation grid on AWS. You can customize the grid with different parameters like instance type, VPC, etc. By default, we create an internal Grid with the configuration best suited for running automation.

1. Choosing a Cloud Provider: With Automate TurboScale, you can create a browser automation grid on the cloud provider of your choice. Currently, we support only AWS for setting up a fully functional grid from scratch. GCP and Azure will be supported soon.

2. Grid Profile Details: With Automate TurboScale, you can select the cloud provider region of your choice. By default, we select the most popular region on the cloud provider.

3. Setup IAM Role: To set up a grid on your cloud, you need to create a new IAM user with appropriate access to use AWS resources to create a new Grid. For more information on how to set up your AWS account, refer to this documentation

4. Create Grid using CLI: Once you have the IAM access credentials, download and install BrowserStack CLI and create Grid using create command. For more information on how to use CLI, refer to this documentation

Create Automation Grid in the existing setup

This option helps you create a browser automation grid in your existing Kubernetes cluster on AWS, GCP or Azure. When the Grid is created using this option, the cloud platform configuration like auto-scaling, machine configuration or other dependencies like test artifact storage need to be managed separately using the cloud provider console.

Automate TurboScale supports creating a grid in an existing cluster from the following tools currently:

• Helm
• BrowserStack CLI

Integrate new Automation Grid

Once the Automation Grid is created using either of the setup options, you can check your Grid-related information in Automation Console. You can set BrowserStack credentials and Framework URL from the Grid Overview page to initialize your remote Webdriver instance.

// declare remote URL in a variable
public static final String URL = "https://YOUR_USERNAME:YOUR_ACCESS_KEY@" + <RANDOM_HASH> + "-hub.browserstack-ats.com/wd/hub";

// intialize Selenium WebDriver
MutableCapabilities capabilities = new MutableCapabilities();
Webdriver driver = new RemoteWebDriver(new URL(URL), capabilities);

driver = new webdriver.Builder().
// Change the Selenium hub URL to new Grid URL
  usingServer('https://YOUR_USERNAME:YOUR_ACCESS_KEY@'+<RANDOM_HASH>+'-hub.browserstack-ats.com/wd/hub').
  withCapabilities(capabilities).build();

$web_driver = RemoteWebDriver::create(
  "https://YOUR_USERNAME:YOUR_ACCESS_KEY@" . <RANDOM_HASH> . "-hub.browserstack-ats.com/wd/hub",
  $caps
);

URL = "https://YOUR_USERNAME:YOUR_ACCESS_KEY@{}-hub.browserstack-ats.com/wd/hub".format(RANDOM_HASH)
driver = webdriver.Remote(command_executor=URL, options=options)

driver = Selenium::WebDriver.for(:remote,
  :url => "https://YOUR_USERNAME:YOUR_ACCESS_KEY@" + <RANDOM_HASH> + "-hub.browserstack-ats.com/wd/hub",
  :desired_capabilities => capabilities)

export BROWSERSTACK_USERNAME="YOUR_USERNAME"
export BROWSERSTACK_ACCESS_KEY="YOUR_ACCESS_KEY"

$env:BROWSERSTACK_USERNAME "YOUR_USERNAME" 
$env:BROWSERSTACK_ACCESS_KEY "YOUR_ACCESS_KEY" 

setx BROWSERSTACK_USERNAME "YOUR_USERNAME" 
setx BROWSERSTACK_ACCESS_KEY "YOUR_ACCESS_KEY" 

set BROWSERSTACK_USERNAME=YOUR_USERNAME
set BROWSERSTACK_ACCESS_KEY=YOUR_ACCESS_KEY

def run_session(playwright):
  clientPlaywrightVersion = str(subprocess.getoutput('playwright --version')).strip().split(" ")[1]
  desired_cap['client.playwrightVersion'] = clientPlaywrightVersion

  cdpUrl = 'wss://' + <RANDOM_HASH> + '-hub.browserstack-ats.com/playwright?caps=' + urllib.parse.quote(json.dumps(desired_cap))
  browser = playwright.chromium.connect(cdpUrl)
  page = browser.new_page()     

vBrowser = await playwright.chromium.connect({
          wsEndpoint:
            `wss://` + <RANDOM_HASH> + `-hub.browserstack-ats.com/playwright?caps=` +
            `${encodeURIComponent(JSON.stringify(caps))}`,
        });  

BrowserType browserType = playwright.chromium();
JSONObject jsonCaps = new JSONObject(capabilitiesObject);
caps = URLEncoder.encode(jsonCaps.toString(), "utf-8");
String wsEndpoint = "wss://" + <RANDOM_HASH> + "-hub.browserstack-ats.com/playwright?caps=" + caps;
browser = browserType.connect(wsEndpoint);
page = browser.newPage();       

Troubleshooting

Need help? Contact us.