aws-codebuild

Start a build for a project

$ aws codebuild start-build --project-name [my-project]

$ aws codebuild start-build --project-name [my-project] --environment-variables-override name=MY_VAR,value=myvalue

$ aws codebuild create-project --cli-input-json file://[project.json]

$ aws codebuild create-project --generate-cli-skeleton > [project.json]

$ aws codebuild list-projects

$ aws codebuild batch-get-builds --ids [build-id]

$ aws codebuild stop-build --id [build-id]

$ aws codebuild batch-get-builds --ids [build-id] --query "builds[0].logs"

aws codebuild command [options]

aws codebuild manages AWS CodeBuild, a fully managed continuous integration service that compiles source code, runs tests, and produces deployable artifacts.
Projects define the build environment, source location (CodeCommit, S3, GitHub, Bitbucket), build commands (buildspec.yml), and output artifacts. Use create-project with a JSON configuration file to define all settings.
Builds are triggered with start-build, which can override project defaults for source version, environment variables, and buildspec. Builds run in isolated Docker containers with configurable compute resources.
Build output includes logs (stored in CloudWatch Logs and/or S3) and artifacts (stored in S3). Use batch-get-builds to retrieve build status, logs location, and timing information.

start-build

Start a build run for a project

Start a batch build

Stop a running build

Create a new build project

Modify project configuration

Remove a build project

List all build projects

Get details of one or more builds

Get details of one or more projects

List builds for a specific project

Name of the build project

Build identifier

Space-separated list of build IDs

Source version (branch, tag, commit ID)

Override environment variables (name=KEY,value=VAL)

Override buildspec file

Read parameters from JSON file

Output JSON template for project creation

Build timeouts default to 60 minutes; configure appropriately for long builds. IAM service role must have permissions for source access and artifact storage. Build cache helps speed up subsequent builds but must be configured. Concurrent build limits apply per account.

AWS CodeBuild launched in December 2016 at AWS re:Invent as part of the AWS developer tools suite. It was designed to eliminate the need for managing Jenkins or other CI servers. Build batches for parallel builds were added in 2020, improving performance for complex build matrices.

aws(1), aws-codepipeline(1), aws-codecommit(1), aws-s3(1)