Skip to content

Commit

Permalink
Merge pull request #11 from astronomerio/setup-docs
Browse files Browse the repository at this point in the history
Add setup & quickstart docs
  • Loading branch information
schnie committed Feb 17, 2018
2 parents 60ea850 + 5bf3bdf commit bb23b3d
Showing 1 changed file with 69 additions and 1 deletion.
70 changes: 69 additions & 1 deletion README.md
@@ -1,5 +1,73 @@
# Astronomer CLI

## Setup

1. Install Go:

```
$ brew install go
```

More info: <https://golang.org/doc/install>

1. Set `GOPATH` (recommended: `~/go`) in .bash_profile or .bashrc:

```
export GOPATH=$HOME/go
export GOBIN=$HOME/go/bin
export PATH=$PATH:$GOBIN
```

More info: <https://github.com/golang/go/wiki/SettingGOPATH>

## Quickstart

How to get started as a user.

1. Install Astro CLI:

```
$ go get github.com/astronomerio/astro-cli
```

1. Run it to see commands:

```
$ astro-cli
```

1. Create a project:

```
$ mkdir hello-astro && cd hello-astro
$ astro-cli airflow init
```

## Development

How to get started as a developer.

1. Build:

```
$ git clone git@github.com:astronomerio/astro-cli.git
$ cd astro-cli
$ make build
```

1. (Optional) Install to `$GOBIN`:

```
$ make install
```

1. Run:

```
$ astro
```

### Vendor
- All dependnecies are managed with dep, with the exception of libcompose. It needs to be manually added with `go get github.com/docker/libcompose`. Issue here: https://github.com/docker/libcompose/issues/503.

- All dependencies are managed with dep, with the exception of libcompose. It needs to be manually added with `go get github.com/docker/libcompose`. Issue here: <https://github.com/docker/libcompose/issues/503>.
- Alternatively, it is also a git submodule, which should get pulled in when cloned.

0 comments on commit bb23b3d

Please sign in to comment.