|
1 | | -deis |
2 | | -==== |
3 | | - |
4 | | -**Deis** is an open source *platform-as-a-service* (PaaS) for public and |
5 | | -private clouds. |
6 | | - |
7 | | -Take your agile development to the next level. Free your mind and focus |
8 | | -on your code. Deploy updates to local metal or worldwide clouds with |
9 | | -``git push``. Scale servers, processes, and proxies with a simple |
10 | | -command. Enjoy the *twelve-factor app* workflow while keeping total |
11 | | -control. |
12 | | - |
13 | | -The `opdemand/deis <https://github.com/opdemand/deis>`__ project |
14 | | -contains a command-line interface to the **Deis** system. It's all you |
15 | | -need to work with an existing **Deis** controller. To set up your own |
16 | | -private application platform, the |
17 | | -`deis-controller <https://github.com/opdemand/deis-controller>`__ and |
18 | | -`deis-chef <https://github.com/opdemand/deis-chef>`__ projects are also |
19 | | -required. |
| 1 | +deis: Command-line client for your PaaS |
| 2 | +======================================= |
20 | 3 |
|
21 | | -Getting Started |
| 4 | +.. image:: https://badge.fury.io/py/deis.png |
| 5 | + :target: http://badge.fury.io/py/deis |
| 6 | + |
| 7 | +.. image:: https://travis-ci.org/opdemand/deis.png?branch=master |
| 8 | + :target: https://travis-ci.org/opdemand/deis |
| 9 | + |
| 10 | +.. image:: https://pypip.in/d/deis/badge.png |
| 11 | + :target: https://crate.io/packages/deis/ |
| 12 | + |
| 13 | +What is Deis? |
| 14 | +------------- |
| 15 | + |
| 16 | +Deis is an open source PaaS inspired by Heroku, that makes it easy to deploy |
| 17 | +and scale LXC containers used to host applications, databases, middleware and |
| 18 | +other services. Deis leverages Docker, Chef and Heroku Buildpacks to provide a |
| 19 | +private PaaS that is lightweight and flexible. |
| 20 | + |
| 21 | +Deis comes with out-of-the-box support for Ruby, Python, Node.js, Java, |
| 22 | +Clojure, PHP, Dart and Go. However, Deis can deploy *anything* using Heroku |
| 23 | +Buildpacks or pre-built Docker images. Containers can be deployed to any |
| 24 | +cloud provider, although only EC2 is currently supported. |
| 25 | + |
| 26 | +Why Deis? |
| 27 | +========= |
| 28 | + |
| 29 | +Deploy anything |
22 | 30 | --------------- |
23 | 31 |
|
24 | | -Clone the git repository at `<https://github.com/opdemand/deis.git>`_: |
| 32 | +Leverage Heroku Buildpacks to deploy a wide range of languages and frameworks |
| 33 | +with a simple "git push" or create custom Docker images to deploy pre-built |
| 34 | +apps, databases and other services. |
25 | 35 |
|
26 | | -:: |
| 36 | +Control everything |
| 37 | +------------------ |
27 | 38 |
|
28 | | - $ git clone https://github.com/opdemand/deis.git |
29 | | - Cloning into 'deis'... |
30 | | - ... |
31 | | - Resolving deltas: 100%, done. |
32 | | - $ cd deis |
| 39 | +Choose your hosting providers. Define your application formations. Scale |
| 40 | +nodes and containers independently. Control your routing layer. Manage the |
| 41 | +entire platform with a private Deis controller. |
33 | 42 |
|
| 43 | +Scale effortlessly |
| 44 | +------------------ |
34 | 45 |
|
35 | | -Use an isolated python environment: |
| 46 | +Scale nodes, containers and proxies with a single command. Node provisioning is |
| 47 | +transparent, container formations are rebalanced automatically and proxies are |
| 48 | +updated to re-route traffic without downtime. |
36 | 49 |
|
37 | | -:: |
| 50 | +100% Open Source |
| 51 | +---------------- |
38 | 52 |
|
39 | | - $ virtualenv venv |
40 | | - New python executable in venv/bin/python |
41 | | - ... |
42 | | - Installing pip................done. |
43 | | - $ source venv/bin/activate |
44 | | - (venv) $ |
| 53 | +Free, transparent and easily customized. Join the open-source PaaS and DevOps |
| 54 | +community by using Deis and complimentary projects like Docker, Chef and |
| 55 | +Heroku Buildpacks. |
45 | 56 |
|
| 57 | +Getting Started |
| 58 | +--------------- |
46 | 59 |
|
47 | | -Next Steps |
48 | | ----------- |
| 60 | +Installing the Deis client from the Python Package Index is simple: |
49 | 61 |
|
50 | | -License |
51 | | -------- |
| 62 | +:: |
52 | 63 |
|
53 | | -**Deis** is open source software under the Apache 2.0 license. Please |
54 | | -see the **LICENSE** file in the root directory for details. |
| 64 | + $ pip install deis |
55 | 65 |
|
56 | | -Credits |
| 66 | +The client will automatically install the following dependencies: |
| 67 | + |
| 68 | +- `pyyaml <https://bitbucket.org/xi/pyyaml>`__ |
| 69 | +- `requests <http://python-requests.org>`__ |
| 70 | + |
| 71 | + |
| 72 | +License |
57 | 73 | ------- |
58 | 74 |
|
59 | | -**Deis** rests on the shoulders of leading open source technologies: |
| 75 | +Copyright 2013, OpDemand LLC |
60 | 76 |
|
61 | | -- Docker |
62 | | -- Chef |
63 | | -- Django |
64 | | -- Heroku buildpacks |
65 | | -- Gitosis |
| 77 | +Licensed under the Apache License, Version 2.0 (the "License"); you may not |
| 78 | +use this file except in compliance with the License. You may obtain a copy of |
| 79 | +the License at <http://www.apache.org/licenses/LICENSE-2.0> |
66 | 80 |
|
67 | | -`OpDemand <http://www.opdemand.com/>`__ sponsors and maintains the |
68 | | -**Deis** project. |
| 81 | +Unless required by applicable law or agreed to in writing, software |
| 82 | +distributed under the License is distributed on an "AS IS" BASIS, WITHOUT |
| 83 | +WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the |
| 84 | +License for the specific language governing permissions and limitations under |
| 85 | +the License. |
0 commit comments