fly

CLI for Concourse CI system

TLDR

Set build target

$ fly -t [target] set-pipeline

Trigger job

$ fly -t [target] trigger-job -j [pipeline/job]

Watch job logs

$ fly -t [target] watch -j [pipeline/job]

Login to Concourse

$ fly -t [target] login -c [https://ci.example.com]

Sync fly version

$ fly -t [target] sync

SYNOPSIS

fly [options] command [arguments]

fly is the CLI for Concourse CI, a container-based continuous integration system. It manages pipelines, triggers builds, and interacts with Concourse servers.The tool handles pipeline configuration, job management, and build monitoring. Each Concourse instance is registered as a named target for easy switching between CI servers.fly enables scriptable CI/CD workflows and provides real-time access to build logs and status.

PARAMETERS

COMMAND

Operation: login, set-pipeline, trigger-job, watch, etc.

-t, --target TARGET

Concourse target name saved in ~/.flyrc.

login

Authenticate with a Concourse server (use -c url for concourse URL, -n team for team).

logout

Clear saved token for a target.

targets

List all configured targets and their token expiration.

set-pipeline

Create or update a pipeline from YAML (-p pipeline -c config.yml).

get-pipeline

Output a pipeline's current configuration (-p pipeline).

destroy-pipeline

Remove a pipeline (-p pipeline).

unpause-pipeline, pause-pipeline

Enable or disable a pipeline.

trigger-job

Start job execution (-j pipeline/job).

watch

Stream a build's output (-j pipeline/job or -b build).

execute

Run a one-off task locally (-c task.yml).

sync

Update local fly binary to match server version.

--help

Display help information.

CAVEATS

Version must match server. Targets need periodic re-authentication. Pipeline YAML syntax is specific.

HISTORY

fly is the CLI for Concourse CI, created by Pivotal (now VMware). Concourse pioneered treating CI pipelines as code with a focus on containers and reproducibility.

fly