# App42

Client library and command-line tool to deploy and manage apps on App42PaaS.

## Installation

Install app42 like any other ruby gem:

### Linux
To install the client gem, you must have ruby installed on your system.

INSTALL THE NEEDED LIBRARIES

    $ sudo apt-get install zlib1g zlib1g-dev build-essential openssl libssl-dev libmysqlclient18 libmysqlclient-dev libyaml-dev

DOWNLOAD AND INSTALL RUBY 1.9.3

    $ sudo apt-get update    
    $ sudo apt-get install ruby1.9.3

INSTALL APP42 CLIENT 

    $ gem install app42-0.5.0.gem

Note: app42 require Ruby 1.9.2 or newer.

### Mac OS X

To install the client gem, you must have ruby installed on your system.
You can use MacPort to download and compile everything.

Install MacPort http://www.macports.org/
From a terminal window, install Ruby

    $ sudo port install ruby19 _nosuffix
    $ sudo port select --set ruby ruby19
    $ alias ruby='/opt/local/bin/ruby1.9'

INSTALL APP42 CLIENT 

    $gem install app42-0.5.0.gem

Note: app42 require Ruby 1.9.2 or newer.

### Windows

To install the client gem, you must have ruby installed on your system.

Download and install Ruby Installer(http://rubyinstaller.org/) for Windows and set ruby to your path to access App42 from command prompt.

Then got to command prompt from windows Start menu,  Open cmd and install App42 client.

    $ gem install app42-0.5.0.gem

Note: app42 require Ruby 1.9.2 or newer.

## Commands

Usage: app42 COMMAND [command-specific-options]
  
  App42 primary commands:
  
    keys            #  List keys of the current user
    keys:add        #  Configure API and secret keys on local system
    setup-infra     #  Create infrastructure
    deploy          #  Deploy application
    update          #  Update existing application
    scale           #  Scale application by number of instance
    descale         #  Descale application by number of instance
    service-create  #  Create a new service
    service-delete  #  Delete a provisioned service
  
  App42 additional commands:
  
    keys:clear      #  Clear all API and secret keys from local system
    apps            #  List deployed applications
    start           #  Start the application
    stop            #  Stop the application
    restart         #  Restart the application
    delete          #  Delete the application
    info            #  Show application information
    state           #  Show the application state
    services        #  List provisioned services
    app42-services  #  List the available services  
    iaas-providers  #  List the available IaaS providers
    runtimes        #  List the supported runtimes
    version         #  List version
    app42-update    #  List the App42PaaS client
    help            #  List help
    COMMAND --help  #  Display detailed help of specific command

## Usage

### $ app42 keys
  
  === Your keys ===
  
  API Key      = df1dcdb0-958c-0130-9368-3c970e529c4b
  
  Secret Key   = be9faaf56ff75bacae2ac9712b02c8feb8ffc6bb3381b60e1e9efccccd81086d
   
### $ app42 apps
  
    +-------------------------+------------+-----------------+---------------+---------+-------+
    |                                     === My Apps ===                                      |
    +-------------------------+------------+-----------------+---------------+---------+-------+
    | App url                 | App status | Container count | Iaas provider | Vm type | Name  |
    +-------------------------+------------+-----------------+---------------+---------+-------+
    | demo.aws.app42paas.com  | STOPPED    | 4               | Amazon        | Shared  | demo  |
    | demo1.aws.app42paas.com | RUNNING    | 1               | Amazon        | Shared  | demo1 |
    +-------------------------+------------+-----------------+---------------+---------+-------+

## Contributing

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request