Overview

Amazon Web Services(AWS) is a subsidiary of Amazon that provides on-demand cloud computing platforms and APIs to individuals, companies, and governments, on a metered pay-as-you-go basis.

Configure A Terraform Backend State (AWS)

To provision, your Terraform requires a backend state configured via the HyperCloud™ Platform(HCP). The backend state in Terraform preserves the current state of the deployment. _{(Refer Note 1)}

You can use the following steps to configure your Terraform Backend State:

1. Login to HyperCloud^TM with your credentials.

2. Click Service Orchestration > Select AppStore > Click Terraform

3. Click on Terraform Blueprint to open your Blueprint Azure Postgres (PaaS)

   1. On the Overview page, review details and click Next

   2. On the Workspace page:

      1. Select the Workspace type as New:

         • Enter the name for your new workspace.

         • Enter the brief description for your new workspace.

         • Select the environment type from the drop-down list e.g: Dev.

         • Select the Cloud type from the drop-down list.

         • Select the Resource pool e.g: RP.ARM.Australia Central.atest

         • Select the backend state for your new workspace.

         • To entitled users:

           • Select Only Me: If this template is not meant to be shared.

           • Select Everyone If this template is to be shared with everyone in the.

           • Select Groups & Users: if the template is to be shared with specific users or groups.

         • Click Create Workspace and Validate

      2. Select the workspace type as Existing and Select the existing workspace e.g. hgprodazurewks1 and click Validate

4. On the Define Variables page, click on the Action button and update the following values:

   • rg_name: "hgprod-tf-rg"

   • pg_name: "hgprod-psqlsrv01"

   • client_startip: "your system's public ip address"

   • client_endip: "your system's public ip address"

5. Click on Plan

6. Review the Successful Plan Output.

7. Click on Apply

8. Click on the Workspace for e.g hgprodazurewks1

9. Click on Timeline Tab to monitor the status of the Terraform provisioning.

10. Once the Terraform template has successfully provisioned, click on the Resource Tab to view the resources created via Terraform template

To create additional templates refer to the Terraform documentation.

Create Your Terraform Workspace

The Workspaces are collections of infrastructure when you run locally, Terraform manages each collection of infrastructure with a persistent working directory, which contains a configuration, state data, and variables. The Terraform cloud manages infrastructure collections with workspaces instead of directories. The terraform workspace organizes your infrastructure in a good manner into groups. You can create your new workspace to manage your collection of infrastructure resources.

You can use the following steps to Create your Terraform Workspace:

1. Login to the HyperCloud™ Platform(HCP) with your credentials.

2. Click Services Orchestration > Select Services > Click on Infra as Code >Click on Workspace > Click on +New workspace.

3. Enter the following details in your new Workspace:

   1. Enter the name Example: hgprodawswks1

   2. Enter a brief description of your new workspace.

   3. Select a suitable environment for your new workspace, Example: dev.

   4. Select the Cloud Type from the drop-down list, Example: AWS.

   5. Select the Resource pool, Example: RP.AWS.ap-southeast-1a.<RP-Name>_{(Refer Note (1))}

   6. Backend State: select a backend state for Example: hgprodawsbs1.

   7. To your Entitled Users:

      • Select Only Me: If this template is not meant to be shared

      • Select Everyone: If this template is to be shared with everyone in the Tenant

      • Select Groups & Users: if the template is to be shared with specific users or groups

4. Click New Workspace.

Create Terraform Based Blueprints

Your Terraform based blueprints help you to create an Infrastructure of your cloud environment.

Download the Sample Terraform Template

• Download the  Sample Terraform Template.

• Create a zip archive with the files downloaded for Example: aws-s3-bucket-tf.zip

Create your Terraform Blueprint

To create a Terraform based HyperCloud™ Platform(HCP) Blueprint:

1. Login to the HCP account with your credentials.

2. Click  Services Orchestration > Select AppStore > Click on New > Select Terraform.

3. Enter the Following details in your Terraform blueprint:

   1. Enter a Name for the Terraform Template, Example: AWS S3 Bucket.

   2. This is an optional step, enter a brief Description, for Example: Terraform Template to AWS S3 bucket.

   3. Click on Choose File and upload the aws-s3-bucket-tf.zip file

   4. This is an optional step, configure a version, Example: 1.0

   5. Select the Cloud Type from the drop-down: select AWS.

   6. To your entitled users:

      1. Select Only Me: If this template is not meant to be shared.

      2. Select Everyone: If this template is to be shared with everyone in the Tenant.

      3. Select Groups & Users: if the template is to be shared with specific users or groups.

      4. Select All Tenants (Only available to Cloud Admins): if the template is to be shared with all tenants.

1. Click Create

Provision Your Terraform Based Blueprint

You can provision your Terreform Blueprints in the Amazon Web Service(AWS) resource once you have created Terraform workspace.

You can use the following steps to provision your Terraform Blueprint:

1. Login to your HyperCloud^TM Platform(HCP) with your credentials.

2. Click on Service Orchestration > Select AppStore > Click on Terraform > Click on the Blueprint Azure Postgres (PaaS).

3. Click on Terraform Blueprint to open your Blueprint Azure Postgres (PaaS)

   1. On the Overview page, review details and click Next.

   2. On the Workspace page:

      1. Select the Workspace type as New:

         1. Enter the name for your new workspace.

         2. Enter the brief description for your new workspace.

         3. Select the environment type from the drop-down list Example: Dev.

         4. Select the Cloud type from the drop-down list.

         5. Select the Resource pool Example: RP.ARM.Australia Central.atest.

         6. Select the backend state for your new workspace.

         7. To entitled users:

            • Select Only Me: If this template is not meant to be shared.

            • Select Everyone If this template is to be shared with everyone in the.

            • Select Groups & Users: if the template is to be shared with specific users or groups.

         8. Click Create Workspace and Validate.

      2. Select the workspace type as Existing and Select the existing workspace e.g. hgprodazurewks1 and click Validate.

   3. On the Define Variables page, click on the Action button and update the following values.

      1. Bucket_name: for e.g "hg-prod-bk1"_{(Refer Note1)}

1. Click on Plan and

Review the Successful Plan Output. _{(Please refer note 2)}

1. Click on

Apply.

1. Click on the Workspace for

Example: hgprodawswks1.

1. Click on

Timeline Tab to monitor the status of the Terraform provisioning.

1. Once the Terraform template has successfully provisioned, click on the

Resource Tab to view the resources created via the Terraform template.

More Terraform templates can be created by referring to Terraform Templates.

Deploy your Terraform Blueprint

Once you’ve provisioned a Terraform Blueprint, you’ll need to deploy it. Follow these steps to deploy your Terraform Blueprint:

1. Login to your HCP portal account.

2. Click Service Orchestration and navigate to AppStore > Terraform > Click open your Terraform Blueprint > Click Edit.

3. Select your Workspace and click Validate.

4. Check your Terraform variables for syntax errors by clicking Validate.

5. Click Plan to create a plan of execution and review the changes to your deployed resource.

6. Click Apply to deploy your Blueprint and configure your resources in the cloud provider.