Working with simulation applications

An AWS RoboMaker simulation application is a container image responsible for running your robot's simulation stack. The simulation application image must be hosted in Amazon ECR. Your simulation application is often paired with a robot application to create a simulation job.

Creating a simulation application

Using the console

1. Sign in to the AWS RoboMaker console at https://console.aws.amazon.com/robomaker/.

2. In the left navigation pane, choose Development, and then choose Simulation applications.

3. Select Create simulation application.

4. On the Create simulation application page, type a Name for the simulation application. Choose a name that helps you identify the simulation.

5. Provide your Amazon ECR container image. You can use images that you've pushed to Amazon ECR. For more information, see What is Amazon ECR?.

6. For more about tagging, see Tagging AWS RoboMaker resources.

7. Choose Create.

Using the AWS CLI

aws robomaker create-simulation-application \ 
--name my-sim-app \ 
--simulation-software-suite name=SimulationRuntime \
 --robot-software-suite name=General \ 
--environment uri=:<ACCOUNT>.dkr.ecr.<REGION>.amazonaws.com/my-sim-app:latest

Creating a simulation application version

Using the console

1. Sign in to the AWS RoboMaker console at https://console.aws.amazon.com/robomaker/.

2. In the left navigation pane, choose Development, and then choose Simulation applications.

3. Choose the simulation application name.

4. On the Simulation applications details page, choose Create new version, and then choose Create.

Using the AWS CLI

aws robomaker create-simulation-application-version --name my-simulation-application-arn

Viewing a simulation application

Using the console

1. Sign in to the AWS RoboMaker console at https://console.aws.amazon.com/robomaker/.

2. In the left navigation pane, choose Development, then choose Simulation applications.

3. Select the Name of a simulation application to see details including the time it was created and last updated.

Using the AWS CLI

aws robomaker describe-simulation-application --job my-simulation-job-arn

Updating a simulation application

Using the console

1. Sign in to the AWS RoboMaker console at https://console.aws.amazon.com/robomaker/.

2. In the left navigation pane, choose Development, then choose Simulation applications.

3. Check the box next to the simulation application you want to update.

4. Select Actions, then select Update.

5. You can add or remove sources, but you must have at least one source simulation application file.

6. Select Update to update the simulation application.

Using the AWS CLI

aws robomaker update-simulation-application \
--application my-simulation-application-arn \
--robot-software-suite name=General \ 
--simulation-software-suite name=SimulationRuntime \ 
--environment uri=:<ACCOUNT>.dkr.ecr.<REGION>.amazonaws.com/my-simulation-app:latest

Deleting a simulation application

Using the console

1. Sign in to the AWS RoboMaker console at https://console.aws.amazon.com/robomaker/.

2. In the left navigation pane, choose Development, then choose Simulation applications.

3. Select the Name of a simulation application. This shows details such as the time it was created and last updated.

4. In the simulation application detail page, choose Delete and then choose Delete to delete to confirm.

Using the AWS CLI

aws robomaker delete-simulation-application --application my-simulation-application-arn

Deleting a simulation application version

Using the console

1. Sign in to the AWS RoboMaker console at https://console.aws.amazon.com/robomaker/.

2. In the left navigation pane, choose Development, then choose Simulation applications.

3. Select the Name of the simulation application to see its versions.

4. On the simulation detail page, choose Version to see details.

5. On the details page, choose Delete, and then choose Delete to confirm.

Using the AWS CLI

aws robomaker delete-simulation-application-version \
--application my-simulation-application-arn \
--version 2