The Open-source self-hosted Platform-as-a-Service written in Go
Go Shell
Permalink
Failed to load latest commit information.
build-packs New build-pack: Java Maven. Oct 9, 2014
env.example Partial progress on support for zfs-fuse, which is flaky about destro… Aug 29, 2013
extra-docs Documented sb-node reboot todo notes. Apr 4, 2014
install maxconn consistency in haproxy configuration and sysctl limits during… Oct 28, 2014
misc Install scripts cleaned up. Sep 23, 2014
pkg/appender Cleanup pass applying current-day best practices. (#23) Oct 6, 2017
src Cleanup pass applying current-day best practices. (#23) Oct 6, 2017
.gitignore Local builds now go to base directory instead of dist. Documentation … Aug 8, 2013
APPLICATION_TROUBLESHOOTING.md Troubleshooting formatting improvements. May 22, 2014
AUTHORS Initial import from old repo. Jul 22, 2013
CLIENT.md NTP management automated via ShipBuilder cron. Oct 8, 2014
CREATE_AN_APP.md Cleanup for "create an app" documentation". Oct 2, 2014
EXAMPLE-aws_s3_iam_policy.json Pruned excessive permissions from example AWS S3 IAM json document. Apr 4, 2014
LICENSE Added license. Aug 8, 2013
README.md Refactored and unified Dyno attachment execution mechanism. Aug 5, 2014
SERVER.md Added details to pre-requisites documentation. Sep 30, 2014
TUTORIAL.md update TUTRIAL.md: Deeper explanations. Apr 9, 2014
build.sh Removed build dependency hackery, replaced with `go get ./...'. (#24) Oct 6, 2017
deploy.go Merge pull request #18 from megahall/megahall/enable-core-dump Apr 3, 2017
deploy.sh Installer improvements: improved error checking in deploy.sh and inst… Jan 7, 2014

README.md

ShipBuilder

Additional information is available at https://shipbuilder.io

About

ShipBuilder is a git-based application deployment and serving system written in Go.

Primary components:

  • ShipBuilder command-line client
  • ShipBuilder server
  • Container management (LXC)
  • HTTP load balancer (HAProxy)

Build Packs

Any app server can run on ShipBuilder, but it will need a build-pack! The current build-packs are:

  • python - Any python app
  • nodejs - Node.js apps
  • scala-sbt - Scala SBT applications and projects
  • playframework2 - Play-framework 2.1.x

Requirements:

  • Ubuntu 13.10, 13.04, or 12.04 (tested and verified compatible)
  • go-lang v1.2 or v1.1
  • envdir (linux: apt-get install daemontools, os-x: brew install daemontools)
  • git and bzr clients
  • Amazon AWS credentials + an s3 bucket

Server Installation

See SERVER.md

Client

See CLIENT.md

Creating your first app

All applications need a Procfile. In ShipBuilder, these are 100% compatible with Heroku's Procfiles (documentation).

See TUTORIAL.md

Getting Help

Have a question? Want some help? You can reach shipbuilder experts any of the following ways:

Discussion List: ShipBuilder Google Group IRC: #shipbuilder on FreeNode Twitter: ShipBuilderIO

Or open a GitHub issue.

Contributing

  1. "Fork"
  2. Make a feature branch.
  3. Do your commits
  4. Send "pull request". This can be
    1. A github pull request
    2. A issue with a pointer to your publicly readable git repo
    3. An email to me with a pointer to your publicly readable git repo

Thanks

Thank you to SendHub for supporting the initial development of this project.