Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.

Note: This module is in alpha state and is likely to contain bugs and updates may introduce breaking changes. It is not recommended for production use at this time.

Terraform AWS CodeBuild

This module deploys Terraform-managed AWS CodeBuild.

Author: Tony Vattahil (


  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

Example .tfvars file contents

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

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

  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 and edit the default values to suit your environment.