This module deploys Terraform-managed AWS CodeBuild.

Author: Tony Vattahil (tonynv@amazon.com)

Prerequisites

1. Install Terraform. See Install Terraform for a tutorial.
2. Sign up and log into Terraform Cloud. There is a free tier available.

Configure Terraform Cloud API access

1. Generate a Terraform Cloud token.
   terraform login

2. Export the TERRAFORM_CONFIG variable.
   export TERRAFORM_CONFIG="$HOME/.terraform.d/credentials.tfrc.json"

Configure your .tfvars file

Example file path
$HOME/.aws/terraform.tfvars

Example .tfvars file contents

Replace the sample values in the example with your own values.

AWS_SECRET_ACCESS_KEY = "<AKIAIOSFODNN7EXAMPLE>"
AWS_ACCESS_KEY_ID = "<wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY>"
AWS_SESSION_TOKEN = "AQoDYXdzEJr...<remainder of security token>"

Note: STS-based credentials are optional but highly recommended.

WARNING: Make sure your credentials are secured outside of version control and follow secrets-management best practices.

Deploy the module (Linux or MacOS)

1. Clone the aws-ia/terraform-aws-codebuild repository.
   git clone https://github.com/aws-ia/terraform-aws-codebuild

2. Change to the module root directory.
   cd terraform-aws-codebuild

3. Set up your Terraform cloud workspace.
   cd setup_workspace

4. Run the following commands in order:
   terraform init
terraform apply or terraform apply -var-file="$HOME/.aws/terraform.tfvars".

   Note: Terraform apply runs remotely in Terraform Cloud.

5. Change to the deploy directory.
   cd ../deploy

6. Open dev.auto.tfvars and edit the default values to suit your environment.

https://github.com/aws-ia/terraform-aws-codebuild