Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/softlayer/knife-softlayer


https://github.com/softlayer/knife-softlayer

knife ruby softlayer

Last synced: 29 days ago
JSON representation

Awesome Lists containing this project

README

        

# Knife::Softlayer
[![Gem Version](https://badge.fury.io/rb/knife-softlayer.png)](http://badge.fury.io/rb/knife-softlayer)
[![Build Status](https://api.travis-ci.org/softlayer/knife-softlayer.svg)](https://travis-ci.org/softlayer/knife-softlayer)
[![Dependency Status](https://gemnasium.com/softlayer/knife-softlayer.svg)](https://gemnasium.com/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.

```ruby
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] = ""
knife[:softlayer_api_key] = ""
```

## Usage

See `knife softlayer --help` for more information.

EXAMPLES:

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

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

```bash
# 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 \
--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](https://github.com/net-ssh/net-ssh/) - LICENSE: [MIT](https://github.com/net-ssh/net-ssh/blob/master/LICENSE.txt)
* [softlayer_api](https://github.com/softlayer/softlayer-api-ruby-client) - LICENSE: [MIT](https://github.com/softlayer/softlayer-api-ruby-client/blob/master/LICENSE.textile)
* [knife-windows](https://github.com/opscode/knife-windows) - LICENSE: [Apache v2](https://github.com/opscode/knife-windows/blob/master/LICENSE)

--
> Author:: Matt Eldridge ()
>
> © Copyright IBM Corporation 2014.
>
> LICENSE: Apache 2.0 (http://www.apache.org/licenses/)