knife-rackspace 0.11.1 → 1.0.0

data/spec/integration_spec_helper.rb

@@ -1,7 +1,7 @@
-require 'spec_helper'
-require 'vcr'
-require 'ansi/code'
-require 'ansi/diff'
+require "spec_helper"
+require "vcr"
+require "ansi/code"
+require "ansi/diff"
 
 Chef::Config[:knife][:rackspace_api_username] = "#{ENV['OS_USERNAME']}"
 Chef::Config[:knife][:rackspace_api_key] = "#{ENV['OS_PASSWORD']}"
@@ -9,28 +9,28 @@ Chef::Config[:knife][:ssl_verify_peer] = false
 # Chef::Config[:knife][:rackspace_version] = "#{ENV['RS_VERSION']}"
 
 VCR.configure do |c|
-  c.cassette_library_dir = 'spec/cassettes'
+  c.cassette_library_dir = "spec/cassettes"
   c.hook_into :excon
   c.configure_rspec_metadata!
 
   # Sensitive data
-  c.filter_sensitive_data('_RAX_USERNAME_') { Chef::Config[:knife][:rackspace_api_username] }
-  c.filter_sensitive_data('_RAX_PASSWORD_') { Chef::Config[:knife][:rackspace_api_key] }
-  c.filter_sensitive_data('_CDN-TENANT-NAME_') { ENV['RS_CDN_TENANT_NAME'] }
-  c.filter_sensitive_data('000000') { ENV['RS_TENANT_ID'] }
+  c.filter_sensitive_data("_RAX_USERNAME_") { Chef::Config[:knife][:rackspace_api_username] }
+  c.filter_sensitive_data("_RAX_PASSWORD_") { Chef::Config[:knife][:rackspace_api_key] }
+  c.filter_sensitive_data("_CDN-TENANT-NAME_") { ENV["RS_CDN_TENANT_NAME"] }
+  c.filter_sensitive_data("000000") { ENV["RS_TENANT_ID"] }
 
   c.before_record do |interaction|
     # Sensitive data
-    filter_headers(interaction, /X-\w*-Token/, '_ONE-TIME-TOKEN_')
+    filter_headers(interaction, /X-\w*-Token/, "_ONE-TIME-TOKEN_")
 
     # Transient data (trying to avoid unnecessary cassette churn)
-    filter_headers(interaction, 'X-Compute-Request-Id', '_COMPUTE-REQUEST-ID_')
-    filter_headers(interaction, 'X-Varnish', '_VARNISH-REQUEST-ID_')
+    filter_headers(interaction, "X-Compute-Request-Id", "_COMPUTE-REQUEST-ID_")
+    filter_headers(interaction, "X-Varnish", "_VARNISH-REQUEST-ID_")
 
     # Throw away build state - just makes server.wait_for loops really long during replay
     begin
       json = JSON.parse(interaction.response.body)
-      if json['server']['status'] == 'BUILD'
+      if json["server"]["status"] == "BUILD"
         # Ignoring interaction because server is in BUILD state
         interaction.ignore!
       end
@@ -38,21 +38,21 @@ VCR.configure do |c|
     end
   end
 
-  c.before_playback do | interaction |
-    interaction.filter!('_TENANT-ID_', '0000000')
+  c.before_playback do |interaction|
+    interaction.filter!("_TENANT-ID_", "0000000")
   end
 
   c.default_cassette_options = {
     # :record => :none,
     # Ignores cache busting parameters.
-    :match_requests_on => [:host, :path]
+    :match_requests_on => [:host, :path],
   }
-  c.default_cassette_options.merge!({:record => :all}) if ENV['INTEGRATION_TESTS'] == 'live'
+  c.default_cassette_options.merge!({ :record => :all }) if ENV["INTEGRATION_TESTS"] == "live"
 end
 
 def filter_headers(interaction, pattern, placeholder)
-  [interaction.request.headers, interaction.response.headers].each do | headers |
-    sensitive_tokens = headers.select{|key| key.to_s.match(pattern)}
+  [interaction.request.headers, interaction.response.headers].each do |headers|
+    sensitive_tokens = headers.select { |key| key.to_s.match(pattern) }
     sensitive_tokens.each do |key, value|
       headers[key] = placeholder
     end
@@ -67,8 +67,8 @@ end
 
 def clean_output(output)
   output = ANSI.unansi(output)
-  output.gsub!(/\s+$/,'')
-  output.gsub!("\e[0G", '')
+  output.gsub!(/\s+$/, "")
+  output.gsub!("\e[0G", "")
   output
 end
 
@@ -77,7 +77,7 @@ RSpec::Matchers.define :match_output do |expected_output|
     clean_output(actual_output) == expected_output.strip
   end
   # Nice when it works, but has ANSI::Diff has some bugs that prevent it from showing any output
-  failure_message_for_should do |actual_output|
+  failure_message do |actual_output|
     buffer = StringIO.new
     buffer.puts clean_output(actual_output)
     buffer.puts
@@ -87,18 +87,18 @@ RSpec::Matchers.define :match_output do |expected_output|
     # ANSI::Diff.new(output, expected_output)
   end
   description do
-    'Compare actual and expected output, ignoring ansi color and trailing whitespace'
+    "Compare actual and expected output, ignoring ansi color and trailing whitespace"
   end
 end
 
 def server_list
-  stdout, stderr, status = knife_capture('rackspace server list')
+  stdout, stderr, status = knife_capture("rackspace server list")
   status == 0 ? stdout : stderr
 end
 
 def capture_instance_data(stdout, labels = {})
   result = {}
-  labels.each do | key, label |
+  labels.each do |key, label|
     result[key] = clean_output(stdout).match(/^#{label}: (.*)$/)[1]
   end
   result
@@ -106,8 +106,8 @@ end
 
 # Ideally this belongs in knife-dsl, but it causes a scoping conflict with knife.rb.
 # See https://github.com/chef-workflow/knife-dsl/issues/2
-def knife_capture(command, args=[], input=nil)
-  null = Gem.win_platform? ? File.open('NUL:', 'r') : File.open('/dev/null', 'r')
+def knife_capture(command, args = [], input = nil)
+  null = Gem.win_platform? ? File.open("NUL:", "r") : File.open("/dev/null", "r")
 
   if defined? Pry
     Pry.config.input = STDIN
@@ -118,9 +118,9 @@ def knife_capture(command, args=[], input=nil)
   $VERBOSE = nil
   old_stderr, old_stdout, old_stdin = $stderr, $stdout, $stdin
 
-  $stderr = StringIO.new('', 'r+')
-  $stdout = StringIO.new('', 'r+')
-  $stdin = input ? StringIO.new(input, 'r') : null
+  $stderr = StringIO.new("", "r+")
+  $stdout = StringIO.new("", "r+")
+  $stdin = input ? StringIO.new(input, "r") : null
   $VERBOSE = warn
 
   status = Chef::Knife::DSL::Support.run_knife(command, args)

data/spec/spec_helper.rb

@@ -1,3 +1,3 @@
-$:.unshift File.expand_path('../../lib', __FILE__)
-require 'chef/knife/bootstrap'
-require 'chef/knife/rackspace_base'
+$:.unshift File.expand_path("../../lib", __FILE__)
+require "chef/knife/bootstrap"
+require "chef/knife/rackspace_base"

data/spec/unit/rackspace_base_spec.rb

@@ -1,7 +1,7 @@
-require 'spec_helper'
+require "spec_helper"
 
-require 'chef/knife/rackspace_base'
-require 'chef/knife'
+require "chef/knife/rackspace_base"
+require "chef/knife"
 
 class RackspaceBaseTester < Chef::Knife
   include Chef::Knife::RackspaceBase
@@ -15,7 +15,7 @@ describe "auth_endpoint" do
     Chef::Config[:knife][:rackspace_auth_url] = test_url
     Chef::Config[:knife][:rackspace_region] = :ord
 
-    tester.auth_endpoint.should == test_url
+    expect(tester.auth_endpoint).to eq(test_url)
   end
 
   [:dfw, :ord, :syd].each do |region|
@@ -24,15 +24,15 @@ describe "auth_endpoint" do
       Chef::Config[:knife][:rackspace_auth_url] = nil
       Chef::Config[:knife][:rackspace_region] = region
 
-      tester.auth_endpoint.should == ::Fog::Rackspace::US_AUTH_ENDPOINT
+      expect(tester.auth_endpoint).to eq(::Fog::Rackspace::US_AUTH_ENDPOINT)
     end
   end
 
   it "should pick the UK end point if the region is :lon" do
     tester = RackspaceBaseTester.new
     Chef::Config[:knife][:rackspace_auth_url] = nil
-    Chef::Config[:knife][:rackspace_region] = 'lon'
+    Chef::Config[:knife][:rackspace_region] = "lon"
 
-    tester.auth_endpoint.should == ::Fog::Rackspace::UK_AUTH_ENDPOINT
+    expect(tester.auth_endpoint).to eq(::Fog::Rackspace::UK_AUTH_ENDPOINT)
   end
-end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: knife-rackspace
 version: !ruby/object:Gem::Version
-  version: 0.11.1
+  version: 1.0.0
 platform: ruby
 authors:
 - Adam Jacob
@@ -12,106 +12,50 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-05-03 00:00:00.000000000 Z
+date: 2016-11-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: knife-windows
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: fog
+  name: fog-rackspace
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.35'
+        version: '0.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.35'
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: chef
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 11.0.0
+        version: '12.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 11.0.0
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: vcr
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: ansi
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+        version: '12.0'
 description: Rackspace Support for Chef's Knife Command
 email:
 - adam@chef.io
@@ -121,16 +65,17 @@ email:
 executables: []
 extensions: []
 extra_rdoc_files:
-- README.rdoc
+- README.md
 - LICENSE
 files:
-- .chef/knife.rb
-- .gitignore
-- .travis.yml
+- ".chef/knife.rb"
+- ".github/ISSUE_TEMPLATE.md"
+- ".gitignore"
+- ".travis.yml"
 - CHANGELOG.md
 - Gemfile
 - LICENSE
-- README.rdoc
+- README.md
 - Rakefile
 - knife-rackspace.gemspec
 - lib/chef/knife/rackspace_base.rb
@@ -160,17 +105,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.2.2
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
 summary: Rackspace Support for Chef's Knife Command

data/README.rdoc

@@ -1,225 +0,0 @@
-= Knife Rackspace
-
-{<img src="https://travis-ci.org/chef/knife-rackspace.svg?branch=master" alt="Build Status" />}[https://travis-ci.org/chef/knife-rackspace]
-
-= DESCRIPTION:
-
-This is the official Opscode Knife plugin for Rackspace Cloud Servers. This plugin gives knife the ability to create, bootstrap, and manage servers on all the regions for Rackspace Cloud Servers.
-
-= INSTALLATION:
-
-Be sure you are running the latest version Chef. Versions earlier than 0.10.0 don't support plugins:
-
-    gem install chef
-
-This plugin is distributed as a Ruby Gem. To install it, run:
-
-    gem install knife-rackspace
-
-Depending on your system's configuration, you may need to run this command with root privileges.
-
-Ensure only the latest knife-rackspace gem and no other is installed.  In some cases having older versions of the gem
-will cause the new OpenStack functionality not to function properly.  To check:
-
-    $> gem list --local | grep knife-rackspace
-    knife-rackspace (0.6.2, 0.5.12)
-    $> gem uninstall knife-rackspace -v "= 0.5.12"
-    Successfully uninstalled knife-rackspace-0.5.12
-    $> gem list --local | grep knife-rackspace
-    knife-rackspace (0.6.2)
-
-
-= CONFIGURATION:
-
-In order to communicate with the Rackspace Cloud API you will have to tell Knife about your Username and API Key. The easiest way to accomplish this is to create some entries in your <tt>knife.rb</tt> file:
-
-    knife[:rackspace_api_username] = "Your Rackspace API username"
-    knife[:rackspace_api_key] = "Your Rackspace API Key"
-
-If your knife.rb file will be checked into a SCM system (ie readable by others) you may want to read the values from environment variables:
-
-    knife[:rackspace_api_username] = "#{ENV['RACKSPACE_USERNAME']}"
-    knife[:rackspace_api_key] = "#{ENV['RACKSPACE_API_KEY']}"
-
-You also have the option of passing your Rackspace API Username/Key into the individual knife subcommands using the <tt>-A</tt> (or <tt>--rackspace-api-username</tt>) <tt>-K</tt> (or <tt>--rackspace-api-key</tt>) command options
-
-    # provision a new 1GB Ubuntu 10.04 webserver
-    knife rackspace server create -I 112 -f 3 -A 'Your Rackspace API username' -K "Your Rackspace API Key" -r 'role[webserver]'
-
-To select for the previous Rackspace API (aka 'v1'), you can use the <tt>--rackspace-version v1</tt> command option. 'v2' is the default, so if you're still using exclusively 'v1' you will probably want to add the following to your <tt>knife.rb</tt>:
-
-    knife[:rackspace_version] = 'v1'
-
-This plugin also has support for authenticating against an alternate API Auth URL. This is useful if you are a using a custom endpoint, here is an example of configuring your <tt>knife.rb</tt>:
-
-    knife[:rackspace_auth_url] = "auth.my-custom-endpoint.com"
-
-
-Different regions can be specified by using the `--rackspace-region` switch or using the `knife[:rackspace_region]` in the knife.rb file. Valid regions include :dfw, :ord, :lon, and :syd.
-
-If you are behind a proxy you can specify it in the knife.rb file as follows:
-
-    https_proxy https://PROXY_IP_ADDRESS:PORT
-
-SSL certificate verification can be disabled by include the following in your knife.rb file:
-
-    knife[:ssl_verify_peer] = false
-
-Additionally the following options may be set in your <tt>knife.rb</tt>:
-
-* flavor
-* image
-* distro
-* template_file
-
-= SUBCOMMANDS:
-
-This plugin provides the following Knife subcommands. Specific command options can be found by invoking the subcommand with a <tt>--help</tt> flag
-
-== knife rackspace server create
-
-Provisions a new server in the Rackspace Cloud and then perform a Chef bootstrap (using the SSH protocol). The goal of the bootstrap is to get Chef installed on the target system so it can run Chef Client with a Chef Server. The main assumption is a baseline OS installation exists (provided by the provisioning). It is primarily intended for Chef Client systems that talk to a Chef server. By default the server is bootstrapped using the {chef-full}[https://github.com/opscode/chef/blob/master/chef/lib/chef/knife/bootstrap/chef-full.erb] template. This can be overridden using the <tt>-d</tt> or <tt>--template-file</tt> command options.
-
-If no name is provided, nodes created with  the v1 API are named after their instance ID, with the v2 API they are given a random 'rs-XXXXXXXXX' name.
-
-Files can be injected onto the provisioned system using the <tt>--file</tt> switch. For example to inject <tt>my_script.sh</tt> into <tt>/root/initialize.sh</tt> you would use the following switch
-
-    --file /root/initialize.sh=my_script.sh.
-
-Note: You can only inject text files and the maximum destination path is 255 characters.
-
-You may specify if want to manage your disk partitioning scheme with the <tt>--rackspace-disk-config DISKCONFIG</tt> option. If you bootstrap a `v2` node and leave this set to the default "AUTO", larger nodes take longer to bootstrap as it grows the disk from 10G to fill the full amount of local disk provided. This option allows you to pass "MANUAL" - which give you a node (in 1/2 to 1/4 of the time) and lets you manage ignoring, or formatting the rest of the disk on your own.
-
-http://docs.openstack.org/essex/openstack-compute/starter/content/Launch_and_manage_instances-d1e1885.html
-
-You may specify a custom network using the <tt>--network [LABEL_OR_ID]</tt> option. You can also remove the default internal ServiceNet and PublicNet networks by specifying the <tt>--no-default-networks</tt> switch. To use a network other than PublicNet for the bootstrap connection, specify the <tt>--bootstrap-network LABEL</tt> option.
-
-Note: If you are using one of the `performanceX-X` machines, you need to put `-f` or `--flavor` in quotes.
-
-=== Windows
-
-Windows Servers require special treatment with the knife-rackspace gem.
-
-First, you'll need to ensure you've installed the knife-windows gem. Installation instructions can be found over here: http://docs.opscode.com/plugin_knife_windows.html#install-this-plugin
-
-Secondly, you need to make sure that the image you're using has WinRM pre-configured. Unfortuantely, none of the Rackspace Windows image have this done by default, so you'll need to run the following instructions in a Windows machine, then save a Snapshot to use when creating servers with knife rackspace: http://docs.opscode.com/plugin_knife_windows.html#requirements
-
-Thirdly, you must pass two extra parameters to the knife rackspace create command:
-
-    --bootstrap-protocol winrm --distro windows-chef-client-msi
-    
-If you have troubles, make sure you add the <tt>-VV</tt> switch for extra verbosity. The <tt>--server-create-timeout </tt> switch may also be your friend, as Windows machines take a long time to build compared to Linux ones.
-
-== knife rackspace server delete
-
-Deletes an existing server in the currently configured Rackspace Cloud account by the server/instance id. You can find the instance id by entering <tt>knife rackspace server list</tt>. Please note - this does not delete the associated node and client objects from the Chef server unless you pass the <tt>-P</tt> or <tt>--purge</tt> command option. Using the <tt>--purge</tt> option with v2 nodes will attempt to delete the node and client by the name of the node.
-
-== knife rackspace server list
-
-Outputs a list of all servers in the currently configured Rackspace Cloud account. Please note - this shows all instances associated with the account, some of which may not be currently managed by the Chef server. You may need to use the <tt>--rackspace-version</tt> and <tt>--rackspace-region</tt> options to see nodes in different Rackspace regions.
-
-== knife rackspace flavor list
-
-Outputs a list of all available flavors (available hardware configuration for a server) available to the currently configured Rackspace Cloud account. Each flavor has a unique combination of disk space, memory capacity and priority for CPU time. This data can be useful when choosing a flavor id to pass to the <tt>knife rackspace server create</tt> subcommand. You may need to use the <tt>--rackspace-version</tt> and <tt>--rackspace-region</tt> options to see nodes in different Rackspace regions.
-
-== knife rackspace image list
-
-Outputs a list of all available images available to the currently configured Rackspace Cloud account. An image is a collection of files used to create or rebuild a server. Rackspace provides a number of pre-built OS images by default. This data can be useful when choosing an image id to pass to the <tt>knife rackspace server create</tt> subcommand. You may need to use the <tt>--rackspace-version</tt> and <tt>--rackspace-region</tt> options to see nodes in different Rackspace regions.
-
-== knife rackspace network list
-
-Outputs a list of available networks to the currently configured Rackspace Cloud account. Networks can be added at a server during the creation process using the <tt>--network [LABEL_OR_ID]</tt> option. Knife does not currently support adding a network to an existing server.
-
-== knife rackspace network create
-
-Creates a new cloud network. Both the label and the CIDR are required parameters which are specified using the <tt>--label LABEL</tt>  and <tt>--cidr CIDR</tt> respectively. The CIDR should be in the form of 172.16.0.0/24 or 2001:DB8::/64. Refer to http://www.rackspace.com/knowledge_center/article/using-cidr-notation-in-cloud-networks for more information.
-
-== knife rackspace network delete
-
-Deletes one or more specified networks by id. The network must be detached from all hosts before it is deleted.
-
-
-== Knife & Rackspace Rackconnect
-
-Rackspace Rackconnect allows the creation of a hybrid setup where you can have Cloud servers which are connected to bare metal hardware like Firewalls and Load balancers. You can read more about this product at http://www.rackspace.com/cloud/hybrid/rackconnect/
-
-Under the hood, this changes the behaviour of how the cloud servers are configured and how IP addresses are assigned to them. So when using knife-rackspace with a 'Rack connected' cloud account you need use some additional parameters. See the sections below for more information regarding the two versions of Rack Connect.
-
-Note: If you account is leveraging private cloud networks for Rackconnnect then you are using Rackconnect v3. You can also find your version of Rackconnect by checking with your support team
-
-
-=== Knife and Rackconnect version 2
-
-    knife rackspace server create  \
-    --server-name <name of the server> \
-    --image <Rackspace image id> \
-    --flavor <Rackspace flavor id> \
-    -r 'role[base]' \
-    --rackconnect-wait
-
-Note: If the server is also part of Rackspace Managed Operations service level you will need to add the <tt>--rackspace-servicelevel-wait</tt> option.
-
-    knife rackspace server create  \
-    --server-name <name of the server> \
-    --image <Rackspace image id> \
-    --flavor <Rackspace flavor id> \
-    -r 'role[base]' \
-    --rackconnect-wait \
-    --rackspace-servicelevel-wait
-
-<tt>--rackconnect-wait</tt> does the following :-
-
-* Rackconnect version 2 changes the networking on the cloud server and forces all trafic to route via the dedicated firewall or load balancer. It also then assigns the cloud server a new public IP address. The status of this automation provided by updates to the cloud server metadata. This option makes Knife wait for the Rackconnect automation to complete by checking the metadata.
- 
-* Once the status is updated, it triggers the bootstrap process.
-
-
-<tt>--rackspace-servicelevel-wait</tt> does the following :-
-
-* For Cloud servers in the Managed operations service level, Rackspace installs additional agents and software which enables them to provide support. This automation. like the Rackconnect one, updates the cloud server metadata of its status. Likewise, using this option, makes knife wait till the automation is complete before triggering the bootstrap process. 
-
-
-
-=== Knife and Rackconnect version 3
-
-In case of version 3, there is a different command line option. 
-
-    knife rackspace server create \
-    --server-name <name of the server> \
-    --image <Rackspace image id> \
-    --flavor <Rackspace flavor id> \
-    -r 'role[base]' \
-    --rackconnect-v3-network-id <cloud network id>
-
-
-<tt>--rackconnect-v3-network-id</tt> does the following :-
-* Create the server with the corresponding cloud network. The network id the id of an existing cloud network.
-* Knife will then issue addtional API calls to the Rackconnect API to assign a new public IP to the cloud server. The new IP is also stored in the Cloud Server Metadata under accessv4IP. 
-* Knife then waits for the IP to be provisioned before triggering the bootstrap process.
-
-Functionally, this operates the same way as version 2. However, behind the scenes, Rackconnect v3 is signifcantly different in implementation. You can learn about the differences here :
-http://www.rackspace.com/knowledge_center/article/comparing-rackconnect-v30-and-rackconnect-v20
-
-
-= LICENSE:
-
-Author:: Adam Jacob (<adam@chef.io>)
-Author:: Seth Chisamore (<schisamo@chef.io>)
-Author:: Matt Ray (<matt@chef.io>)
-Author:: JJ Asghar (<jj@chef.io>)
-Author:: Rackspace Developers
-Copyright:: Copyright (c) 2009-2012 Opscode, Inc.
-Copyright:: Copyright (c) 2013-2015 Chef Software, Inc.
-License:: Apache License, Version 2.0
-
-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.