Projects in Device Farm desktop browser testing

Selenium projects created, organized, and managed separately from native testing projects in Device Farm.

You can use the console, AWS CLI, and AWS SDK to manage projects.

Important

We recommend that you follow the standard security advice of granting least privilege—that is, granting only the permissions required to perform a task—when you configure the AWS SDK and AWS CLI with credentials. For more information, see AWS Security Credentials and IAM Best Practices.

Creating a Device Farm desktop browser testing project

You can use the Device Farm console or the AWS CLI to create a project.

Device Farm console

1. Sign in to the Device Farm console at https://console.aws.amazon.com/devicefarm.

2. In the navigation pane, choose Desktop Browser Testing, and then choose Projects.

3. If you already have a project, under Desktop browser testing projects, choose the name of your project.

   Otherwise, to create a new project, choose New project. Then, on the Create Project page, do the following:

   1. Enter a Project name.

   2. (Optional) Enter a project Description.

   3. (Optional) Under Virtual Private Cloud (VPC) Settings, you can configure your project's VPC peering settings by choosing the VPC, its Subnets, and its Security Groups. For instructions on connecting Device Farm to a VPC, see Working with Amazon Virtual Private Cloud across Regions in the Device Farm Developer Guide.

   4. Choose Create.

4. In the project details, note the project's Amazon Resource Name (ARN). It looks like this: arn:aws:devicefarm:us-west-2:111122223333:testgrid-project:123e4567-e89b-12d3-a456-426655440000.

   Note

   For instructions on updating your project configuration, see Configuring your project to use Amazon VPC endpoints.

AWS CLI

Use the create-test-grid-project command to create a project:

aws devicefarm create-test-grid-project --name "My Web App"

The result contains the project that you just created:

{
    "testGridProject": {
        "arn": "arn:aws:devicefarm:us-west-2:111122223333:testgrid-project:123e4567-e89b-12d3-a456-426655440000",
        "name": "My Web App"
    }
}

Note

To update your project configuration, see Configuring your project to use Amazon VPC endpoints.

Deleting a Device Farm desktop browser testing project

To delete a project using the AWS CLI, you need the project ARN.

Warning

Deleting a project is not reversible.

You cannot delete a project that has in-progress sessions.

Device Farm Console

1. Sign in to the Device Farm console at https://console.aws.amazon.com/devicefarm.

2. On the Device Farm navigation panel, choose Desktop Browser Testing, then choose Projects.

3. Choose the project you want to delete.

4. Choose the Delete action.

5. Confirm that you want to delete the project and any associated content, then choose Delete.

AWS CLI

1. If you don't know the ARN, use the list-test-grid-projects command to list your current Device Farm Selenium projects:

   aws devicefarm list-test-grid-projects

   The result contains your current Selenium testing projects:

   {
       "testGridProjects": [
           {
               "arn": "arn:aws:devicefarm:us-west-2:111122223333:testgrid-project:123e4567-e89b-12d3-a456-426655440000",
               "name": "Peculiar Things"
           },
           {
               "arn": "arn:aws:devicefarm:us-west-2:111122223333:testgrid-project:123e4567-e89b-12d3-a456-426655441111",
               "name": "Wumbo's Wild WiFi Emporium"
           },
           {
               "arn": "arn:aws:devicefarm:us-west-2:111122223333:testgrid-project:123e4567-e89b-12d3-a456-426655442222",
               "name": "Banana Stand 2: This is Bananas"
           }
       ]
   }

2. Use the delete-test-grid-project command to delete the project and any sessions and artifacts associated with the project:

   aws devicefarm delete-test-grid-project --project-arn arn:aws:devicefarm:us-west-2:111122223333:testgrid-project:123e4567-e89b-12d3-a456-426655440000