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/)