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.
1. After logging in, navigate to Terrform Cloud’s Getting Started page.
2. Choose Create a new organization.
3. Choose Organization name that is unique. You will use this organization name later in Terraform module configuration. Then, click Create organization.
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.
5. Select the New dropdown and click Project.
6. Name the project workshop-1
and click Create.
7. Click Show or Hide button to see the sidebar.
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.
9. Navigate to your organization’s Settings.
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.
11. Name variable set workshop-1
and optionally give a description Variable set for the workshop-1 project
.
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.
13. Scroll down to Variables. Click Add variable.
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.
15. Do the same for AWS_SECRET_ACCESS_KEY from step 13. You then got AWS credentials added. Click Create variable set.
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.
17. Click Add a VCS provider.
18. Click the GitHub dropdown. Select GitHub.com (Custom).
19. Follow step 1 On GitHub, register a new OAuth Application to create the required information for the sequential steps.
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.
21. After successfully adding the GitHub VCS Provider, you skip Advanced settings page by scrolling down to the bottom and click Skip and finish.