api

command
v0.0.0-...-102fcc4 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 13, 2015 License: Apache-2.0, Apache-2.0 Imports: 9 Imported by: 0

README

convox/api

Development

Prerequisites

The Convox API coordinates AWS so we develop against AWS. Passing the --development flag to the convox install command tells the installer to create the resources the API needs but doesn't run the API itself.

After a successful install, convox install prints out a set of ENV vars the API needs to talk to the AWS resources it just provisioned.

Copy and paste these values to a .env file so that convox start can read them.

$ convox install --stack-name=convox-dev --development ~/credentials.csv

# add env vars to .env
Running

Now that you have your AWS resources in place and your ENV configured in .env, all you need to do is:

$ convox start

to boot a local API instance. You can then login to the API via the command line:

$ convox login <host> --password $PASSWORD

Where <host> is going to be the hostname or ip address of your local docker install. If you're on linux then its simply localhost. If you're on OS X, then it is one of:

- `docker-machine ip <machine>`
- `boot2docker ip`

And the PASSWORD is in the ENV data in your .env file.

convox build

For pushes to the convox registry to work locally, you need to configure the docker daemon to talk to the registry that is running in Amazon.

You can get the convox registry from REGISTRY_HOST or the error output from docker when you try to login. Pass this value to the --engine-insecure-registry flag of docker-machine when you create a VM. This means you'll need to create a new machine via:

docker-machine create --driver virtualbox --engine-insecure-registry $(cat .env | grep REGISTRY_HOST | tr -d 'REGISTRY_HOST=') convox-dev`

And then do convox start again against this new docker installation.

If you're running Docker yourself, just pass the REGISTRY_HOST as the option to --insecure-registry when starting the docker daemon.

Contributing

License

Apache 2.0 © 2015 Convox, Inc.

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
cmd

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL