terraform-aws-codebuild

Terraform module to create AWS CodeBuild project for AWS CodePipeline

Usage

Include this repository as a module in your existing terraform code:

module "build" {
    source              = "git::https://github.com/cloudposse/terraform-aws-codebuild.git?ref=master"
    namespace           = "general"
    name                = "ci"
    stage               = "staging"
    
    # https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-available.html
    build_image         = "aws/codebuild/docker:1.12.1"
    build_compute_type  = "BUILD_GENERAL1_SMALL"
    
    # These attributes are optional, used as ENV variables when building Docker images and pushing them to ECR
    # For more info:
    # http://docs.aws.amazon.com/codebuild/latest/userguide/sample-docker.html
    # https://www.terraform.io/docs/providers/aws/r/codebuild_project.html
    
    privileged_mode     = "true"
    aws_region          = "us-east-1"
    aws_account_id      = "xxxxxxxxxx"
    image_repo_name     = "ecr-repo-name"
    image_tag           = "latest"

    # Optional extra environment variables
    environment_variables = [{
        name  = "JENKINS_URL"
        value = "https://jenkins.example.com"
      },
      {
        name  = "COMPANY_NAME"
        value = "Amazon"
      },
      {
        name = "TIME_ZONE"
        value = "Pacific/Auckland"

      }]
}

To hide warnings about unset versions in providers

Add this in your .tf files

provider "random" {
  version = "~> 1.0"
}

provider "null" {
  version = "~> 1.0"
}

Input

Name	Default	Description
namespace	global	Namespace
stage	default	Stage
name	codebuild	Name
build_image	aws/codebuild/docker:1.12.1	Docker image for build environment, e.g. aws/codebuild/docker:1.12.1 or aws/codebuild/eb-nodejs-6.10.0-amazonlinux-64:4.0.0 (use aws codebuild list-curated-environment-images to get full list)
build_compute_type	BUILD_GENERAL1_SMALL	CodeBuild instance size. Possible values are: BUILD_GENERAL1_SMALL BUILD_GENERAL1_MEDIUM BUILD_GENERAL1_LARGE
buildspec	""	(Optional) buildspec declaration to use for building the project
privileged_mode	""	(Optional) If set to true, enables running the Docker daemon inside a Docker container on the CodeBuild instance. Used when building Docker images
aws_region	""	(Optional) AWS Region, e.g. us-east-1. Used as CodeBuild ENV variable when building Docker images
aws_account_id	""	(Optional) AWS Account ID. Used as CodeBuild ENV variable when building Docker images
image_repo_name	"UNSET"	(Optional) ECR repository name to store the Docker image built by this module. Used as CodeBuild ENV variable when building Docker images
image_tag	"latest"	(Optional) Docker image tag in the ECR repository, e.g. latest. Used as CodeBuild ENV variable when building Docker images
github_token	""	(Optional) GitHub auth token environment variable (GITHUB_TOKEN)
cache_enabled	"true"	(Optional) Creates an S3 bucket, with permissions which allow CodeBuild to store cache objects
cache_expiration_days	"7"	(Optional) Sets S3 policy to expire objects after X days.
cache_bucket_suffix_enabled	"true"	(Optional) Generates an optional 13 character bucket suffix, to help ensure that the bucket will be globally unique
environment_variables	[]	(Optional) A list of maps that contain both "name" and "value" keys for adding additional environment variables at build time

Output

Name	Decription
project_name	CodeBuild project name
project_id	CodeBuild project ARN
role_arn	IAM Role ARN
cache_bucket_name	Name of s3 caching bucket

License

Apache 2 License. See LICENSE for full details.