FAQ for AWS Marketplace (#3998)

* updated the changes Signed-off-by: dishanktiwari2501 <[email protected]> * updated the changes Signed-off-by: dishanktiwari2501 <[email protected]> * changes suggested Signed-off-by: dishanktiwari2501 <[email protected]> * Additional edits Signed-off-by: Ian Maddaus <[email protected]> --------- Signed-off-by: dishanktiwari2501 <[email protected]> Signed-off-by: Ian Maddaus <[email protected]> Co-authored-by: Ian Maddaus <[email protected]>
chef · Feb 2, 2023 · 30b368e · 30b368e
1 parent 62d29d2
commit 30b368e
Show file tree

Hide file tree

Showing 2 changed files with 88 additions and 24 deletions.
diff --git a/content/aws_marketplace.md b/content/aws_marketplace.md
@@ -18,7 +18,7 @@ product = ["client", "workstation", "automate"]
 
 Chef Automate is an enterprise platform that allows developers, operations, and security engineers to collaborate on application and infrastructure changes with speed and at scale. Chef Automate provides actionable insights across data centers and cloud providers, wherever your nodes live.
 
-Chef Automate is the center of the modern Chef platform, providing users with a single source of truth for infrastructure, security, and application automation. The comprehensive dashboard provides real-time views of your configuration management activity. Chef Automate comes bundled with the latest Chef Infra Server, providing the core tools you need to manage your enterprise infrastructure. Data collection is enabled by default, allowing your nodes to report activity in real-time. This instance is free for 60 days or you can bring your own license (BYOL).
+Chef Automate is the center of the modern Chef platform, providing users with a single source of truth for infrastructure, security, and application automation. The comprehensive dashboard offers real-time views of your configuration management activity. Chef Automate comes bundled with the latest Chef Infra Server, providing the core tools you need to manage your enterprise infrastructure. Data collection is enabled by default, allowing your nodes to report activity in real time. This instance is free for 60 days, or you can bring your own license (BYOL).
 
 Use this instance with Chef Workstation installed on your laptop or a separate AWS instance.
 
@@ -28,33 +28,87 @@ Use this instance with Chef Workstation installed on your laptop or a separate A
 
 ## Installation
 
-Select [Chef Automate](https://aws.amazon.com/marketplace/pp/prodview-r26bs6uknftps?ref_=srh_res_product_title) in the AWS Marketplace.
+Select [Chef Automate](https://aws.amazon.com/marketplace/pp/prodview-r26bs6uknftps?) in the AWS Marketplace.
 
-The Chef Automate AWS deployment uses [CloudFormation](https://aws.amazon.com/cloudformation/). [Download the CloudFormation template](https://aws-ami-chef-automate-v2.s3.amazonaws.com/cloudformation_template.yaml) or use the [view the template in CloudFormation Designer](https://console.aws.amazon.com/cloudformation/designer/home?templateURL=https://s3.amazonaws.com/awsmp-fulfillment-cf-templates-prod/658820ac-955d-4f73-bbcd-ab19b598d852/ec282ef4e8434b46a9df737571e1e0ac.template)
+The Chef Automate AWS deployment uses [CloudFormation](https://aws.amazon.com/cloudformation/). [Download the CloudFormation template](https://aws-ami-chef-automate-v2.s3.amazonaws.com/cloudformation_template.yaml) or use the [view the template in CloudFormation Designer](https://us-east-1.console.aws.amazon.com/cloudformation/designer/home?region=us-east-1&templateURL=https://s3.amazonaws.com/awsmp-fulfillment-cf-templates-prod/658820ac-955d-4f73-bbcd-ab19b598d852.caadc0d6-b62a-4b83-d9b0-ec685d27c0bc.template)
 
 Every CloudFormation Stack deployment creates a new [Virtual Private Cloud](https://docs.aws.amazon.com/vpc/latest/userguide/what-is-amazon-vpc.html) (VPC).
 
 {{< note >}}
-AWS provides 5 VPCs for each region. If you require more VPCs, please contact [AWS Support](https://aws.amazon.com/contact-us/).
+AWS provides five VPCs for each region. If you require more VPCs, please contact [AWS Support](https://aws.amazon.com/contact-us/).
 {{< /note >}}
 
 ### Start Chef Automate with CloudFormation
 
-1. Enter the following values for your deployment.
+1. Enter the following values for your deployment:
 
-     - Stack Name: `Chef-Automate`
-     - EC2RootVolumeSize: `Default: 40`
-     - Instance Type:`Default: t2.xlarge`
-     - KeyName: _Enter your existing keypair_
-     - SecurityGroupCidrIp: `0.0.0.0/0`
-     - SubnetCIDR: `10.0.0.0/24`
-     - VpcCIDR: `10.0.0.0/16`
+   Stack Name
+   : `Chef-Automate`
 
-1. Select **Next** and create your Chef Automate deployment. This process can take several minutes.
+   EC2RootVolumeSize
+   : `Default: 40`
 
-1. Give Chef Automate an additional five minutes for all the services to start running.
+   Instance Type
+   : `Default: t2.xlarge`
 
-![Select next to create stack](/images/StackDetails.png "Stack Details")
+   KeyName
+   : _Enter your existing keypair._
+
+   SecurityGroupCidrIp
+   : `0.0.0.0/0`
+
+   SubnetCIDR
+   : `10.0.0.0/24`
+
+   VpcCIDR
+   : `10.0.0.0/16`
+
+1. Select **Next** after entering these values.
+
+1. Configure the CloudFormation stack options:
+
+   1. Create a tag for your stack with **Key** set to `Name` and **Value** to `Chef-automate-stack`.
+
+   1. Set permissions for your stack:
+
+      1. Create an IAM role with `AmazonEC2FullAccess` to enable resource creation using the CloudFormation template.
+      1. Once that role is created, select the IAM role from the dropdown menu.
+
+   1. Configure stack failure options:
+
+      AWS provides two stack-failure options:
+
+      Roll back all stack resources
+      : In case of failure, it should rollback all created resources (`Default: Roll back all stack resources`).
+
+      Preserve successfully provisioned resources
+      : In case of failure, it will rollback only failed resources.
+
+   1. Configure advanced options:
+
+      1. Set the stack policy.
+
+         The stack policy defines the update actions that can be performed on resources.`Default: No stack policy`.
+
+      1. Set the rollback configuration.
+
+         AWS CloudFormation will monitor the state of your application during stack creation and updating. For more information, see [Amazon's documentation on rollback triggers](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-rollback-triggers.html).
+
+   1. Configure notification options:
+
+      Create or attach an AWS Simple Notification Service (SNS) which will send email notifications about the stack creation process.
+
+   1. Set the stack creation options:
+
+      Timeout
+      : If specified and stack creation is not completed in that time, CloudFormation will roll back the stack.
+
+      Termination Protection
+      : Termination protection prevents a user from deleting a stack.
+
+1. Select **Next** to create your Chef Automate deployment. This process can take several minutes.
+
+For additional information about these options, see [Amazon's documentation on CloudFormation stack options](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-add-tags.html).
 
 ## Post-Installation
 
@@ -84,26 +138,36 @@ AWS provides 5 VPCs for each region. If you require more VPCs, please contact [A
 
 1. Enter the server name, FQDN, and IP address. Then select **Add Chef Infra Server** to create the server.
 
-    - Name: Add Proper Name for the Sever.
-    - FQDN: It would be the same as Automate FQDN.
-    - IP Address: Public IP Address of the EC2-Instance.
+   Name
+   : Add the name of the Chef Infra Server.
+
+   FQDN
+   : Enter the same as the Chef Automate FQDN.
 
-    ![Add Chef Infra Server Form](/images/automate/add-chef-server-popup-menu.png)
+   IP Address
+   : Public IP address of the EC2 instance.
 
-1. The Chef Infra Server will appear in the list of servers. Select the server and view information about it.
+   {{< figure src="/images/automate/add-chef-server-popup-menu.png" alt="Add Chef Infra Server Form" width="500" >}}
+
+1. The Chef Infra Server will appear in the list of servers. Selecting the server allows you to view information about it.
 ![Select a server from the list](/images/chef_automate_single_server.png "Single Server View")
 
 1. Select **Add Chef Organization**.
 {{< figure src="/images/chef_automate_add_org_page.png" style="width: 30%;" >}}
 
 1. Enter the following information:
 
-    - Name: **demo**
-    - Admin User: **admin**
-    - Admin Key: _copy the key from starter kit_
+   Name
+   : demo
+
+   Admin User
+   : admin
+
+   Admin Key
+   : _copy the key from starter kit_
 
 1. Select **Add Chef Organization**.
-![Select the Add Chef Organization button to complete this action](/images/OrgPageDetails.png)
+{{< figure src="/images/OrgPageDetails.png" alt="Select the Add Chef Organization button to complete this actio" width="500" >}}
 
 ## AWS Deployment Security
 

diff --git a/static/images/StackDetails.png b/static/images/StackDetails.png