RightScale CLI

Gem Version

RightScale CLI client. Currently in early development stages.

Installation

Ruby >= 1.9.1 is required.

Install the latest RubyGem from RubyGems.org:

$ gem install rightscale-cli

For more information, see https://rubygems.org/gems/rightscale-cli.

Mac OS X, FreeBSD

The executable, rs will conflict with RS(1) on Mac OS X (http://www.freebsd.org/cgi/man.cgi?query=rs&sektion=1&apropos=0&manpath=freebsd).

As a result, to avoid overwriting the /usr/bin/rs binary, use a different location in your ~/.gemrc or /etc/gemrc, for example:

gem: --bindir /usr/local/bin

Configuration

This can easily be done interactively with the tool once installed:

$ rs configure all

Or, manually setup ~/.rightscale/right_api_client.yml with your RightScale credentials. Ensure the correct shard for your account is set with :api_url. An example file is available, https://github.com/rightscale/right_api_client/blob/master/config/login.yml.example.

Usage

There is one command, rs.

  • For a list of commands, type rs help
  • For a list of subcommands, type rs <namespace> help, e.g. rs arrays help
  • For usage options of a subcommand, type rs <namespace> help <subcommand>, e.g. rs arrays help instances

License and Authors

  • Author:: Chris Fordham

  • Copyright:: 2013, Chris Fordham

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.