GithubHelp home page GithubHelp logo

kryndex / habitus Goto Github PK

View Code? Open in Web Editor NEW

This project forked from cloud66-oss/habitus

0.0 2.0 0.0 1.94 MB

A Build Flow Tool for Docker

Home Page: http://www.habitus.io

License: Apache License 2.0

Go 99.61% Shell 0.39%

habitus's Introduction

Habitus

Habitus adds workflows to Docker build. This means you can create a chain of builds to generate your final Docker image based on a workflow. This is particularly useful if your code is in compiled languages like Java or Go or if you need to use secrets like SSH keys during the build.

Codeship Status for cloud66/habitus

Logo habitus A build flow tool for Docker

Habitus is a standalone build flow tool for Docker. It’s a command line tool that builds Docker images based on their Dockerfile and a build.yml.

Key features:


  • Use build.yml to build the image
  • Supports multi-tenancy of builds by using uid parameters
  • Allows to run arbitrary commands inside of the build container
  • Allows dovetailing (sequencing) of the images from different steps
  • After build, Habitus will run Cleanup command. This will result in 'squashing' the image, therefore removing any traces of unwanted layers
  • Allows you to define and manage secrets configuration for your build
  • Allows you specify any Artifacts - they'll be copied from the built image onto the work directory, so they'll be available for next steps.
  • Support for non TLS connections

Why Habitus? (Problem → solution)


  • If you need to pull code from a private git repository:
    Your private SSH key will be needed in the image during the build process. By using Habitus, the web server only exposes your secrets to the internal Docker network of your machine, and only for the duration of the build. No traces of your secrets are left behind in the image.

  • If you want to add compile-time libraries to your image, but don’t want them in the run-time:
    Habitus will solve it by using different build steps in building your artifact and only place that artifact in smallest possible image.

  • If you want to combine multiple Dockerfiles into complex build and deployments workflows:
    Take the example of an app written in Go: it lives in a container and serves content to visitors based on the latest trending hashtags on Twitter. To get this app into a container, you need to build it with Go compile time libraries. This makes the image large, increasing the attack surface of your service. Habitus solves this issue by compiling your Go app in one container with all compile-time dependencies, and then moves the compiled build artifacts to another smaller image with only the minimum packages required to run it.

  • If you need to run images in production:
    Habitus helps you build a small, secure, performant, stable and immutable image in production. This will allow you to run non-leaky containers and healthy applications in production.

Documentations:


Comprehensive documentation is available on the Habitus website:

http://www.habitus.io/

Quick Start:


First step is to download Habitus. Download the latest version and choice the right platform. Habitus can run on Linux, Windows and Mac. Copy the the downloaded Habitus application into /usr/local/bin/habitus and check if it has the executable flags, if not run chmod a+x /usr/local/bin/habitus

Build files can be made up of multiple steps. Each step is independent of the other ones and downstream steps can use upstream ones as source (in FROM command). When habitus is installed, create a simple build.yml with just one build step and run Habitus.

build:
  version: 2016-03-14 # version of the build schema.
  steps:
    builder:
      name: builder
      dockerfile: Dockerfile

Run habitus

# habitus

And you’re ready to start using Habitus. Comprehensive documentation about build.yml is available on the Habitus website: http://www.habitus.io/

Developing Habitus:


If you wish to work on the Habitus project itself. We provided a docker-compose.yml to spin up the development environment and link the source into the running container.

# docker-compose run habitus /bin/bash
# go build

After the build, you can use Habitus to build itself using the following command in the running container:

# ./habitus --use-tls=false --host=unix://var/run/docker.sock --secrets=false --keep-artifacts=true 

You can run tests by typing

# docker-compose run habitus /bin/bash
# go test    

And you are ready to start your contribution to Habitus.

Difference with Windows or OS or Linux


  • On a Linux machine where Docker can run natively you can bind Habitus to 127.0.0.1.
  • On a Mac (OSX) Docker runs inside of a VM (VirtualBox in most cases through Boot2Docker). This means you need to find the VM address of your Mac and use that to bind Habitus to. By default, Boot2Docker (and Docker Machine) use 192.168.99.1 which is what Habitus uses by default.

CHANGELOG

Check the changelog here

habitus's People

Contributors

khash avatar lvangool avatar foldingbeauty avatar babakgh avatar kasia66 avatar wagoodman avatar

Watchers

James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.