hpcloud 2.0.0

data/CHANGELOG

@@ -0,0 +1,127 @@
+#HP Cloud Services UNIX CLI Release Notes
+
+##Release 2.0.0 Features##
+
+The 2.0.0 release is available for download from [https://docs.hpcloud.com/file/hpcloud-2.0.0.gem](/file/hpcloud-2.0.0.gem).  This release was made available on 6/15/2013 and contains the following new features:
+
+* Support for next generation networking cloud added, including the following features:
+  - `networks` commands
+  - `routers` commands
+  - `ports` commands
+  - `subnets` commands
+* Support for load balancer as a service (LBaaS) with the `lb` commands
+* Personality support for `servers:add`
+* The `containers:sync` command now takes a container or location for destination
+* The `servers:limits` command was added to print comput limits
+* The `servers:ratelimits` command was added to print comput limits
+* Object metadata can now be shown and set with `metadata` and `metadata:set`
+* Added --userpass option to account:setup and account:edit to allow authentication via user name and password rather than authentication keys.
+
+###Known Issues###
+
+* The `--bootable option` has been removed from the `volumes` (list) command
+* The v3 identity servers are not supported by this release
+
+##Release 1.9.0 Features##
+
+The 1.9.0 release is available for download from [https://docs.hpcloud.com/file/hpcloud-1.9.0.gem](/file/hpcloud-1.9.0.gem).  This release was made available on 5/15/2013 and contains the following new features:
+
+* Support for domain name service (DNS)
+* New `account:catalog` command dumps the service catalog for the given account
+* Default availability zone is now the alphabetically-first zone in the service catalog.
+
+###Known Issues###
+
+* Support for availability zones in the `config.yml` file is deprecated.  Support for that future will be removed in the future.  There are no longer any hard-coded default zones in the configuration.
+
+##Release 1.8.0 Features##
+
+The 1.8.0 release is available for download from [https://docs.hpcloud.com/file/hpcloud-1.8.0.gem](/file/hpcloud-1.8.0.gem).  This release was made available on 4/15/2013 and contains the following new features:
+
+* Support for the `after` and `at` options for the `remove` command added
+
+###Known Issues###
+
+* None for this release.
+
+
+##Release 1.7.0 Features##
+
+The 1.7.0 release is available for download from https://docs.hpcloud.com/file/hpcloud-1.7.0.gem.  This release was made available on 3/1/2013 and contains the following new features:
+
+* Support for large file uploads greater than 5 gigabytes added
+* Option `-r` (retry) to `copy` command for large file uploads added
+* Option `-c` option added to most reports so you can specify the columns they want to see
+* Option `-d` option added to most reports so you can specify the column delimiter for reports
+* Option `-l` added to provide a long listing for containers and their contents
+* Option `-u` added to `servers:add` to pass user data to a new server for custom configuration
+* New containers:sync command for container replication
+
+###Known Issues###
+
+* None for this release.
+
+##Release 1.6.0 Features##
+
+The 1.6.0 release is available for download from https://docs.hpcloud.com/file/hpcloud-1.6.0.gem.  This release was made available on 1/30/2013 and contains the following new features:
+
+* Compatibility with the 0.0.19 Ruby Fog release included
+* Command `servers:ssh` supports using an IP address in addition to the server name or ID added
+* Several minor bug fixes included
+
+###Known Issues###
+
+* None for this release.
+
+##Release 1.5.0 Features##
+
+The 1.5.0 release is available for download from https://docs.hpcloud.com/file/hpcloud-1.5.0.gem.  This release was made available on 1/18/2013 and contains the following new features:
+
+* Command `complete` added to install a bash completion file to allow you to tab complete hpcloud commands
+* Option `--debug` added to most commands to produce verbose trace
+* Option `--source-account` added to the `copy` command to allow files to be copied from one account to another.
+* Command `migrate` added to allow object store migration from different providers.
+* Option `--provider` added to the `account:setup` command to allow you to supply providers other than HP for migration.
+
+###Known Issues###
+
+* None for this release.
+
+##Release 1.4.0 Features##
+
+The 1.4.0 release is available for download from https://docs.hpcloud.com/file/hpcloud-1.4.0.gem.  This release was made available on 12/11/2012 and contains the following new features:
+
+* Command `servers:console` added to display the console of a server
+* Command `servers:ssh` added to allow you to log in via secure shell to a server
+* Command `keypairs:private` added to display the private keys known to the CLI
+* Command `keypairs:private` added to display the private keys known to the CLI
+* Command `keypairs:private:add` added to allow you to add a private key pair to the CLI
+* Command `keypairs:private:location` added to display the physical location of a private key file
+* Command `keypairs:private:remove` added to allow you to remove a private key
+* Command `account:verify` added to allow you to verify an account file
+* Command `account:edit` and `account:update` commands combined
+
+###Known Issues###
+
+* When the `-o` option is used to `keypairs:add` the private key is now stored in `~/.hpcloud/keypairs` directory instead of the current directory.
+
+##Release 1.3.0 Features##
+
+This release was made available on 12/6/2012 and contains the following new features:
+
+* Command `servers:rebuild` added
+* Option `-m` added to the `copy` command to allow you to override the mime type
+* Option `-s` added to the `cdn:containers:location` command to print the SSL and non-SSL URLs for CDN objects
+* Commands `cdn:containers:add` and `cdn:containers:remove` now accept multiple arguments
+* CLI help text significantly updated
+* Default account can be set to any configured account
+* Commands `acl:grant` and `acl:revoke` added to provide support for cross-project access control lists (ACLs)
+* Command `volumes:add` added to provide support for bootable volume creation
+* Command `servers:add` added to provide support for creating a server from a bootable volume
+
+**Note**: This release of the UNIX CLI requires the [Ruby Fog v0.0.18](https://docs.hpcloud.com/bindings/fog/install) binding.
+
+###Known Issues###
+
+* The syntax of the `servers:add` command has changed; you must pass in an image or volume with the `-i` or `-v` option, respectively
+* Command `acl` displays data as a table

data/LICENSE

@@ -0,0 +1 @@
+Copyright (c) 2011 Hewlett-Packard Development Company, L.P.

data/README.rdoc

@@ -0,0 +1,59 @@
+= Unix Command Line Interface
+
+The Unix Command Line Interface is a tool which allows Unix or Mac users to manage their HP Cloud Services from the command line.
+
+== System Requirements
+
+The current version of the CLI requires Ruby 1.9.2 or 1.8.7 and a recent version of rubygems (generally included with the ruby package).
+
+== Installation
+
+1) Start by installing the software, HP Cloud Unix CLI depends on:
+
+- HP Cloud Ruby Fog Binding[http://docs.hpcloud.com/bindings/fog]
+
+2) Download the HP Cloud Services Unix CLI gem[http://docs.hpcloud.com/cli/unix] and unpack it into a local directory.
+
+3) 'cd' into the directory, you downloaded the gem into during Step 2) and type:
+
+  gem install hpcloud-<version>.gem
+
+where <version> is the version number of the downloaded and unpacked gem file, for example 0.0.8
+
+You should see the gem and its dependencies being installed on your system. To verify installation, simply type:
+
+  hpcloud
+
+If you see a listing of available commands, your installation was successful.
+
+4) Once installation is complete you can set up your account:
+
+  hpcloud account:setup
+
+That’s it! Try out the usage examples below.
+
+If you should ever need to remove the CLI:
+
+  gem uninstall hpcloud
+
+= In-Command Help
+
+You can get a list of commands at any time by calling the hpcloud command without any arguments:
+
+  hpcloud
+
+Each command has help built in which includes specific examples of use, aliases you can use and more. To see help for a specific command use:
+
+  hpcloud help <command>
+
+If you want to check which version of the tool you have installed:
+
+  hpcloud info
+
+= Documentation and Usage
+
+Detailed documentation and usage examples can be found at HP Cloud Unix CLI[http://docs.hpcloud.com/cli/unix] page.
+
+= Copyright
+
+See LICENSE for copyright details.

data/bin/hpcloud

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+
+lib_dir = File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(lib_dir) if File.directory?(lib_dir) && !$LOAD_PATH.include?(lib_dir)
+
+ENV['HPCLOUD_CLI_NAME'] = File.basename($0)
+
+require 'rubygems'
+require 'hpcloud'
+
+HP::Cloud::CLI.start

data/completion/hpcloud

@@ -0,0 +1,372 @@
+_hpcloud()
+{
+  local cur prev opts cmds cmd files
+  COMPREPLY=()
+  _get_comp_words_by_ref -n : cur prev words
+
+  if [[ ${cur} == -* ]] ; then
+    if [ "${prev}" == "hpcloud" ]
+    then
+      cmd="hpcloud"
+    else
+      cmd="${words[1]}"
+    fi
+    case "${cmd}" in
+    hpcloud)
+      opts="--help --version"
+      ;;
+    account:catalog)
+      opts="--debug"
+      ;;
+    account:edit)
+      opts="--no-validate --provider"
+      ;;
+    account:setup)
+      opts="--no-validate --provider"
+      ;;
+    account:verify)
+      opts="--debug"
+      ;;
+    acl)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    acl:grant)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    acl:revoke)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    addresses)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    addresses:add)
+      opts="--floating-ip --fixed-ip --account-name --debug --port --availability-zone --network"
+      ;;
+    addresses:associate)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    addresses:disassociate)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    addresses:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    cdn:containers)
+      opts="--account-name --all --debug --availability-zone"
+      ;;
+    cdn:containers:add)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    cdn:containers:get)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    cdn:containers:location)
+      opts="--account-name --debug --availability-zone --ssl"
+      ;;
+    cdn:containers:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    cdn:containers:set)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    containers:add)
+      opts="--account-name --debug --availability-zone --force"
+      ;;
+    containers:remove)
+      opts="--account-name --debug --availability-zone --force"
+      ;;
+    containers:sync)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    copy)
+      opts="--mime --account-name --debug --restart --availability-zone --source-account"
+      ;;
+    dns)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    dns:add)
+      opts="--account-name --ttl --debug --availability-zone"
+      ;;
+    dns:records)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    dns:records:add)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    dns:records:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    dns:records:update)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    dns:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    dns:servers)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    dns:update)
+      opts="--account-name --ttl --debug --email --availability-zone"
+      ;;
+    flavors)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    get)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    images)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    images:add)
+      opts="--account-name --debug --availability-zone --metadata"
+      ;;
+    images:metadata)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    images:metadata:add)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    images:metadata:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    images:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    keypairs)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    keypairs:add)
+      opts="--private-key --account-name --debug --fingerprint --availability-zone --output"
+      ;;
+    keypairs:import)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    keypairs:public_key)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    keypairs:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    lb)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    lb:add)
+      opts="--account-name --debug --availability-zone --nodes --ips"
+      ;;
+    lb:algorithms)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    lb:limits)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    lb:nodes)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    lb:nodes:add)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    lb:nodes:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    lb:nodes:update)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    lb:protocols)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    lb:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    lb:update)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    lb:versions)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    lb:virtualips)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    list)
+      opts="--separator --sync --long --account-name --debug --availability-zone --columns"
+      ;;
+    location)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    metadata)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    metadata:set)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    migrate)
+      opts="--mime --account-name --debug --availability-zone"
+      ;;
+    move)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    networks)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    networks:add)
+      opts="--account-name --debug --availability-zone --adminstateup"
+      ;;
+    networks:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    networks:update)
+      opts="--account-name --debug --availability-zone --adminstateup"
+      ;;
+    ports)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    ports:add)
+      opts="--fixedips --macaddress --account-name --debug --adminstate --availability-zone --deviceid --deviceowner --securitygroups"
+      ;;
+    ports:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    ports:update)
+      opts="--fixedips --account-name --debug --adminstate --availability-zone --deviceid --deviceowner"
+      ;;
+    remove)
+      opts="--account-name --at --debug --after --availability-zone --force"
+      ;;
+    routers)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    routers:add)
+      opts="--account-name --debug --availability-zone --gateway --adminstateup"
+      ;;
+    routers:interface:add)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    routers:interface:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    routers:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    routers:update)
+      opts="--account-name --debug --availability-zone --gateway --adminstateup"
+      ;;
+    securitygroups)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    securitygroups:add)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    securitygroups:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    securitygroups:rules)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    securitygroups:rules:add)
+      opts="--direction --cidr --account-name --port-range --debug --source-group --availability-zone --ethertype"
+      ;;
+    securitygroups:rules:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    servers)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    servers:add)
+      opts="--personality --security-group --account-name --volume --debug --private-key-file --image --availability-zone --userdata --metadata --network --key-name"
+      ;;
+    servers:console)
+      opts="--dump-password --account-name --debug --private-key-file --availability-zone"
+      ;;
+    servers:limits)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    servers:metadata)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    servers:metadata:add)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    servers:metadata:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    servers:password)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    servers:ratelimits)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    servers:reboot)
+      opts="--account-name --hard --debug --availability-zone"
+      ;;
+    servers:rebuild)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    servers:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    servers:ssh)
+      opts="--command --account-name --debug --keypair --private-key-file --availability-zone --login"
+      ;;
+    snapshots)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    snapshots:add)
+      opts="--account-name --description --debug --availability-zone --metadata"
+      ;;
+    snapshots:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    subnets)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    subnets:add)
+      opts="--hostroutes --account-name --dhcp --debug --availability-zone --gateway --ipversion --dnsnameservers"
+      ;;
+    subnets:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    subnets:update)
+      opts="--hostroutes --account-name --dhcp --debug --availability-zone --gateway --ipversion --dnsnameservers"
+      ;;
+    tempurl)
+      opts="--account-name --debug --availability-zone --time-period --update"
+      ;;
+    volumes)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    volumes:add)
+      opts="--zone --account-name --description --debug --image --availability-zone --metadata --snapshot"
+      ;;
+    volumes:attach)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    volumes:detach)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    volumes:remove)
+      opts="--account-name --debug --availability-zone"
+      ;;
+    volumes:server)
+      opts="--separator --account-name --debug --availability-zone --columns"
+      ;;
+    esac
+    COMPREPLY=( $(compgen -W "${opts}" -- ${cur}) )
+    return 0
+  fi
+  if [ "${prev}" == "hpcloud" ]
+  then
+    cmds="account account:catalog account:copy account:edit account:remove account:setup account:use account:verify acl acl:grant acl:revoke addresses addresses:add addresses:associate addresses:disassociate addresses:remove cdn:containers cdn:containers:add cdn:containers:get cdn:containers:location cdn:containers:remove cdn:containers:set complete config config:set containers:add containers:remove containers:sync copy dns dns:add dns:records dns:records:add dns:records:remove dns:records:update dns:remove dns:servers dns:update flavors get help images images:add images:metadata images:metadata:add images:metadata:remove images:remove info keypairs keypairs:add keypairs:import keypairs:private keypairs:private:add keypairs:private:location keypairs:private:remove keypairs:public_key keypairs:remove lb lb:add lb:algorithms lb:limits lb:nodes lb:nodes:add lb:nodes:remove lb:nodes:update lb:protocols lb:remove lb:update lb:versions lb:virtualips list location metadata metadata:set migrate move networks networks:add networks:remove networks:update ports ports:add ports:remove ports:update remove routers routers:add routers:interface:add routers:interface:remove routers:remove routers:update securitygroups securitygroups:add securitygroups:remove securitygroups:rules securitygroups:rules:add securitygroups:rules:remove servers servers:add servers:console servers:limits servers:metadata servers:metadata:add servers:metadata:remove servers:password servers:ratelimits servers:reboot servers:rebuild servers:remove servers:ssh snapshots snapshots:add snapshots:remove subnets subnets:add subnets:remove subnets:update tempurl volumes volumes:add volumes:attach volumes:detach volumes:remove volumes:server"
+    COMPREPLY=( $(compgen -W "${cmds}" -- ${cur}) )
+    __ltrim_colon_completions "$cur"
+    return 0
+  fi
+
+  cmd="${words[1]}"
+  if [ "${cmd}" == "copy" ]
+  then
+    _compopt_o_filenames
+    COMPREPLY=( $( compgen -f -- "$cur" ) $( compgen -d -- "$cur" ) )
+    return 0
+  fi
+  return 0
+}
+complete -F _hpcloud hpcloud