View a markdown version of this page

Launch the stack - DeepRacer on AWS

Launch the stack

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.

    EmailDeliveryMethod

    <Requires input>

    The delivery method to use for sending authentication emails, such as invitation emails and password resets. Options: COGNITO or SES. Default value: COGNITO. Amazon Cognito is the default option and requires no additional configuration, but is subject to a limit of 50 emails per day per account. For users requiring greater throughput, Amazon SES is recommended, but users must first complete the Prerequisites in order to use that service.

    SesVerifiedEmail

    <Optional input>

    A verified email address to send authentication emails from. This is required if you selected SES as the EmailDeliveryMethod. This will be ignored if you selected COGNITO as the EmailDeliveryMethod, and can be left blank in that case.

  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.