Get Build

Description

Get a specific build or an array of builds.

Passing [id] argument will cause a retrieval of a specific build.
In case of not passing [id] argument, a list will be returned.

Command

codefresh get builds [id..]

Aliases

codefresh get build [id..]

Arguments

Option Alias Default Description
id Build id

Options

Option Alias Type Default Description
--help Print help information
--limit -l number 25 Limit amount of returned results
--page -p number 1 Paginated page
--status -s array Filter results by statuses

Possible values:
- running
- success
- error
- terminated
- terminating
- pending-approval
- delayed
- pending
- elected
--trigger -t array Filter results by triggers

Possible values:
- build
- launch-image
- launch-composition
--pipeline-id --pid array Filter results by pipeline id
--pipeline-name --pipeline array Filter results by pipeline name
--branch -b array Filter results by branch
--commit-id --revision,r,sha array Filter results by commit revision sha
--pipeline-trigger-id array Filter results by pipeline trigger id
--from Date in format: YYYY-MM-DD. Show builds from the provided date
--to Date in format: YYYY-MM-DD. Show builds up to provided date

Output Options

Option Alias Type Default Description
--select-columns --sc Columns to select for table output
--output -o Output format

Possible values:
- json
- yaml
- wide
- name
- id
--date-format --df Provide predefined or custom date format. Predefined options: [“default”, “date”, “datetime”, “date-diff”]
--pretty Use colors and signs for output
--watch -w boolean false Watching updates to a particular resource
--watch-interval number 3 Interval time at watching mode (in seconds)

Examples

Get build ID

codefresh get build ID

Get all builds

codefresh get builds

Get all builds that are executions of pipeline “ID”

codefresh get builds --pipeline-id ID

Get all builds that are executions of pipelines that are named “NAME”

codefresh get builds --pipeline-name NAME

Get all builds that their status is error

codefresh get builds --status=error

Get all builds within given date range

codefresh get builds --from=2020-01-01 --to=2020-02-01