AWS solutions documentation change
Summary
Restructured deployment instructions to recommend AWS Launch Wizard as primary method, removed CloudFormation deployment steps, added data collection notice, and reorganized content sections.
Security assessment
No security vulnerabilities or weaknesses are addressed. Changes focus on deployment methodology and user experience improvements. The added data collection notice is a privacy disclosure, not a security feature or vulnerability fix.
Diff
diff --git a/solutions/latest/deepracer-on-aws/deploy-the-solution.md b/solutions/latest/deepracer-on-aws/deploy-the-solution.md index 8fd8d7075..a178fc647 100644 --- a//solutions/latest/deepracer-on-aws/deploy-the-solution.md +++ b//solutions/latest/deepracer-on-aws/deploy-the-solution.md @@ -5 +5 @@ -OverviewDeploy using Amazon CloudFormationDeploy using AWS CDK commands +OverviewDeploy using AWS CDK commands @@ -9 +9 @@ OverviewDeploy using Amazon CloudFormationDeploy using AWS CDK commands -This solution uses [AWS CloudFormation templates and stacks](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-whatis-concepts.html) 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. +[AWS Launch Wizard](./deploy-using-aws-launch-wizard.html) is the recommended deployment method for this solution. It provides: @@ -11 +11 @@ This solution uses [AWS CloudFormation templates and stacks](https://docs.aws.am -## Overview + * A guided configuration experience with detailed help panels at each step @@ -13 +13 @@ This solution uses [AWS CloudFormation templates and stacks](https://docs.aws.am -Follow the step-by-step instructions in this section to configure and deploy the solution into your account. + * A centralized page to monitor the health of all your deployments @@ -15 +15 @@ Follow the step-by-step instructions in this section to configure and deploy the -Before you launch the solution, review the [cost](./cost.html), [architecture](./architecture-overview.html), [security](./security-1.html), and other considerations discussed earlier in this guide. + * Indication when there is a more recent version of the solution available for deployment or upgrade @@ -17 +16,0 @@ Before you launch the solution, review the [cost](./cost.html), [architecture](. -**Time to deploy:** Approximately 30 minutes @@ -19,3 +17,0 @@ Before you launch the solution, review the [cost](./cost.html), [architecture](. -###### Note - -You are responsible for the cost of the AWS services used while running this solution. For more details, visit the [Cost](https://docs.aws.amazon.com/solutions/latest/deepracer-on-aws/cost.html) section in this guide and refer to the pricing webpage for each AWS service used in this solution. @@ -23 +18,0 @@ You are responsible for the cost of the AWS services used while running this sol -## Deploy using Amazon CloudFormation @@ -25 +20 @@ You are responsible for the cost of the AWS services used while running this sol -This automated AWS CloudFormation template deploys DeepRacer on AWS. +Alternatively, you can deploy the solution directly using an [AWS CloudFormation template](./deploy-using-aws-cloudformation.html). @@ -27 +22 @@ 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. +## Overview @@ -29 +24 @@ This automated AWS CloudFormation template deploys DeepRacer on AWS. -[  ](https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?templateURL=https://solutions-reference.s3.amazonaws.com/deepracer-on-aws/latest/deepracer-on-aws.template&redirectId=ImplementationGuide) +Follow the step-by-step instructions in this section to configure and deploy the solution into your account. @@ -31 +26 @@ This automated AWS CloudFormation template deploys DeepRacer on AWS. -Alternatively, you can [download the template](https://solutions-reference.s3.amazonaws.com/deepracer-on-aws/latest/deepracer-on-aws.template) as a starting point for your own implementation. +Before you launch the solution, review the [cost](./cost.html), [architecture](./architecture-overview.html), [security](./security-1.html), and other considerations discussed earlier in this guide. @@ -33 +28 @@ Alternatively, you can [download the template](https://solutions-reference.s3.am - 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. +**Time to deploy:** Approximately 30 minutes @@ -37,28 +32 @@ Alternatively, you can [download the template](https://solutions-reference.s3.am -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](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/). - - 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. - +This solution includes data collection metrics to AWS. We use this data to better understand how customers use this solution and related services and products. AWS owns the data gathered through this survey. Data collection is subject to the [AWS Privacy Notice](https://aws.amazon.com/privacy/). @@ -65,0 +34 @@ You can view the status of the stack in the AWS CloudFormation console in the ** +###### Note @@ -66,0 +36 @@ You can view the status of the stack in the AWS CloudFormation console in the ** +You are responsible for the cost of the AWS services used while running this solution. For more details, visit the [Cost](https://docs.aws.amazon.com/solutions/latest/deepracer-on-aws/cost.html) section in this guide and refer to the pricing webpage for each AWS service used in this solution. @@ -80 +50 @@ Service quotas -Post-deployment steps +Deploy using AWS Launch Wizard