Skip to content
Newer
Older
100644 113 lines (66 sloc) 4.75 KB
641b226 @indexzero [api] Start stubbing out clients and common methods
indexzero authored Feb 21, 2011
1 # jitsu
780a590 @Marak [misc] Updating ReadMe
Marak authored Apr 13, 2011
2 *Flawless command line deployment of Node.js apps to the cloud*
419bbe6 @Marak [docs] Spec'd out first round of API and documentation for review. So…
Marak authored Jan 31, 2011
3
0974136 @Marak [misc] Added new screenshot
Marak authored Apr 13, 2011
4 <img src="https://github.com/nodejitsu/jitsu/raw/master/test/jitsuscreenshot.png"/>
5
d2739f2 @Marak [misc] Updating Readme
Marak authored Apr 12, 2011
6 ## Overview
7
ccaea9f @Marak [misc] Updating ReadMe
Marak authored Apr 12, 2011
8 [Jitsu](http://github.com/nodejitsu/jitsu) is a [Command Line Tool (CLI)](http://en.wikipedia.org/wiki/Command-line_interface) for deploying Node.js applications to the cloud. It's open-source and easy to use. We've designed Jitsu to be suitable for command line beginners, but still be powerful and extensible enough for production usage. If you aren't a fan of the command line or don't have terminal access you can still do everything Jitsu can do through our web admin, [Samurai](http://nodejitsu.com).
d2739f2 @Marak [misc] Updating Readme
Marak authored Apr 12, 2011
9
7d508c8 @Marak [misc] Added npm link in ReadMe.
Marak authored Apr 13, 2011
10 Jitsu requires `npm`, the [node package manager](http://npmjs.org).
d2739f2 @Marak [misc] Updating Readme
Marak authored Apr 12, 2011
11
12
7db22b4 @Marak [misc] Updating ReadMe
Marak authored Apr 12, 2011
13 ## Installation
419bbe6 @Marak [docs] Spec'd out first round of API and documentation for review. So…
Marak authored Jan 31, 2011
14
b4aa28e @Marak [misc] Added links to Libaries section
Marak authored Apr 12, 2011
15 [sudo] npm install jitsu
419bbe6 @Marak [docs] Spec'd out first round of API and documentation for review. So…
Marak authored Jan 31, 2011
16
7db22b4 @Marak [misc] Updating ReadMe
Marak authored Apr 12, 2011
17 ## Features
18
780a590 @Marak [misc] Updating ReadMe
Marak authored Apr 13, 2011
19 Jitsu is built on some amazing technologies which we've been actively building with the community since 2009. jitsu is fully extend-able and extremely modular ( see [Libaries](#Libraries) section ).
d2739f2 @Marak [misc] Updating Readme
Marak authored Apr 12, 2011
20
7db22b4 @Marak [misc] Updating ReadMe
Marak authored Apr 12, 2011
21 - Allows for seamless deployment of your Node.js applications to the cloud
780a590 @Marak [misc] Updating ReadMe
Marak authored Apr 13, 2011
22 - Fully supports NPM dependency resolution on deployment to [Nodejitsu](http://nodejitsu.com)
ccaea9f @Marak [misc] Updating ReadMe
Marak authored Apr 12, 2011
23 - Full support of Nodejitu's API ( a plethora node.js goodies )
24 - Integrated multi-level multi-transport logging support via [Winston](http://github.com/indexzero/winston/)
25 - Too many to list... seek [further knowledge ](http://github.com/nodejitsu/handbook) or just try it out!
780a590 @Marak [misc] Updating ReadMe
Marak authored Apr 13, 2011
26
27 # Deploying a path to the cloud
28
29 cd /path/to/myapp
30 jitsu deploy
31
32 This will create a new application, package.json, and deploy your path to [Nodejitsu](http://nodejitsu.com). If it's your first deployment, you'll be prompted for some information such as *subdomain* and *start script* but it's really easy and we promise it will only take a few seconds.
33
34 If you have any issues deploying your node.js application please feel free to open up a Github support issues. We'll have someone get back to you in a flash!
35
7db22b4 @Marak [misc] Updating ReadMe
Marak authored Apr 12, 2011
36 ## Usage
ab8d16a @Marak [docs] Cleaning up
Marak authored Feb 2, 2011
37
ccaea9f @Marak [misc] Updating ReadMe
Marak authored Apr 12, 2011
38 Jistsu is mostly self documenting. After installation, run the `jitsu` command from your command line.
39
40 If it's your first time using `jitsu`, you will be prompted to login with an existing account or create a new account.
41
8908f49 @Marak Updating Readme
Marak authored Apr 12, 2011
42 <img src="https://github.com/nodejitsu/jitsu/raw/master/test/promptscreenshot.png"/>
ccaea9f @Marak [misc] Updating ReadMe
Marak authored Apr 12, 2011
43
f7d3313 @Marak [misc] Adde screenshot of prompt
Marak authored Apr 12, 2011
44 After you've logged in, you can start deploying apps immediately!
45
46 <img src="https://github.com/nodejitsu/jitsu/raw/master/test/screenshot.png"/>
47
ab8d16a @Marak [docs] Cleaning up
Marak authored Feb 2, 2011
48
780a590 @Marak [misc] Updating ReadMe
Marak authored Apr 13, 2011
49 ## Command Line Usage
ab8d16a @Marak [docs] Cleaning up
Marak authored Feb 2, 2011
50
992e62a @Marak Updating Readme
Marak authored Apr 12, 2011
51 `jitsu` is mostly self-documenting. Try any of these commands to get started.
52
780a590 @Marak [misc] Updating ReadMe
Marak authored Apr 13, 2011
53
54 **Usage:**
55
56 jitsu <resource> <action> <param1> <param2> ...
57
58 **Common Commands:**
59
60 *Deploys current path to [Nodejitsu](http://nodejitsu.com)*
61
62 jitsu deploy
63
64 *Creates a new application on [Nodejitsu](http://nodejitsu.com)*
65
66 jitsu create
67
68 *Lists all applications for the current user*
69
70 jitsu list
71
72 *Additional Commands*
73
74 jitsu apps
75 jitsu snapshots
76 jitsu users
77 jitsu conf
78 jitsu logout
79
80
81
ab8d16a @Marak [docs] Cleaning up
Marak authored Feb 2, 2011
82 ### Help
419bbe6 @Marak [docs] Spec'd out first round of API and documentation for review. So…
Marak authored Jan 31, 2011
83
780a590 @Marak [misc] Updating ReadMe
Marak authored Apr 13, 2011
84 Jitsu is mostly self documenting. We suggest just trying it out. All commands will yield friendly messages to you if you specify incorrect parameters. If you find anything difficult to use, please open up a Github issue or pull request!
85
e2cdf20 @indexzero [doc] Update README.md
indexzero authored Apr 9, 2011
86 jitsu help
87 jitsu help apps
88 jitsu help snapshots
89 jitsu help users
90 jitsu help config
419bbe6 @Marak [docs] Spec'd out first round of API and documentation for review. So…
Marak authored Jan 31, 2011
91
7e002ad @Marak [misc] Added .jitsuconf section to Readme
Marak authored Apr 12, 2011
92 ## .jitsuconf file
93
94 All configuration data for your local `jitsu` install is located in the *.jitsuconf* file located in your home directory. Directly modifying this file is not really advised. You should be able to make all configuration changes via:
95
96 jitsu config
f7d3313 @Marak [misc] Adde screenshot of prompt
Marak authored Apr 12, 2011
97
98 ## Libraries
b4aa28e @Marak [misc] Added links to Libaries section
Marak authored Apr 12, 2011
99 <a name="Libraries"></a>
780a590 @Marak [misc] Updating ReadMe
Marak authored Apr 13, 2011
100 The [Nodejitsu](http://nodejitsu.com) team and friends have been building and using these tools actively for the past two years. They are the most used Node libraries (see: [http://search.npmjs.org/](http://search.npmjs.org/)) and are actively maintained. Each tool serves a specific function and we highly suggest you check each one out individually if you wish to increase your knowledge of Node.js
b4aa28e @Marak [misc] Added links to Libaries section
Marak authored Apr 12, 2011
101
d4d8eae @Marak [ux] Updated deploy usage
Marak authored Apr 13, 2011
102 - [npm](http://npmjs.org) - Node Package Manager
f08a670 @Marak Updating ReadMe
Marak authored Apr 12, 2011
103 - [colors](http://github.com/marak/colors) - Terminal Colors module
104 - [optimist](http://github.com/substack/optimist) - CLI Options Parsing
105 - [request](http://github.com/mikeal/request) - http request module
106 - [async](https://github.com/caolan/async) - Asynchronous Iteration
107 - [vows](http://vowsjs.org) - Asynchronous BDD testing library
108 - [winston](http://github.com/indexzero/winston/) - Multi-transport logging library
109
5d9044f @Marak [misc] Added Aliases section in ReadMe
Marak authored Apr 12, 2011
110 ### Need more?
780a590 @Marak [misc] Updating ReadMe
Marak authored Apr 13, 2011
111 The documentation for `jitsu` and the [Nodejitsu](http://nodejitsu.com) APIs is open-source and a work in-progress. For more information checkout the [Nodejitsu Handbook](http://github.com/nodejitsu/handbook)
419bbe6 @Marak [docs] Spec'd out first round of API and documentation for review. So…
Marak authored Jan 31, 2011
112
780a590 @Marak [misc] Updating ReadMe
Marak authored Apr 13, 2011
113 #### (C) Copyright 2010, [Nodejitsu](http://nodejitsu.com) Inc.
Something went wrong with that request. Please try again.