Skip to content
Docker to Kubernetes in one command
Go Makefile Shell
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
Godeps
cli
cmd/spread
pkg
vendor
.gitignore
.travis.yml
LICENSE
README.md
make.sh
roadmap.md

README.md

logo

Build Status release Hex.pm

Website | Slack | Email | Twitter | Facebook

Docker to Kubernetes in one command

spread is a command line tool that builds and deploys a Docker project to a Kubernetes cluster in one command. The project's goals are to:

  • Enable rapid iteration with Kubernetes
  • Be the fastest, simplest way to deploy Docker to production
  • Work well for a single developer or an entire team (no more broken bash scripts!)

Spread is under open, active development. New features will be added regularly over the next few months - explore our roadmap to see what will be built next and send us pull requests for any features you’d like to see added.

What's been done so far

  • spread deploy: Deploys a Docker project to a Kubernetes cluster. It completes the following order of operations:
    • Reads context of directory and builds Kubernetes deployment hierarchy.
    • Updates all Kubernetes objects on a Kubernetes cluster.
    • Returns a public IP address, if type Load Balancer is specified.
  • Established an implicit hierarchy of Kubernetes objects
  • Multi-container deployment

What's being worked on now

  • Building functionality for spread deploy so it also builds any images indicated to be built and pushes those images to the indicated Docker registry.
  • spread deploy -p: Pushes all images to registry, even those not built by spread deploy.
  • Support for Linux and Windows
  • Inner-app linking
  • spread logs: Returns logs for any deployment, automatic trying until logs are accessible.
  • spread build: Builds Docker context and pushes to a local Kubernetes cluster.
  • spread rewind: Quickly rollback to a previous deployment.

See more of our roadmap here!

Future Goals

  • Develop workflow for container versioning (containers = image + config)
  • Introduce paramaterization for container configuration

Requirements

Installation

$ brew tap redspread/homebrew-spread
$ brew install spread

FAQ

How are clusters selected? Remote clusters are selected from the current kubectl context. Later, we will add functionality to explicitly state kubectl arguments.

How should I set up my directory? Spread requires a specific project directory structure, as it builds from a hierarchy of entities:

  • Dockerfile
  • *.ctr - optional container file, there can be any number
  • pod.yaml - pod file, there can be only one per directory
  • rc.yaml - replication controller file, there can be only one per directory
  • /.k2e - holds arbitrary Kubernetes objects, such as services and secrets

What is the *.ctr file? The .ctr file is the container struct usually found in the pod.yaml or rc.yaml. Containers can still be placed in pods or replication controllers, but we're encouraging separate container files because it enables users to eventually reuse containers across an application.

Can I deploy a project with just a Dockerfile and *.ctr? Yes. Spread implicitly infers the rest of the app hierarchy.

Hello World

This assumes you have a running Kubernetes cluster and docker-machine installed.

  1. Install Spread with $ brew tap redspread/homebrew-spread then $ brew install spread
  2. Clone example project $ git clone http://github.com/redspread/mvp-ex
  3. Start a docker machine $ docker machine start <name> or create a new machine
  4. Enter in your Docker registry configuration in the correct fields in .k2e/secret.yaml:
    apiVersion: v1
    kind: Secret
    metadata:
    name: NAME
    namespace: NAMESPACE
    data:
    .dockercfg: KEY
    type: kubernetes.io/dockercfg
  5. Build and deploy your project to Kubernetes: $ spread deploy
  6. Grab the public IP and put it in your browser to see your website!

Contributing

We'd love to see your contributions - please see the CONTRIBUTING file for guidelines on how to contribute.

Reporting bugs

If you haven't already, it's worth going through Elika Etemad's guide for good bug reporting. In one sentence, good bug reports should be both reproducible and specific.

Contact

Founders: founders@redspread.com
Slack: redspread.slack.com
Planning/roadmap: roadmap
Bugs: issues

License

Spread is under the Apache 2.0 license. See the LICENSE file for details.

Something went wrong with that request. Please try again.