Terraform Cloud General Settings

In this section, you are going to set up the Terraform Cloud organization and project. You also add AWS credentials and GitHub VCS provider.

To continue with the instructions below, you will need a Terraform Cloud account. Sign in if you have one or create a new account at app.terraform.io.

0000

1. After logging in, navigate to Terrform Cloud’s Getting Started page.

2. Choose Create a new organization.

0001

3. Choose Organization name that is unique. You will use this organization name later in Terraform module configuration. Then, click Create organization.

0002

4. After successfully creating the organization, go to Projects & workspaces to launch a new project. Otherwise, your workspace will be created under the Default Project.

0003

5. Select the New dropdown and click Project.

0004

6. Name the project workshop-1 and click Create.

0005

7. Click Show or Hide button to see the sidebar.

0006

8. You now see your newly created project named workshop-1 is empty. Next, you define AWS credentials that allow Terraform to communicate with resources in your AWS account.

0007

9. Navigate to your organization’s Settings.

0008

10. Click Variable sets on the sidebar and then click Create variable set to create a variable set for your project.

A variable set allows you to create both input variables and environmental variables. Input variables specify the values for variables in your Terraform configuration, whereas environment variables often hold AWS credentials.

0009

11. Name variable set workshop-1 and optionally give a description Variable set for the workshop-1 project.

00010

12. Scroll down to Variable set scope. Choose Apply to specific projects and workspaces. Click the Select projects dropdown and then select the workshop-1 project.

00011

13. Scroll down to Variables. Click Add variable.

00012

14. Select Environment variable. Enter AWS_ACCESS_KEY_ID as key, and the value is your access key id you obtained in 3.3 AWS Credentials. Click Sensitive, then Add variable.

00013

15. Do the same for AWS_SECRET_ACCESS_KEY from step 13. You then got AWS credentials added. Click Create variable set.

00014

16. After successfully creating the variable set, you are still in your organization’s settings page. You next add the GitHub Version Control System (VCS) provider for our organization. Scroll down the left sidebar and click Providers.

00015

17. Click Add a VCS provider.

00016

18. Click the GitHub dropdown. Select GitHub.com (Custom).

00017

19. Follow step 1 On GitHub, register a new OAuth Application to create the required information for the sequential steps.

00018

20. Set the display name for VCS Provider GitHub.com. Enter the Clien ID and Client Secrect values you obtained from the previous step. Click Connect and continue.

00019

21. After successfully adding the GitHub VCS Provider, you skip Advanced settings page by scrolling down to the bottom and click Skip and finish.

00020