Deploy the solution - DeepRacer on AWS

Deploy the solution

This solution uses AWS CloudFormation templates and stacks to automate its deployment. The CloudFormation template specifies the AWS resources included in this solution and their properties. The CloudFormation stack provisions the resources that are described in the template.

Overview

Follow the step-by-step instructions in this section to configure and deploy the solution into your account.

Before you launch the solution, review the cost, architecture, security, and other considerations discussed earlier in this guide.

Time to deploy: Approximately 30 minutes

Note

You are responsible for the cost of the AWS services used while running this solution. For more details, visit the Cost section in this guide and refer to the pricing webpage for each AWS service used in this solution.

Deploy using Amazon CloudFormation

This automated AWS CloudFormation template deploys DeepRacer on AWS.

  1. Sign in to the AWS Management Console and select the button to launch the CloudFormation template.

    launch button

    Alternatively, you can download the template as a starting point for your own implementation.

  2. The template is launched in the US East (N. Virginia) region by default. To launch this solution in a different AWS region, use the region selector in the console navigation bar.

    Note

    This solution uses Amazon Cognito, which is currently available in specific AWS Regions only. Therefore, you must launch this solution in an AWS Region where Amazon Cognito is available. For the most current service availability by Region, refer to the AWS Regional Services List.

  3. On the Create stack page, verify that the correct template URL shows in the Amazon S3 URL text box and choose Next.

  4. On the Specify stack details page, assign a name to your solution stack.

    Important

    This solution provisions log groups that are set to be retained following stack deletion. If you have previously deployed DeepRacer on AWS, be sure to provide a unique stack name to prevent the deployment from failing due to log groups with the same name already existing.

  5. Under Parameters, review the parameters for the template and modify them as necessary. This solution uses the following default values.

    Parameter Default Description

    AdminEmail

    <Requires input>

    Email address for the initial admin user. This user will be automatically added to the admin group.

    CustomDomain

    <Optional input>

    Custom domain URL for CORS allowlist (only if you have or plan to map a custom domain to CloudFront).

    Namespace

    <Requires input>

    The namespace for this deployment of DeepRacer. Lowercase alphanumeric characters of length between 3 and 12.

  6. Choose Next.

  7. On the Configure stack options page, choose Next.

  8. On the Review page, review and confirm the settings. Be sure to check the box acknowledging that the template will create AWS Identity and Access Management (IAM) resources.

  9. Choose Create stack to deploy the stack.

    You can view the status of the stack in the AWS CloudFormation console in the Status column. You should receive a CREATE_COMPLETE status in approximately five minutes.

Deploy using AWS CDK commands

You can use the AWS Cloud Development Kit (CDK) and its CLI commands to deploy the solution into your account. To do this, follow the instructions in the README.md in our GitHub repository.