Skip to main content
PyCon US is happening May 14th-22nd in Pittsburgh, PA USA.  Learn more

CLI helper for AWS CodeBuild and CodePipeline

Project description

Build Status Read the docs Version License

CodeBuilder is a CLI tool which allows developpers to use simple commands and helpers inside AWS CI/CD tools like CodePipeline and CodeBuild.

Quick Start

Generally, you would run CodeBuilder on an AWS CodeBuild environment where AWS CLI is properly installed and configured. CodeBuilder uses the exact same authentication method as Boto 3 and AWS CLI.

Install with pip:

$ pip install codebuilder

Example CodeBuild usage (buildspec.yml):

version: 0.1
environment_variables:
  plaintext:
    KMS_CIPHERBLOB: "AQEC..."

phases:
  install:
    commands:
      - pip install codebuilder
  pre_build:
    commands:
      - codebuilder aws ecr login
      - codebuilder aws kms decrypt ${KMS_CIPHERBLOB} > ${CODEBUILD_SRC_DIR}/secret
  build:
    commands:
      - docker build -t 123456789012.dkr.ecr.eu-west-1.amazonaws.com/foo .
  post_build:
    commands:
      - docker push 123456789012.dkr.ecr.eu-west-1.amazonaws.com/foo
      - codebuilder docker --image-name 123456789012.dkr.ecr.eu-west-1.amazonaws.com/foo get-image full --source-json-file config.json --in-place Parameters DockerImage
      - codebuilder aws ecr prune

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page