| 1 | # Huxley
|
| 2 |
|
| 3 | ### Automated Deployment for the Modern Web
|
| 4 | ---
|
| 5 |
|
| 6 | > **Warning:** This is an experimental project under heavy development. It's awesome and becoming even more so, but it is a work in progress.
|
| 7 |
|
| 8 | ## Overview
|
| 9 | Huxley manages the deployment of your application. It launches your app as a set of mixins, allocating the needed resources from your Amazon Web Services account. With simple, human-readable configuration and just a few commands, your app is up and running.
|
| 10 |
|
| 11 | We've focused on providing both developers and operations professionals a graceful workflow. It is a tool that does the heavy lifting for you while staying out of your way. Huxley aims to be like a more powerful, personal Heroku.
|
| 12 |
|
| 13 | We encourage you to learn more about Huxley by visiting [Huxley's wiki][1], which provides more detailed documentation.
|
| 14 |
|
| 15 |
|
| 16 | ## Requirements
|
| 17 | Huxley makes use of the ES6 technologies included in Node 0.12+ and CoffeeScript 1.9+. Tutorials in repository assume you have both installed. The following commands will setup Node and CoffeeScript on machines without these requirements.
|
| 18 | ```shell
|
| 19 | git clone https://github.com/creationix/nvm.git ~/.nvm
|
| 20 | source ~/.nvm/nvm.sh && nvm install 0.12
|
| 21 | npm install -g coffee-script
|
| 22 | ```
|
| 23 | Huxley's code uses two components, an API server and a CLI tool. The API wraps libraries that do cool things on your behalf. The CLI makes using Huxley easy. It accepts simple user commands and prepares the complex configurations that the API server needs.
|
| 24 |
|
| 25 | So, in summary, you need the CLI on your local machine and you need an API server running somewhere. For the API, you have three options:
|
| 26 |
|
| 27 | 1. You can use Panda Strike's API server that we have running for your convenience at `https://huxley.pandastrike.com`. Note the use of HTTPS. Connections to port 80 are rejected.
|
| 28 | 2. You can use an API server that someone else you know already has setup.
|
| 29 | 3. You can launch your own API server.
|
| 30 |
|
| 31 | If (1) or (2) describe your situation, make sure you know the API server's address and then read the [Huxley CLI Guide][2] next to learn how to get started on the CLI.
|
| 32 |
|
| 33 | If you wish to setup your own API server, please see the [Huxley API Guide][3] for a complete walkthrough.
|
| 34 |
|
| 35 |
|
| 36 | [1]:https://github.com/pandastrike/huxley/wiki
|
| 37 | [2]:https://github.com/pandastrike/huxley/wiki/Huxley-CLI-Guide
|
| 38 | [3]:https://github.com/pandastrike/huxley/wiki/Huxley-API-Guide
|