github.com/fpgeek/buildstep/features/apps/go 2014-12-16

Buildstep uses Docker and Buildpacks to build applications like Heroku

Homepage: https://github.com/fpgeek/buildstep

Platform: Go

Language: Groovy

License: MIT

Repository: https://github.com/fpgeek/buildstep/features/apps/go

View on registry: http://go-search.org/view?id=github.com/fpgeek/buildstep/features/a...

Documentation: http://godoc.org/github.com/fpgeek/buildstep/features/apps/go

Install: go get github.com/fpgeek/buildstep/features/apps/go


Buildstep

Heroku-style application builds using Docker and Buildpacks. Used by Dokku to make a mini-Heroku.

Requirements

  • Docker
  • Git

Supported Buildpacks

Buildpacks should generally just work, but many of them make assumptions about their environment. So Buildstep has a list of officially supported buildpacks that are built-in and ready to be used.

Building Buildstep

The buildstep script uses a buildstep base container that needs to be built. It must be created before you can use the buildstep script. To create it, run:

$ make build

This will create a container called progrium/buildstep that contains all supported buildpacks and the builder script that will actually perform the build using the buildpacks.

Building an App

Running the buildstep script will take an application tar via STDIN and an application container name as an argument. It will put the application in a new container based on progrium/buildstep with the specified name. Then it runs the builder script inside the container.

$ cat myapp.tar | ./buildstep myapp

If you didn't already have an application tar, you can create one on the fly.

$ tar cC /path/to/your/app . | ./buildstep myapp

The resulting container has a built app ready to go. The builder script also parses the Procfile and produces a starter script that takes a process type. Run your app with:

$ docker run -d myapp /bin/bash -c "/start web"

Custom Buildpacks

Custom buildpacks can be installed by committing a file in the root of your git repository named .env This file should contain a line export BUILDPACK_URL=<repository> specifying the git repository providing the buildpack.

If your buildpack needs extra packages these can be installed by the buildpack using bin/compile.

License

MIT

Sustain

Tagged Releases

2014-12-16 November 19, 2014
2014-03-08 March 08, 2014
2014-02-28 January 11, 2014

Project Statistics

SourceRank 5
Dependent repositories 0
Total tags 3
Latest tag
First tag
Stars 0
Forks 0
Watchers 1
Contributors 34
Repo Size: 199 KB

Top Contributors See all

Jeff Lindsay Morton Jonuschat Felipe Coury Alexander Nolan Evans Le Kload Arthur Maltson Luke Closs Marco Andreotti Alan Justino da Silva Luigi Maselli Mike Park Richard North Pahaz Blinov Paul Liétar Paul Liljenberg Andrew Starr-Bochicchio Dave Choi Eric Reid Jeroen Offerijns

Something wrong with this page? Make a suggestion

Export .ABOUT file for this library

Last synced: 2016-11-30 07:08:32 UTC

Login to resync this project