https://github.com/robtec/fly
Concourse CLI for interacting with the ATC API
https://github.com/robtec/fly
Last synced: 5 months ago
JSON representation
Concourse CLI for interacting with the ATC API
- Host: GitHub
- URL: https://github.com/robtec/fly
- Owner: robtec
- License: apache-2.0
- Fork: true (vmware-archive/fly)
- Created: 2018-03-24T10:46:35.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2018-03-23T20:49:32.000Z (about 8 years ago)
- Last Synced: 2024-06-20T13:36:52.007Z (almost 2 years ago)
- Language: Go
- Homepage:
- Size: 1.81 MB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# fly
A command line interface that runs a build in a container with [ATC](https://github.com/concourse/atc).
[The documentation](http://concourse-ci.org/fly-cli.html) is hosted together with Concourse's docs.
A good place to start learning about Concourse is [its documentation](http://concourse-ci.org/introduction.html)
or its [BOSH release](https://github.com/concourse/concourse).
## Reporting Issues and Requesting Features
Please report all issues and feature requests in [concourse/concourse](https://github.com/concourse/concourse/issues).
## Building
Fly is built using [Go](http://golang.org/). Building and testing fly is most easily done from a checkout of [concourse](https://github.com/concourse/concourse).
1. Check out concourse and update submodules:
```bash
git clone --recursive https://github.com/concourse/concourse.git
cd concourse
```
2. Install [direnv](https://github.com/zimbatm/direnv). Once installed you can `cd` in and out of the concourse
directory to setup your environment.
3. You can now build the the fly binary with go build:
```bash
cd src/github.com/concourse/fly
go build
```
4. You can also now run tests by installing and running [ginkgo](http://onsi.github.io/ginkgo/):
```bash
go get github.com/onsi/ginkgo/ginkgo
ginkgo -r
```
## Installing from the Concourse UI for Project Development
Fly is available for download in the lower right-hand corner of the concourse UI.
1. Navigate to your Concourse instance in the browser, and click the button corresponding to your OS
1. Move the downloaded file onto your PATH
```bash
install ~/Downloads/fly /usr/local/bin
```
1. Confirm availability with `which fly`
## Upgrading Fly
Fly is not available for upgrade independently of Concourse. You can download the corresponding upgraded version of Fly via the following:
* using the [Concourse UI](#installing-from-the-concourse-ui-for-project-development)
* running `fly -t example sync` if you already have fly locally