civo_cli 0.3.4 → 0.3.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a990a4394121647d574094b564c731d6c0b3d0c578449a7b3a3242d09073d11a
-  data.tar.gz: 2e9ab309f83c89f56939ced1394f46f4e412cdc8053526dc6b5084ca57a9328b
+  metadata.gz: 978698444b706bd68c75dbee0d66e847ae5deec7094e617667964c30971d9f23
+  data.tar.gz: 042c137693dc532f64f27873e36f3f182e7fd7d4a567d481b84b272118c54a7f
 SHA512:
-  metadata.gz: 02f29d1426fbeee3e56c7ebb536008694a9dd5eaec3af6047283656fa051d093a7d94909d3053ca8530ee0dceb8b3e6745e88f853996cf4a31f2322223c85eab
-  data.tar.gz: f5dae08ebcdf7f1e0e0c0206034cda730339932cc1c2ab22facc6a775c6a15ab96dca5ad58c15cb07d53ca00032341f6ebc6accc999602b1e89cd2d2a3a1fcb3
+  metadata.gz: 0ee196d1e1587e05fd0b09099151334a6264a65edec7446182d076d2a49119388d838e78bf37cfe4c48b2e1fb5e5a90bb7ec8c391796296e5d1de97f8a94ce6c
+  data.tar.gz: de0018540d48efd6b9c0b37d27fcc83a394b5fb3be095511e449a9fb2a694c3c10478390f486f92fa8742dfe3240071a28e79953b5fa575ad1615b3dfb9aacff

data/CHANGELOG.md

@@ -3,6 +3,14 @@ All notable changes to the Civo CLI will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.5] - 2019-07-11
+### Removed
+- Removed password from output of `instance show`
+
+### Added
+- `instance password` method to show initial user password for specific instance. Accepts --quiet (-q) to output single-line.
+- `--quiet (-q)` switch to `instance public_ip` to display output on single line.
+
 ## [0.3.4] - 2019-07-10
 ### Fixed
 - Template ID in `instance create` default wasn't working nicely, now defaults to Ubuntu if not provided and no snapshot specified

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    civo_cli (0.3.4)
+    civo_cli (0.3.5)
       bundler (~> 1.17)
       civo (>= 1.2.1)
       colorize

data/README.md

@@ -3,7 +3,7 @@
 ## Introduction
 Civo CLI is a tool to manage your [Civo.com](https://www.civo.com) account from the terminal. The [Civo web control panel](https://www.civo.com/account/) has a user-friendly interface for managing your account, but in case you want to automate or run scripts on your account, or have multiple complex services, the command-line interface outlined here will be useful. This guide will cover the set-up and usage of the Civo CLI tool with examples.
 
-**STATUS:** This project is currently under active development and maintainance.
+**STATUS:** This project is currently under active development and maintenance.
 
 ## Table of contents
 - [Introduction](#introduction)
@@ -99,7 +99,6 @@ $ civo instance show api-demo.test
           Firewall :  (rules: )
             Region : lon1
       Initial User : api-demouser
-  Initial Password : [randomly-assigned-password-here]
       OpenStack ID : 7c89f7de-2b29-4178-a2e5-55bdaa5c4c21
        Template ID : 811a8dfb-8202-49ad-b1ef-1e6320b20497
        Snapshot ID :
@@ -111,6 +110,26 @@ $ civo instance show api-demo.test
 
 You will be able to see the instance's details by running `civo instance show api-demo.test` as above.
 
+#### Viewing the Default User Password For an Instance
+You can view the default user's password for an instance by running `civo instance password ID/hostname`
+```
+$ civo instance password api-demo.test
+The password for user civo on api-demo.test is 5OaGxNhaN11pLeWB
+```
+You can also run this command with the option `-q` to get only the password output, useful for scripting situations:
+```
+$ civo instance password -q api-demo.test
+5OaGxNhaN11pLeWB
+```
+
+#### Viewing Instance Public IP Address
+If an instance has a public IP address configured, you can display it using `civo instance ip_address ID/hostname`:
+```
+$ civo instance ip_address -q api-demo.test
+91.211.152.100
+```
+The above example uses `-q` to display only the IP address in the output.
+
 #### Setting Firewalls
 Instances can make use of separately-configured firewalls. By default, an instance is created with no firewall rules set, so you will need to configure some rules (see [Firewalls](#firewalls) for more information).
 
@@ -174,7 +193,6 @@ $ civo instance show api-demo.test
           Firewall :  (rules: )
             Region : lon1
       Initial User : api-demouser
-  Initial Password : [randomly-assigned-password-here]
       OpenStack ID : 7c89f7de-2b29-4178-a2e5-55bdaa5c4c21
        Template ID : 811a8dfb-8202-49ad-b1ef-1e6320b20497
        Snapshot ID :
@@ -199,7 +217,6 @@ $ civo instance show api-demo-renamed.test
           Firewall :  (rules: )
             Region : lon1
       Initial User : api-demouser
-  Initial Password : [randomly-assigned-password-here]
       OpenStack ID : 7c89f7de-2b29-4178-a2e5-55bdaa5c4c21
        Template ID : 811a8dfb-8202-49ad-b1ef-1e6320b20497
        Snapshot ID :
@@ -255,7 +272,7 @@ $ civo kubernetes list
 +--------------------------------------+------+---------+-----------+--------+
 ```
 
-####  Create a cluster
+#### Create a cluster
 You can create an instance by running `civo kubernetes create` with a cluster name parameter, as well as any options you provide:
 
 * `size` -  The size of nodes to create, from the current list of sizes  available at [`civo sizes`](#sizes). Defaults to `g2.medium`.
@@ -474,8 +491,7 @@ $ civo quota
 +------------------+-------+-------+
 Any items in red are at least 80% of your limit
 ```
-If you have a legitimate need for a quota increase, visit the [
-](https://www.civo.com/account/quota) to place your request - we won't unreasonably withhold any increase, it's just in place so we can control the rate of growth of our platform and so that erran scripts using our API don't suddenly exhaust our available resources.
+If you have a legitimate need for a quota increase, visit the [Quota page](https://www.civo.com/account/quota) to place your request - we won't unreasonably withhold any increase, it's just in place so we can control the rate of growth of our platform and so that erran scripts using our API don't suddenly exhaust our available resources.
 
 ## Regions
 As Civo grows, more regions for hosting your instances will become available. You can run `civo region` to list the regions available. Block storage (Volumes) is region-specific, so if you configure an instance in one region, any volumes you wish to attach to that instance would have to be in the same region.
@@ -566,9 +582,9 @@ Removed SSH key cli-demo with ID 531d0998-4152-410a-af20-0cccb1c7c73b
 Civo instances are built from a template that specifies a disk image. Templates can contain the bare-bones OS install such as Ubuntu or Debian, or custom pre-configured operating systems that you can create yourself from a bootable volume. This allows you to speedily deploy pre-configured instances.
 
 #### Listing Available Template Images
-A simple list of available templates, both globally-defined ones and user-configured account-specific templates, can be seen by running `civo template list`:
+A simple list of available templates, both globally-defined ones and user-configured account-specific templates, can be seen by running `civo template list` or `civo template list --verbose` for maximum information:
 ```
-$ civo template list
+$ civo template list --verbose
 +--------------------------------------+----------------------+--------------------------------------+--------------------------------------+------------------+
 | ID                                   | Name                 | Image ID                             | Volume ID                            | Default Username |
 +--------------------------------------+----------------------+--------------------------------------+--------------------------------------+------------------+

data/lib/civo_cli/version.rb

@@ -1,3 +1,3 @@
 module CivoCLI
-  VERSION = "0.3.4"
+  VERSION = "0.3.5"
 end

data/lib/instance.rb

@@ -61,7 +61,6 @@ module CivoCLI
       puts "          Firewall : #{@firewall&.name} (rules: #{@firewall&.rules_count})"
       puts "            Region : #{instance.region}"
       puts "      Initial User : #{instance.initial_user}"
-      puts "  Initial Password : #{instance.initial_password}"
       if instance.ssh_key.present?
         key = ssh_keys.detect { |k| k.id == instance.ssh_key }
         puts "           SSH Key : #{key.name} (#{key.fingerprint})"
@@ -287,12 +286,17 @@ module CivoCLI
     end
 
     desc "public_ip ID/HOSTNAME", "Show public IP of ID/hostname"
+    option :quiet, type: :boolean, aliases: '-q'
     def public_ip(id)
       CivoCLI::Config.set_api_auth
   
       instance = detect_instance(id)
       unless instance.public_ip.nil?
-        puts instance.public_ip
+        if options[:quiet]
+          puts instance.public_ip
+        else
+          puts "The public IP for #{instance.hostname.colorize(:green)} is #{instance.public_ip.colorize(:green)}"
+        end
       else 
         puts "Error: Instance has no public IP"
         exit 2
@@ -303,6 +307,21 @@ module CivoCLI
       exit 1
     end
 
+    desc "password ID/HOSTNAME", "Show the default user password for instance with ID/HOSTNAME"
+    option :quiet, type: :boolean, aliases: '-q'
+    def password(id)
+      CivoCLI::Config.set_api_auth
+      instance = detect_instance(id)
+      if options[:quiet]
+        puts instance.initial_password
+      else
+        puts "The password for user #{instance.initial_user.colorize(:green)} on #{instance.hostname.colorize(:green)} is #{instance.initial_password.colorize(:green)}"
+      end
+    rescue Flexirest::HTTPException => e
+      puts e.result.reason.colorize(:red)
+      exit 1  
+    end
+  
     default_task :list
 
     private

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: civo_cli
 version: !ruby/object:Gem::Version
-  version: 0.3.4
+  version: 0.3.5
 platform: ruby
 authors:
 - Andy Jeffries