deis 1.9.1

Command-line Client for Deis, the open PaaS

Deis Client

The Deis client is a Python CLI that issues API calls to a private Deis controller, providing a Heroku-inspired PaaS workflow.

What is Deis?

Deis is an open source PaaS that makes it easy to deploy and scale containers to host applications, databases, middleware and other services. Deis leverages Docker, CoreOS and Heroku Buildpacks to provide a private PaaS that is lightweight and flexible.

Deis comes with out-of-the-box support for Ruby, Python, Node.js, Java, Clojure, Scala, Play, PHP, Perl, Dart and Go. However, Deis can deploy anything using Docker images or Heroku Buildpacks. Deis is designed to work with any cloud provider. Currently Amazon Web Services, Azure, DigitalOcean, Google Compute Engine, Linode, OpenStack, and bare metal deployments are supported.

Why Deis?

Deploy anything

Deploy a wide range of languages and frameworks with a simple git push using Heroku Buildpacks or Dockerfiles.

Control everything

Choose your hosting provider configuration. Define a cluster to meet your own needs. Retain full root access to every node. Manage your platform with a private Deis controller.

Scale effortlessly

Add nodes automatically and scale containers with a single command. Smart scheduling, container balancing and proxy reconfiguration are completely automated.

100% Open Source

Free, transparent and easily customized. Join the open-source PaaS and DevOps community by using Deis and complimentary projects like Docker, CoreOS and Heroku Buildpacks.

Get Started

1. Install the Client:

Your Deis client should match your server’s version. For developers, one way to ensure this is to use Python 2.7 to install requirements and then run client/deis.py in the Deis code repository. Then make a symlink or shell alias for deis to ensure it is found in your $PATH:

$ make -C client/ install
$ sudo ln -fs $(pwd)/client/deis.py /usr/local/bin/deis
$ deis
Usage: deis <command> [<args>...]

If you don’t have Python 2.7, install the latest deis binary executable for Linux or Mac OS X with this command:

$ curl -sSL http://deis.io/deis-cli/install.sh | sh

The installer puts deis in your current directory, but you should move it somewhere in your $PATH.

2. Register a User:

$ deis register http://deis.local3.deisapp.com
$ deis keys:add

3. Deploy an Application:

$ deis create
Creating application... done, created peachy-waxworks
Git remote deis added
$ git push deis master
       Java app detected
-----> Installing OpenJDK 1.6... done
...
-----> Compiled slug size: 63.5 MB
       Launching... done, v2

-----> peachy-waxworks deployed to Deis
       http://peachy-waxworks.example.com ...

$ curl -s http://peachy-waxworks.example.com
Powered by Deis!

4. Manage an Application:

$ deis config:set DATABASE_URL=postgres://user:[e-mail]:5432/db
$ deis scale web=8
$ deis run ls -l  # the view from inside a container
total 28
-rw-r--r-- 1 root root  553 Dec  2 23:59 LICENSE
-rw-r--r-- 1 root root   60 Dec  2 23:59 Procfile
-rw-r--r-- 1 root root   33 Dec  2 23:59 README.md
-rw-r--r-- 1 root root 1622 Dec  2 23:59 pom.xml
drwxr-xr-x 3 root root 4096 Dec  2 23:59 src
-rw-r--r-- 1 root root   25 Dec  2 23:59 system.properties
drwxr-xr-x 6 root root 4096 Dec  3 00:00 target

To learn more, use deis help or browse the documentation.

License

Copyright 2013, Engine Yard, Inc.

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.