Working with robot applications

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

Creating a robot application

Using the console

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

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

3. Select Create robot application.

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

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 Elastic Container Registry?.

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

7. Choose Create.

Using the AWS CLI

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

Creating a robot 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 Robot applications.

3. Choose the robot application name.

4. In the Robot applications details page, choose Create new version, and then choose Create.

Using the AWS CLI

aws robomaker create-robot-application-version --name my-robot-app-arn

Viewing a robot 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 Robot applications.

3. Choose the Name of a robot application.

Using the AWS CLI

aws robomaker describe-robot-application --application my-robot-application-arn

Updating a robot 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 Robot applications.

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

4. Choose Actions, then choose Update.

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

6. Choose Update to update the robot application.

Using the AWS CLI

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

Deleting a robot 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 Robot applications.

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

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

Using the AWS CLI

aws robomaker delete-robot-application --application my-robot-application-arn

Deleting a robot 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 Robot applications.

3. Choose the Name of the robot application to see its versions.

4. In the robot detail page, choose the Version to see version details.

5. In the robot application version details page, choose Delete, and then choose Delete to confirm.

Using the AWS CLI

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