# README
platform
The home of all things related to the Good Eggs 12 Factor App platform. We heavily leverage Convox, but also believe in the Paasta Principles.
Concepts
Logging
Though Convox has per-app logging similar to Heroku's Logplex, we choose to enable logging at the platform level. logspout is a docker-oriented log shipper. We maintain a custom logspout module that parses JSON application logs and ships to Sumo Logic. Every docker container will have its logs sent to Sumo Logic automatically. You can opt out by adding LOGSPOUT=ignore
to your container's docker environment.
Projects
ami
Contains the packer.io definition for our custom AMI.
logspout-goodeggs
Our custom build of logspout-http that ships docker logs to a Sumo Logic collector.
ranch
The platform's CLI, which serves as the main interface for developers and CI/CD workers.
ranch-api
The platform's API, to which the CLI communicates.
goodeggs-terraform
Terraform for the entire infrastructure, including this platform.