Skip to content

Latest commit

 

History

History
36 lines (27 loc) · 4.19 KB

deployment_steps_ct.adoc

File metadata and controls

36 lines (27 loc) · 4.19 KB
Raw

Deploy from the CloudFormation console

  1. Sign in to your AWS account, and launch a deployment option, as described under Deployment options. The AWS CloudFormation console opens with a prepopulated template.

  2. Ensure that you are in the correct Region, and choose Next to enter parameter values.

  3. On the Create stack page, keep the default setting for the template URL, and then choose Next.

  4. On the Specify stack details page, change the stack name if needed. Review the parameters for the template. Provide values for the parameters that require input. For all other parameters, review the default settings and customize them as necessary. When you finish reviewing and customizing the parameters, choose Next.

    Note
    		 Unless you are customizing the Partner Solution templates for your own projects, don’t change the default settings for the parameters Partner Solution S3 bucket name, Partner Solution S3 bucket Region, and Partner Solution S3 key prefix. Changing these settings automatically updates code references to point to a new Partner Solution location. For more information, refer to the AWS Partner Solution Contributor’s Guide.

  5. On the Configure stack options page, you can specify tags (key-value pairs) for resources in your stack and set advanced options. When you finish, choose Next.

  6. On the Review page, review and confirm the template settings. Under Capabilities, select the two check boxes to acknowledge that the template creates AWS Identity and Access Management (IAM) resources that might require the ability to automatically expand macros.

  7. Choose Create stack. The stack takes about {deployment_time} to deploy.

  8. Monitor the stack’s status, and when the status is CREATE_COMPLETE, the {partner-product-name} deployment is ready.

  9. To view the created resources, choose the Outputs tab.

Deploy with Control Tower

You can deploy this Partner Solution in a customized AWS Control Tower environment to help you set up a secure, multi-account AWS environment using AWS best practices. For details, see Customizations for AWS Control Tower.

The root directory of the Partner Solution repository includes a ct folder with a manifest.yaml file to assist you with the AWS Control Tower deployment. This file has been customized for the Partner Solution.

In the following sections, you will review and update the settings in this file and then upload it to the S3 bucket that is used for the deployment.

Review the manifest file

  1. Navigate to the root directory of the Partner Solution and open the manifest.yaml file, located in the ct folder.

  2. Confirm that the region attribute references the Region where AWS Control Tower is deployed. The default Region is us-east-1. You will update the regions attribute (located in the resources section) in a later step.

  3. Confirm that the resource_file attribute points to the public S3 bucket for the Partner Solution. Using a public S3 bucket ensures a consistent code base across the different deployment options. If you prefer to deploy from your own S3 bucket, update the path as needed.

  4. Review each of the parameters attributes and update them as needed to match the requirements of your deployment.

  5. Confirm that the deployment_targets attribute is configured for either your target accounts or organizational units (OUs).

  6. For the regions attribute, add the Region where you plan to deploy the Partner Solution. The default Region is us-east-1.

Upload the manifest file

  1. Compress the manifest.yaml file and name it custom-control-tower-configuration.zip.

  2. Upload the custom-control-tower-configuration.zip file to the S3 bucket that was created for the AWS Control Tower deployment (custom-control-tower-configuration-<accountnumber>-<region>). The file upload initiates the customized pipeline that deploys the Partner Solution to your target accounts.