softlayer/knife-softlayer

Knife::Softlayer

A Chef Knife plugin for launching, bootstrapping, and managing compute instances in the IBM SoftLayer cloud.

Installation

Add this line to your application's Gemfile:

gem 'knife-softlayer'

And then execute:

$ bundle

Or install it yourself as:

$ gem install knife-softlayer

Configuration

Add your SoftLayer username and API key to your knife.rb file.

log_level                :info
log_location             STDOUT
node_name                'node'
client_key               '/path/to/key.pem'
validation_client_name   'some-validator'
validation_key           '/path/to/validator.pem'
chef_server_url          'https://example.com/organizations/org'
syntax_check_cache_path  '/path/to/syntax_check_cache'
knife[:softlayer_username] = "<SOFTLAYER USERNAME>"
knife[:softlayer_api_key]  = "<SOFTLAYER API KEY>"

Usage

See knife softlayer --help for more information.

EXAMPLES:

# look at some options
user@local> knife softlayer flavor list [--all]

# the minimum number of pieces of flare
user@local> knife softlayer server create --hostname test --domain example.com --flavor tiny

# being sort of specific about things
user@local> knife softlayer server create -H test -D example.com \
--block-storage 0:25,2:100,5:1000 \ # device:GB, device:GB, ...
--network-interface-speed 1000 \
--cores 8 \
--ram 49152 \
--os-code REDHAT_6_64 \
--datacenter ams01 \
--node-name random-node-name \
--assign-global-ip <existingGlobalIpv4Address> \
--run-list 'recipe[apt],recipe[git],recipe[rbenv],recipe[memcached],recipe[redis]'

Legal stuff

Use of this software requires runtime dependencies. Those dependencies and their respective software licenses are listed below.

• net-ssh - LICENSE: MIT
• softlayer_api - LICENSE: MIT
• knife-windows - LICENSE: Apache v2

--

Author:: Matt Eldridge (matt.eldridge@us.ibm.com)

© Copyright IBM Corporation 2014.

LICENSE: Apache 2.0 (http://www.apache.org/licenses/)