rupakg / buildpack-runner

CenturyLinkLabs/buildpack-runner

Base docker image to create containers from app code using Heroku's buildpacks.

Forked from tutum/buildstep

Supported languages

Check https://github.com/progrium/buildstep#supported-buildpacks for a list of buildpacks supported.

Usage

Create a Dockerfile similar to the following in your application code folder (this example is for a typical Django app):

FROM CenturyLink/buildpack-runner
EXPOSE 80
CMD ["python", "manage.py", "runserver", "80"]

Modify the EXPOSE and CMD directives with the port to be exposed and the command used to launch your application respectively.

Then, execute the following to build the image:

docker build -t myuser/myapp .

This will create an image named myuser/myapp with your application ready to go. To launch it, just type:

docker run -d -p 80 myuser/myapp

Easy!

Usage with Procfile

If you have already defined a Procfile (https://devcenter.heroku.com/articles/procfile) like the following:

web: python manage.py runserver 80

you can use it by defining the following Dockerfile instead:

FROM CenturyLink/buildpack-runner
EXPOSE 80
CMD ["/start", "web"]

Modify the EXPOSE and CMD directives with the port to be exposed and the process type defined in the Procfile used to launch your application respectively.

It also works if you don't have a Procfile

Then, execute the following to build the image:

docker build -t myuser/myapp .
docker run -d -p 80 myuser/myapp

Done!

On-the-fly usage

You can also make it run your application on the fly (without having to create or build a Dockerfile) by passing an environment variable GIT_REPO with your application's git repository URL.

If your repository has a Procfile (or the buildpack you are using has a default Procfile), you can specify the process type name as the run command. Otherwise, you can specify the actual command used to launch your application as the run command. For example:

# Without a Procfile
docker run -d -p 80 -e GIT_REPO=https://github.com/fermayo/hello-world-django.git CenturyLink/buildpack-runner python manage.py runserver 80

# With a Procfile (or relying on the default Procfile provided by the buildpack)
docker run -d -p 80 -e GIT_REPO=https://github.com/fermayo/hello-world-php.git CenturyLink/buildpack-runner /start web

No docker build required!