Parameters
Parameter | Value | Description |
---|---|---|
AvailabilityZones | optional | see Availability Zones below |
Key | optional | name of ssh key in your aws account |
Password | required | password used to authorize kernel access |
RegistryImage | [image] | docker image for kernel registry |
WebImage | [image] | docker image for kernel api |
If you have an older AWS account you may have some availability zones on which VPC does not function. If you see an error during installation referencing a list of valid availability zones then you can pick three of those and set the value of the AvailabilityZones
parameter to zone1,zone2,zone3
Prerequisites
- working docker environment (
docker ps
should work) - docker-compose
- an installed kernel (see Installation)
Create .env
Look at the Outputs tab of the CloudFormation stack of the kernel you installed and build a .env
accordingly:
AWS_REGION=
AWS_ACCESS=
AWS_SECRET=
CUSTOM_TOPIC=
REGISTRY_HOST=
REGISTRY_PASSWORD=
Install docker-compose
curl -L https://github.com/docker/compose/releases/download/1.2.0/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
Configure an insecure registry with your docker daemon
If you're using boot2docker you can run:
boot2docker ssh "echo $'EXTRA_ARGS=\"--insecure-registry kernel-staging-1392086461.us-east-1.elb.amazonaws.com:5000\"' | sudo tee -a /var/lib/boot2docker/profile && sudo /etc/init.d/docker stop && sleep 2 && sudo /etc/init.d/docker start"
Run the kernel in development mode
Development mode uses docker-compose
. Changes you make to the local project will be synced into the running containers and the project will be reloaded as needed.
make dev
Open in a browser
Go to http://$DOCKER_HOST:5000
in your browser.
Apache 2.0 © 2015 Convox, Inc.