app42 0.5.5 → 0.5.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: fcc7ecf3e3ddf5ba700f7e049b0bcdd7f7b5131b
-  data.tar.gz: e062a8719656e2f55035cc52151812d4bce24a77
+  metadata.gz: 90dc46498e65f25a67ad9bb2d9a1c2f07b784585
+  data.tar.gz: 0ab4c19a91dbe49a8998cd97081f1b3fd4532c45
 SHA512:
-  metadata.gz: dd24b119dc24f8d55246eab5f6f56d116c10a3b9e28c7f9d02475a2019b341717794aeafbc356a1732d0a2a1bc1819b9c1ebb6891dde0f41dcf9fd15528f7571
-  data.tar.gz: 769c63165bb11c3effec28e124d8c4848a925d592eb7ff7c7f4a0c9eb79d6925e3a1a88050cbfd06d1f11989ec95f2f1638323367f5dd36e642e569d905b18ec
+  metadata.gz: dfb5b2141d2c629fbcba1d03f6546bcec0a485c7936619ee73cece147d7b70f882838036d5d3091e3bedf47b37969aa4377b0948e630223d382bff941e2fc633
+  data.tar.gz: 56f5ddbdf0f7cd17c4407a2d1dedd0c9dcd172db0ec72a03f23a0b129d0aaee1cf6c085e2dc58c7598b2f7fd4e905c896ed424e08b278568b7aa473c1bb4b6c2

data/README.md

@@ -4,25 +4,39 @@ Client library and command-line tool to deploy and manage apps on App42PaaS.
 
 ## Installation
 
-Install app42 like any other ruby gem:
+You need to install and run the app42 client gem in your local environment on your development machine. Even if you already have the app42 client gem installed, it is good practice to run “gem install app42″ to make sure that you have the latest version of the gem.
+
+#### To install the client gem, you must have ruby installed on your system.
 
 ### Linux
-To install the client gem, you must have ruby installed on your system.
+
+Before you do anything else, You should install the below libraries to make sure that your system is ready to install ruby.
 
 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
+##### Install Ruby on Linux using apt-get tool
+
+Download and install ruby 1.9.3 (you may install latest ruby too)
 
     $ sudo apt-get update    
     $ sudo apt-get install ruby1.9.3
 
-INSTALL APP42 CLIENT 
+##### Install Ruby on Linux from source code.
 
-    $ gem install app42-0.5.0.gem
+Download ruby source code from Ruby Site
+
+     $ apt-get -y update
+     $ apt-get -y install build-essential zlib1g-dev libssl-dev libreadline6-dev libyaml-dev
+     $ cd /tmp
+     $ wget http://ftp.ruby-lang.org/pub/ruby/2.0/ruby-2.0.0-p0.tar.gz
+     $ tar -xvzf ruby-2.0.0-p0.tar.gz
+     $ cd ruby-2.0.0-p0/
+     $ ./configure --prefix=/usr/local
+     $ make 
+     $ make install 
 
-Note: app42 require Ruby 1.9.2 or newer.
 
 ### Mac OS X
 
@@ -36,79 +50,97 @@ From a terminal window, install Ruby
     $ 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.
+### Install App42 Client Gem
 
-    $ gem install app42-0.5.0.gem
+You can install app42 client like any other ruby gem.
 
-Note: app42 require Ruby 1.9.2 or newer.
+#### Note: app42 require Ruby 1.9.2 or newer.
+
+    $ gem install app42
 
 ## 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:
+    Usage: app42 COMMAND [command-specific-options]
   
-    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
+    Key
+     keys                    #  List API key and Secret key
+     addKeys                 #  Add API key and Secret key
+     clearKeys               #  Clear API key and Secret key
+
+    Applications 
+     setupInfra              #  Setup your deployment and runtime environment i.e. Instance(Memory, CPU) and Technology Stack
+     deploy                  #  Deploy the application over your runtime environment
+     update                  #  Update the application over your runtime environment
+     scale                   #  Scale application by number of instance(s)
+     descale                 #  Descale application by number of instance(s)
+     start                   #  Start the application
+     stop                    #  Stop the application
+     restart                 #  Restart the application
+     deleteInfra             #  Delete the Infrastructure environment
+     apps                    #  List all the deployed applications with their meta details
+     appInfo                 #  Show meta information of the application
+     appState                #  Show current state of the application
+     logs                    #  Returns the log file URL(s) for the application
+
+    Services 
+     createService           #  Creates a new service e.g. MySQL, MongoDB, CouchDB, PostgreSQL etc.
+     deleteService           #  Delete provisioned service
+     startService            #  Start the service
+     restartService          #  Restart the service
+     stopService             #  Stop the service
+     services                #  List all the provisioned services with their meta details
+     serviceInfo             #  Show meta information of the provisioned service
+     resetServicePassword    #  Reset password of provisioned service
+     bindIP                  #  Bind IP to provisioned service
+     unbindIP                #  Unbind IP from provisioned service
+     bindInfo                #  Show IP bind information related to provisioned service
+
+    Misc   
+     supportedServices       #  List supported services by App42
+     iaasProviders           #  List supported IaaS providers by App42
+     runtimes                #  List supported runtimes by App42
+     activities              #  List all activities with their status
+
+
+    Setup
+      setupCloudAPI          # Setup App42 cloud API by choosing required configuration
+      deleteCloudAPI         # Delete App42 cloud API setup
+      setupInfo              # Show setup information
+      setups                 # List all the setups
+
+    Help
+     version                 #  Show Ruby client gem version
+     help                    #  List available commands and their description
+     COMMAND --help          #  Display detailed help of a specific command
+
 
 ## Usage
 
 ### $ app42 keys
+
+    === API/Secret Key ===
   
-  === Your keys ===
-  
-  API Key      = df1dcdb0-958c-0130-9368-3c970e529c4b
+    API Key      = df1dcdb0-958c-0130-9368-3c970e529c4b
   
-  Secret Key   = be9faaf56ff75bacae2ac9712b02c8feb8ffc6bb3381b60e1e9efccccd81086d
+    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 |
-    +-------------------------+------------+-----------------+---------------+---------+-------+
+    +------------------------+------------+------------------+------+------------+----------------+--------+
+    |                                           === My Apps ===                                            |
+    +------------------------+------------+------------------+------+------------+----------------+--------+
+    | App Url                | App Status | Iaas Provider    | Name | Runtime    | Instance Count | Memory |
+    +------------------------+------------+------------------+------+------------+----------------+--------+
+    | demo.aws.app42paas.com | RUNNING    | Amazon us-west-2 | demo | Ruby 2.0.0 | 1              | 256 MB |
+    | demo1.aws.app42paas.com| STOPPED    | Amazon us-west-2 | demo1| Ruby 2.0.0 | 2              | 520 MB |
+    +------------------------+------------+------------------+------+------------+----------------+--------+
+
 
 ## Contributing
 

data/lib/app42/base/constants.rb

@@ -33,5 +33,4 @@ module App42
     # regex for IP Address
     IP_REGEX = /^([0]?\d\d?|1[0-1,3-9]\d|12[0-6,8-9]|2[0-4]d|25[0-5])\.([01]?\d\d?|2[0-4]\d|25[0-5])\.([01]?\d\d?|2[0-4]\d|25[0-5])\.((?!0)|(?!1)|010|(01[0-9]{1,1}&0[1-9]{1,2})|0[0-9]{1,1}[1-9]{1,1}|[2-9]{0,2}|1[0-9]{1,2}|2[0-4]\d|25[0-4])$/
 
-
 end

data/lib/app42/base/help.rb

@@ -6,16 +6,12 @@ module App42
   module Base
     class Help
       
-      #
-      # details how to use app42 commands
-      #
+      # details, how to use app42 commands
       def self.how_to
         Paint["Usage: app42 COMMAND [command-specific-options]", :blue]
       end
 
-      #
       # list available commands or display help for a specific command
-      #
       def self.commands
 
        print  <<-USAGE
@@ -30,6 +26,7 @@ module App42
   Applications 
    setupInfra              #  Setup your deployment and runtime environment i.e. Instance(Memory, CPU) and Technology Stack
    deploy                  #  Deploy the application over your runtime environment
+   update                  #  Update the application over your runtime environment
    scale                   #  Scale application by number of instance(s)
    descale                 #  Descale application by number of instance(s)
    start                   #  Start the application
@@ -44,6 +41,9 @@ module App42
   Services 
    createService           #  Creates a new service e.g. MySQL, MongoDB, CouchDB, PostgreSQL etc.
    deleteService           #  Delete provisioned service
+   startService            #  Start the service
+   restartService          #  Restart the service
+   stopService             #  Stop the service
    services                #  List all the provisioned services with their meta details
    serviceInfo             #  Show meta information of the provisioned service
    resetServicePassword    #  Reset password of provisioned service
@@ -57,6 +57,12 @@ module App42
    runtimes                #  List supported runtimes by App42
    activities              #  List all activities with their status
 
+  Setup
+    setupCloudAPI          #  Setup App42 cloud API by choosing required configuration
+    deleteCloudAPI         #  Delete App42 cloud API setup
+    setupInfo              #  Show setup information
+    setups                 #  List all the setups
+
   Help
    version                 #  Show Ruby client gem version
    help                    #  List available commands and their description
@@ -156,27 +162,26 @@ Example:
   1: Shared
   Select Instance Type [Shared]: 
 
-  1: Amazon US West-2a
-  Select IaaS Provider [Amazon US West-2a]: 1
-
-  1: Ruby 2.0
-  2: Java 6.0
-  3: Java 7.0
-  4: Php 5.3
-  5: Php 5.5
-  Select Runtime [Ruby 2.0]: 1
+  1: Amazon us-west-2
+  Select IaaS Provider [Amazon us-west-2]: 
 
-  1: Rails 4.0
-  Select Framework [Rails 4.0]: 
+  1: Ruby 2.0.0
+  2: Java 6
+  3: Java 7
+  4: PHP 5.3
+  5: PHP 5.5
+  Select Runtime [Ruby 2.0.0]: 
 
-  1: nginx 1.4.2
-  Select Web Server [nginx 1.4.2]: 
+  1: Ruby on Rack 
+  2: Rails 4.0
+  3: Sinatra 1.4
+  Select Framework [Ruby on Rack ]: 
 
-  1: 512 MB
-  2: 1024 MB
-  3: 2048 MB
-  Memory Limit [512 MB]: 
+  1: Nginx 1.4.1
+  Select Web Server [Nginx 1.4.1]: 
 
+  Specify Kontena Power: 5
+ 
   Setting up the infrastructure... OK
   
   Operation is in progress, Please wait.../
@@ -222,12 +227,40 @@ Options:
 Example:
   $app42 deploy
   Enter App Name: demo
-  Would you like to deploy from the current directory? [Yn]: n
-  Binary Deployment Path: /home/ubuntu/workspace/Deploycode/ruby
+  1: Binary
+  2: Source
+  Choose Upload Type [Binary]: 2
+
+  Enter Git URL?: https://github.com/shepHertz/demo.git
   Deploying Application... OK
-  Operation is in progress, Please wait....|
-  1 out of 1 Uploaded
-  Application deployed successfully.
+
+  Operation is in progress, Please wait...|
+  App deployed successfully.
+          DESC
+
+        end
+
+        def update
+          print <<-DESC
+Usage:
+  app42 update
+
+  Update the application over your runtime environment
+
+Options:
+  [--app APP]      # Name of app, you want to update
+
+Example:
+  $app42 update
+  Enter App Name: demo
+  1: Binary
+  2: Source
+  Choose Upload Type [Binary]: 2
+
+  Updating Application... OK
+
+  Operation is in progress, Please wait...-
+  App deployed successfully.
           DESC
 
         end
@@ -244,7 +277,14 @@ Options:
 
 Example:
   $app42 start --app demo
-  Starting app demo ...Done
+  Starting Application demo... OK
+
+  Operation is in progress, Please wait...
+  1 out of 3 started
+  -
+  2 out of 3 started
+  |
+  App started successfully.
           DESC
 
         end
@@ -261,7 +301,14 @@ Options:
 
 Example:
   $app42 stop --app demo
-  Stopping app demo ...Done
+  Stopping Application demo... OK
+
+  Operation is in progress, Please wait...-
+  1 out of 3 stopped
+  -
+  2 out of 3 stopped
+  -
+  App stopped successfully.
           DESC
         end
 
@@ -277,7 +324,14 @@ Options:
 
 Example:
   $app42 start --app demo
-  Restarting app demo ...Done
+  Restarting Application demo... OK
+
+  Operation is in progress, Please wait...
+  1 out of 3 restarted
+  -
+  2 out of 3 restarted
+  |
+  App restarted successfully.
           DESC
         end
 
@@ -293,7 +347,14 @@ Options:
 
 Example:
   $app42 deleteInfra --app demo
-  Deleting app demo ...Done
+  Deleting Application demo... OK
+
+  Operation is in progress, Please wait...
+  1 out of 3 deleted
+  -
+  2 out of 3 deleted
+  |
+  App deleted successfully.
           DESC
         end
 
@@ -308,11 +369,14 @@ Options:
   [--app APP]      # Name of app, you want to descale
 
 Example:
-  $app42 descale --app demo
-  Descale by instance(s): 1
-  Descaling Application demo by instance 1... OK
-  
+  $app42 descale
+  Enter App Name: demo
+  Descale by instance(s) [1]: 2
+  Descaling Application demo by instance 2... OK
+
   Operation is in progress, Please wait...|
+  1 out of 2 descaled
+  -
   Descale completed successfully.
           DESC
         end
@@ -328,11 +392,14 @@ Options:
   [--app APP]      # Name of app, you want to scale
 
 Example:
-  $app42 scale --app demo
-  Scale by instance(s): 1
-  Scaling Application demo by instance 1... OK
-  
-  Operation is in progress, Please wait...|
+  $app42 scale
+  Enter App Name: demo
+  Scale by instance(s) [1]: 2
+  Scaling Application demo by instance 2... OK
+
+  Operation is in progress, Please wait...-
+  1 out of 2 scaled
+  |
   Scale completed successfully.
           DESC
         end
@@ -412,27 +479,23 @@ Usage:
 Example:
   $app42 createService
   Enter Service Name: mysqldemo
-
   Checking Service Name Availability... OK
 
-  1: MySQL 5.5.1
-  2: Mongodb 2.4
-  3: Couchdb 10.1
-  4: PostgreSQL 9.1
-  Select Service [MySQL 5.5.1]: 1
+  1: MySQL 5.5.31
+  2: Mongodb 2.4.4
+  3: Couchdb 1.0.1
+  4: PostgreSQL 9.1.9
+  Select Service [MySQL 5.5.31]: 
 
-  Enter Database Name: demodb  
+  Enter Database Name: demo_db
 
   1: Shared
-  Select Virtual Machine Type [Shared]: 
+  Select Instance Type [Shared]: 
 
-  1: Amazon US West-2a
-  Select IaaS Provider [Amazon US West-2a]: 1
+  1: Amazon us-west-2
+  Select IaaS Provider [Amazon us-west-2]: 
 
-  1: 512 MB
-  2: 1024 MB
-  3: 2048 MB
-  Memory Limit [512 MB]: 1
+  Specify Kontena Power: 5
 
   Creating Service... OK
   
@@ -470,6 +533,69 @@ Example:
           DESC
         end
 
+        def startservice
+          print <<-DESC
+Usage:
+  app42 startService
+
+  Start the service
+
+Options:
+  [--app Service]      # Name of service, you want to start
+
+Example:
+  $app42 startService
+  Enter Service Name: mysql
+  Starting Service mysql... OK
+
+  Operation is in progress, Please wait...|
+  Service started successfully.
+          DESC
+
+        end
+
+        def stopservice
+          print <<-DESC
+Usage:
+  app42 stopService
+
+  Stop the service
+
+Options:
+  [--app Service]      # Name of service, you want to start
+
+Example:
+  $app42 stopService
+  Enter Service Name: mysql
+  Stopping Service mysql... OK
+
+  Operation is in progress, Please wait...|
+  Service stopped successfully.
+          DESC
+
+        end
+
+        def restartservice
+          print <<-DESC
+Usage:
+  app42 restartService
+
+  Restart the service
+
+Options:
+  [--app Service]      # Name of service, you want to start
+
+Example:
+  $app42 restartService
+  Enter Service Name: mysql
+  Restarting Service mysql... OK
+
+  Operation is in progress, Please wait...|
+  Service restarted successfully.
+          DESC
+
+        end
+
         def services
           print <<-DESC
 Usage:
@@ -720,6 +846,97 @@ Example:
           DESC
       end
 
+      def setupcloudapi
+        print <<-DESC
+Usage:
+  app42 setupCloudAPI
+
+  Setup App42 cloud API by choosing required configuration
+
+Example:
+  $app42 setupCloudAPI
+  Enter Setup Name: railsdemo
+  Checking Setup Name Availability... OK
+
+  1: Shared
+  Select Instance Type [Shared]: 
+
+  1: Amazon us-west-2
+  Select IaaS Provider [Amazon us-west-2]: 
+
+  1: App42CloudAPI
+  Select Setup Type [App42CloudAPI]: 
+
+  1: Light
+  2: Medium
+  3: Heavy
+  Select Flavour [Light]: 1
+
+  Setting up the infrastructure... OK
+
+  Operation is in progress, Please wait...|
+
+  Your setup has been completed successfully, For details, Login to your AppHQ console.
+
+          DESC
+      end
+
+      def deletecloudapi
+        print <<-DESC
+Usage:
+  app42 deleteCloudAPI
+
+  Delete App42 cloud API setup
+
+Example:
+  $app42 deleteCloudAPI
+  Enter Setup Name: demo
+  Deleting Cloud API... OK
+
+  Operation is in progress, Please wait...-
+  Setup deleted successfully.
+          DESC
+      end
+
+      def setupinfo
+        print <<-DESC
+Usage:
+  app42 setupInfo
+
+  Show setup information
+
+Example:
+  $app42 setupInfo
+  Enter Setup Name: demo
+  +-----------------------+--------------------------------+------------+------------------+------------+---------+---------------+--------------+-----------------------------+
+  |                                                                            === demo Details ===                                                                            |
+  +-----------------------+--------------------------------+------------+------------------+------------+---------+---------------+--------------+-----------------------------+
+  | Created On            | Api Server Url                 | Setup Name | Iaas Provider    | Setup Type | Vm Type | Setup Flavour | Setup Status | App Hq Url                  |
+  +-----------------------+--------------------------------+------------+------------------+------------+---------+---------------+--------------+-----------------------------+
+  | 2013-10-16 13:05:12.0 | democloudapi.aws.app42paas.com | demo       | Amazon us-west-2 | CLOUDAPI   | Shared  | light         | RUNNING      | demoapphq.aws.app42paas.com |
+  +-----------------------+--------------------------------+------------+------------------+------------+---------+---------------+--------------+-----------------------------+
+          DESC
+      end
+
+      def setups
+        print <<-DESC
+Usage:
+  app42 setups
+
+  List all the setups
+
+Example:
+  $app42 setups
+  +-----------------------+--------------------------------+------------+------------------+------------+---------+---------------+--------------+-----------------------------+
+  |                                                                            === Setups List ===                                                                             |
+  +-----------------------+--------------------------------+------------+------------------+------------+---------+---------------+--------------+-----------------------------+
+  | Created On            | Api Server Url                 | Setup Name | Iaas Provider    | Setup Type | Vm Type | Setup Flavour | Setup Status | App Hq Url                  |
+  +-----------------------+--------------------------------+------------+------------------+------------+---------+---------------+--------------+-----------------------------+
+  | 2013-10-16 13:05:12.0 | democloudapi.aws.app42paas.com | demo       | Amazon us-west-2 | CLOUDAPI   | Shared  | light         | RUNNING      | demoapphq.aws.app42paas.com |
+  +-----------------------+--------------------------------+------------+------------------+------------+---------+---------------+--------------+-----------------------------+
+          DESC
+      end
+
       def version
         print <<-DESC
 Usage: