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.
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
-
-
Sign in to the Device Farm console at https://console.aws.amazon.com/devicefarm.
-
In the navigation pane, choose Desktop Browser Testing, and then
choose Projects.
-
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:
-
Enter a Project name.
-
(Optional) Enter a project Description.
-
(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.
-
Choose Create.
-
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
.
- 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"
}
}
Deleting a Device Farm desktop browser testing project
To delete a project using the AWS CLI, you need the project ARN.
Deleting a project is not reversible.
You cannot delete a project that has in-progress sessions.
- Device Farm Console
-
-
Sign in to the Device Farm console at https://console.aws.amazon.com/devicefarm.
-
On the Device Farm navigation panel, choose Desktop Browser
Testing, then choose
Projects.
-
Choose the project you want to delete.
-
Choose the Delete action.
-
Confirm that you want to delete the project and any associated
content, then choose Delete.
- AWS CLI
-
-
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"
}
]
}
-
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