Getting Started

Welcome! Transform your deployment workflow with CentralCI and Concourse - let’s build your first pipeline together!

Concourse CI is a powerful open source CI/CD platform that liberates your pipelines through declarative configs and 100+ integrations. CentralCI runs a Concourse cluster for you at https://No Org.centralci.com

1. Install the fly CLI

MacOS

Download the fly binary:

curl -Lo fly https://No Org.centralci.com/api/v1/cli?arch=amd64&platform=darwin

Mark the binary as executable and move it somewhere in your $PATH:

chmod +x fly
mv ./fly /usr/local/bin/

Windows

Open a web browser and download fly, saving it as fly.exe: Download fly

https://No Org.centralci.com/api/v1/cli?arch=amd64&platform=windows

Add fly.exe to your Path so you can use it from a Powershell terminal:

• Create a new directory: C:\Program Files\Concourse
• Move fly.exe to this directory
• Open System Properties (Win + Pause)
• Click “Advanced system settings”
• Click “Environment Variables”
• Under “System Variables”, find “Path”
• Click “Edit”
• Click “New”
• Add C:\Program Files\Concourse
• Click “OK” on all windows

Linux

Download the fly binary:

curl -Lo fly https://No Org.centralci.com/api/v1/cli?arch=amd64&platform=linux

Mark the binary as executable and move it somewhere in your $PATH:

chmod +x fly
mv ./fly /usr/local/bin/

2. Login with the fly CLI

To interact with Concourse, install the fly CLI tool (MacOS, Windows or Linux) and log in. fly is Concourse’s command-line interface (CLI) tool.

3. Deploy a Hello World pipeline

Create a new file called pipeline.yml(or consult fly -h):

jobs:
- name: hello-world-job
  plan:
  - task: hello-world-task
    config:
      # Tells Concourse which type of worker this task should run on
      platform: linux
      # We'll use this container image for our task - more on these container resources later
      image_resource:
        type: registry-image
        source:
          repository: busybox # images are pulled from docker hub by default, and cached
      # The command Concourse will run inside the container
      run:
        path: echo
        args: ["Hello world!"]

Deploy your pipeline:

fly -t ci set-pipeline -p hello -c pipeline.yml

Unpause your pipeline:

fly -t ci unpause-pipeline -p hello

Then visit https://No Org.centralci.com, and you can start your first build by clicking the + icon in the top right corner of your screen.

4. Key Concepts

• Pipelines: Your entire workflow defined in YAML
• Jobs: Units of work combining tasks and resources
• Tasks: The actual commands to run
• Resources: External things your pipeline interacts with (git repos, S3 buckets, etc.)

5. Next Steps

• Watch your pipeline run at https://No Org.centralci.com/teams/main/pipelines/hello
• Add more tasks to your pipeline
• Try different resource types (docker images, S3, etc.)
• Set up pipeline triggers for automated builds