Concourse and FLY CLI – A Quick Overview

concourse
Reading Time: 3 minutes

Concourse

Concourse is a pipeline-based continuous thing-doer. It is based on the simple mechanics of resources, tasks, and jobs, it presents a generic approach to automation that makes it ideal for CI/CD.

Quick Installation

Download the docker-compose file

For the concourse backend, it includes a concourse server and a PostgreSQL database.

wget https://concourse-ci.org/docker-compose.yml

Run that docker-compose file

docker-compose up -d

It will be running at localhost:8080. As a test/test, you can log in with the username/password.

fly CLI

The Fly tool provides a command-line interface to Concourse. All the configuration and administration are done using the fly CLI tool.

We need to download fly CLI from the web UI and install it (localhost:8080). You can download the CLI for Windows, Mac, and Linux from the top welcome page.

After downloading the CLI tool, we must grant it execute permission and copy it to the /usr/bin/ directory.

chmod +x ~/Downloads/fly
sudo install ~/Downloads/fly /usr/local/bin

You can check for the availability of the executable by typing:

fly --version 
terminal image

Authenticating with the Concourse Server

fly -t tutorial login -c http://localhost:8080 -u test -p test
terminal image

The login command performs two functions: it authenticates with a given endpoint and saves the result under a more convenient name. The name and token are saved in the file /.flyrc.

Basics commands for fly CLI

fly targets

This will display the name, URL, and expiration date of each target.

fly targets 
terminal image

fly status

This will inform you if the token has expired.

fly -t tutorial status
terminal image

fly userinfo

To see what user you’re logged in as, which teams you’re currently authenticated to, and which roles you have within each team.

fly -t tutorial userinfo
terminal image

fly teams

This will list all the teams, users, and groups.

fly -t tutorial teams  
terminal image

fly logout

To clear out your token for a given target.

fly -t tutorial logout 
terminal image

To clear out your token for all targets.

fly logout -a 
terminal image

fly sync

To ensure that you are running the most recent version that is compatible with the Concourse you are targeting, we provide a command called sync that will update your local fly.

fly -t tutorial sync 
terminal image

Workers

List all workers.

fly -t tutorial workers 
terminal image

Containers

List all Containers.

fly -t tutorial containers 
terminal image

Resources :

https://concourse-ci.org/docs.html