chef-provisioning-opennebula 0.4.4 → 0.4.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f967f28103c43f8a53e87e54eddd0de8fd1f9af1
-  data.tar.gz: cbb861a93ed158a967a661937c9ac3576ad9c66a
+  metadata.gz: be70c3a2ff409635c15cdb3983c4947e526b1af4
+  data.tar.gz: f0d93e05af640ebc8672f0ad9ed7cf83d5f41a94
 SHA512:
-  metadata.gz: 0d755e26ff9c70c4b08615f051d25747d0f9268bf9c14cd2ef62261161a63d759e65d44045a9ec52ee373fd0ed2cb0c39d1eef54fa382570f94d6e205387df94
-  data.tar.gz: 4eeb678cf8030a172988142c77ec676ad9ebfc3944a548069f29c6c59398caaf9d7a0b8ca2a0955b00610e82734d6056045afb428dc4f22d217d8798d7573891
+  metadata.gz: 432068196cae2b47b31b434588493dba50f99972d4d06004ca6ffd0dc60c54b448b7ef6ee049951c87833a451259ed9bd3b4ea4806beca28185a2c4bb2d885bf
+  data.tar.gz: 957716c65b152719733f36643b1629b511c392f28e9c4459dec66eb5a8041708c7c4a1c958dacae2835e1f9f4e4199e88840d43be2207d8d2c360446653b6703

data/README.md

@@ -7,6 +7,7 @@ This is the implementation of the OpenNebula driver for chef-provisioning.  It a
 * Image (one_image)
 * VNET (one_vnet)
 * Lease (one_vnet_lease)
+* OneFlow (one_flow_template & one_flow_service)
 
 Setup
 -----
@@ -45,6 +46,14 @@ A sample one_config file would look like this:
 }
 ```
 
+To use OneFlow, you also need to specify a ```with_flow_url``` directive. This is the API endpoint of your OneFlow.
+
+Example:
+
+```ruby
+with_flow_url "http://gary.1.2.3.4:9876"
+```
+
 In context of OpenNebula ```machine``` resource will take the following additional options:
 
 ```ruby
@@ -89,7 +98,7 @@ Resources
 
 ## one_template
 
-This resource will allow to create and delete OpenNebula templates.
+This resource will allow you to create and delete OpenNebula templates.
 
 ### Attributes
 
@@ -332,7 +341,7 @@ This resource will allow to create and delete OpenNebula vnets.
 
 ### Examples
 
-#### 1. Reserver vnet 'boggi_vnet' from parent vnet 12345 with default size 1
+#### 1. Reserve vnet 'boggi_vnet' from parent vnet 12345 with default size 1
 
 ```ruby
 one_vnet "boggi_vnet" do
@@ -341,7 +350,7 @@ one_vnet "boggi_vnet" do
 end
 ```
 
-#### 2. Reserver vnet 'boggi_vnet' from parent vnet 12345 with size 100
+#### 2. Reserve vnet 'boggi_vnet' from parent vnet 12345 with size 100
 
 ```ruby
 one_vnet "boggi_vnet" do
@@ -478,10 +487,270 @@ one_user "boggi" do
 end
 ```
 
+## one_flow_template
+
+This resource will allow you to create, delete, and instantiate OneFlow templates.
+
+### Attributes
+
+```ruby
+:name => String name of the OneFlow template you are targeting, default is what you put between 'one_flow_template' and 'do'
+:template => Hash defining your OneFlow template, or Fixnum ID of a OneFlow template from ONE, or String file location denoted by file://my_template.json or web location denoted by http(s)://1.2.3.4/my_template.json
+:template_options => Hash that override-merges into template
+:mode => String octet to set permissions, default is '600'
+```
+
+### Actions
+
+```ruby
+actions :create, :delete
+default_action :create
+```
+
+### Examples
+
+#### 1. Create OneFlow template from file with mode 640
+
+```ruby
+one_flow_template "garys_flow_template" do
+    template "file:///opt/one/flow_templates/my_template.tpl"
+    mode '640'
+    action :create
+end
+```
+**Note:** If 'name' is not specified in the template file, the template will be named 'garys_flow_template'
+If you want to get it from a url, you can do any of the following:
+```ruby
+template "http://1.2.3.4/my_template.tpl"
+template "gary@https://1.2.3.4/my_template.tpl"
+template "gary:password@https://1.2.3.4/my_template.tpl"
+```
+
+#### 2. Create OneFlow template from hash
+
+```ruby
+one_flow_template "I can write anything I want here" do
+   template  :name => "garys_flow_template",
+             :description => "This is my description.",
+             :shutdown_action => "shutdown-hard",
+             :deployment => "straight",
+             :ready_status_gate => true,
+             :roles => [
+               {
+                 :vm_template => 1398, # OR :vm_template => 'name_of_vm_template',
+                 :scheduled_policies => [
+                   {
+                     :type => "CHANGE",
+                     :adjust => 1,
+                     :start_time => "0 3 1-10 * *"
+                   },
+                   {
+                     :type => "CARDINALITY",
+                     :recurrence => "0 4 1-10 * *",
+                     :adjust => 2
+                   },
+                   {
+                     :type => "PERCENTAGE_CHANGE",
+                     :recurrence => "0 1 1-10 * *",
+                     :adjust => 3,
+                     :min_adjust_step => 14
+                   }
+                 ],
+                 :max_vms => 4,
+                 :cooldown => 15,
+                 :elasticity_policies => [
+                   {
+                     :type => "CHANGE",
+                     :cooldown => 17,
+                     :period => 15,
+                     :adjust => 2,
+                     :period_number => 2,
+                     :expression => "ATT == 20"
+                   },
+                   {
+                     :type => "CARDINALITY",
+                     :cooldown => 14,
+                     :period => 13,
+                     :adjust => 3,
+                     :period_number => 1,
+                     :expression => "ATT > 20"
+                   },
+                   {
+                     :type => "PERCENTAGE_CHANGE",
+                     :cooldown => 13,
+                     :period => 12,
+                     :adjust => 1,
+                     :period_number => 3,
+                     :expression => "ATT < 20",
+                     :min_adjust_step => 13
+                   }
+                 ],
+                 :cardinality => 3,
+                 :shutdown_action => "shutdown",
+                 :name => "gary_role_1",
+                 :vm_template_contents => "NIC=[NETWORK_ID=\"$NetConfg1\"]\nNIC=[NETWORK_ID=\"$NetConfg2\"]\n",
+                 :min_vms => 2
+               }
+             ],
+             :custom_attrs => {
+               :NetConfg2 => "M|vnet_id|another description",
+               :NetConfg1 => "M|vnet_id|description for net confg 1"
+             }
+    action :create
+end
+```
+**Note:** This is a template with (nearly) all fields filled out. By no means should you use this template, all the values were entered randomly.
+Notice that I specified 'name' in my hash. As for vm_template, you can either put the name of a VM template or put its ID. Using ID will be faster.
+See here for more info: http://docs.opennebula.org/4.14/integration/system_interfaces/appflow_api.html#examples
+
+#### 3. Update OneFlow template from hash (overwrite-merge)
+
+```ruby
+one_flow_template "garys_flow_template" do
+  template :deployment => nil, # setting any value to nil will reset it back to default
+           :roles => [
+             {
+               :name => 'delete_this_role',
+               :delete_role => nil # specifying this will delete this role
+             },
+             {
+               :name => 'new_role', # assuming new_role does not exist, creates a new role
+               :vm_template => 'gary-ubuntu-14.04',
+               :cooldown => 8
+             },
+             {
+               :name => 'existing_role', # assuming existing_role exists, updates cooldown to 88 seconds
+               :vm_template => 'gary-ubuntu-14.04',
+               :cooldown => 88
+             }
+           ]
+  action :update
+end
+```
+
+#### 4. Delete a OneFlow template
+
+```ruby
+one_flow_template "garys_flow_template" do
+   action :delete
+end
+```
+
+#### 5. Change the permissions of a OneFlow template
+
+```ruby
+one_flow_template "garys_flow_template" do
+   mode '640'
+   action :create
+end
+```
+
+## one_flow_service
+
+This resource will allow you to create, delete, and instantiate OneFlow templates.
+
+### Attributes
+
+```ruby
+:name => String name of the OneFlow service you are targeting, default is what you put between 'one_flow_service' and 'do'
+:template => String name or Fixnum ID of the template you want to instantiate
+:template_options => Hash that override-merges into template
+:mode => String octet to set permissions, default is '600'
+:role => String name of the role of a service you are targeting
+:period => Integer seconds between each group of actions
+:number => Integer number of VMs to apply the action to each period
+:cardinality => Integer number of VMs to deploy
+:force_scale => Boolean that allows scaling to cardinality above or below templated range
+:override_failsafe => Boolean that allows the user to ignore aborts due to untested / partionally implemented code and execute the action anyways, default false
+```
+**More on override_failsafe:** This only affects the actions :hold, :release, and :boot. The reason for this is because I was unable to figure out how to get the my VMs in a state that allows the running of these actions. As such, I was unable to test these actions.
+Here is the warning you will receive:
+```ruby
+Chef::Log.warn('You have chose to use an action that is untested / partially implemented.')
+Chef::Log.warn('Specifically, the driver will send the appropriate POST request to the Flow API')
+Chef::Log.warn('But the driver will not verify that the action ran successfully, or ran at all.')
+Chef::Log.warn('Moreover, the driver will not wait for the action complete, as in, the action will')
+Chef::Log.warn('run asynchronously, meaning dependent actions after this one may fail.')
+Chef::Log.warn('Use at your own risk. Please report any issues.')
+```
+
+### Actions
+
+```ruby
+actions :instantiate, :recover, :delete, :shutdown, 
+        :scale, :shutdown_hard, :undeploy, :undeploy_hard, 
+        :hold, :release, :stop, :suspend, :resume, :boot, 
+        :delete_recreate, :reboot, :reboot_hard, :poweroff, 
+        :poweroff_hard, :snapshot_create
+default_action :instantiate
+```
+
+### Examples
+
+#### 1. Instantiate a service from template
+
+```ruby
+one_flow_service "gary_service" do
+    template garys_flow_template # or ID, eg. template 555
+    template_options :roles => [
+                       {
+                         :name => 'random_role',
+                         :vm_template => 'gary-ubuntu-14.04',
+                         :cooldown => 10
+                       }
+                     ]
+    mode '640'
+    action :instantiate
+end
+```
+
+#### 2. Recover a service (or delete / shutdown)
+
+```ruby
+one_flow_service "gary_service" do
+    action :recover # or :delete / :shutdown
+end
+```
+
+#### 3. Change permissions of a service
+
+```ruby
+one_flow_service "I can write anything I want here" do
+    name "gary_service"
+    mode "640"
+    action :instantiate
+end
+```
+
+#### 4. Scale a role of a service to have 3 VMs regardless of the min/max VM setting
+
+```ruby
+one_flow_service "gary_service" do
+    cardinality 3
+    force_scale true # optional, default = false
+    role "gary_role"
+    action :scale
+end
+```
+
+#### 5. Perform a hard poweroff of a role
+
+```ruby
+one_flow_service "gary_service" do
+    role "gary_role"
+    period 3 # optional
+    number 5 # optional
+    action :poweroff_hard
+end
+```
+**Note:** All actions listed above except for :recover can be performed in the same manner.
+
 ## Rspec Integration tests
 
 - Create and configure `spec/config.rb` from `spec/config_sample.rb`, be sure to **read the comments**
-- Run `bundle exec rspec ./spec/integration/test_all_integration_spec.rb` from your chef-provisioning-opennebula folder
+- From your chef-provisioning-opennebula folder, run:
+    - `bundle install`
+    - `rspec ./spec/integration/test_all_integration_spec.rb`
 
 ## <a name="development"></a> Development
 

data/lib/chef/provider/one_flow_service.rb

@@ -0,0 +1,346 @@
+# Copyright 2016, BlackBerry Limited
+#
+# 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.
+
+require 'chef/provisioning/opennebula_driver/flow_lib'
+require 'set'
+
+#
+# Implementation of Provider class.
+#
+class Chef
+  #
+  # Implementation of Provider class.
+  #
+  class Provider
+    #
+    # Implementation of Provider class.
+    #
+    class OneFlowService < Chef::Provider::LWRPBase
+      use_inline_resources
+
+      provides :one_flow_service
+
+      def initialize(*args)
+        super
+        if !@new_resource.flow_url.nil?
+          flow_url = @new_resource.flow_url
+        elsif !run_context.chef_provisioning.flow_url.nil?
+          flow_url = run_context.chef_provisioning.flow_url
+        elsif !ENV['ONE_FLOW_URL'].nil?
+          flow_url = ENV['ONE_FLOW_URL']
+        else
+          fail 'OneFlow API URL must be specified.'
+        end
+        @flow_lib = Chef::Provisioning::OpenNebulaDriver::FlowLib.new(flow_url, driver.one.client.one_auth)
+      end
+
+      def whyrun_supported?
+        true
+      end
+
+      def load_current_resource
+        @current_resource = Chef::Resource::OneFlowService.new(@new_resource.name, run_context)
+        service_id = @flow_lib.get_unique_service_id(@new_resource.name, true)
+
+        @current_resource.exists = !service_id.nil?
+        return unless @current_resource.exists
+
+        if @new_resource.template.nil?
+          @current_resource.template_equal = true
+        else
+          one_tpl_id = @new_resource.template.is_a?(Fixnum) ? @new_resource.template : @flow_lib.get_unique_template_id(@new_resource.template)
+          new_service_template = @flow_lib.get_template(one_tpl_id)
+          new_service_template = @flow_lib.normalize_template(@new_resource.name, driver, @flow_lib.merge_template(new_service_template, @new_resource.template_options, true))
+          new_service_template.delete(:name)
+          new_service_template[:roles].each { |role| [:cardinality, :vm_template_contents].each { |key| role.delete(key) } }
+          current_service_template = @flow_lib.get_reduced_service_template(service_id)
+          @current_resource.template_equal = @flow_lib.hash_eq?(new_service_template, current_service_template)
+        end
+
+        @current_resource.mode(@flow_lib.get_service_permissions(service_id))
+        @current_resource.mode_equal = @new_resource.mode == @current_resource.mode
+
+        @current_resource.in_running_state = @flow_lib.get_service_state(service_id) == @flow_lib.class::SERVICE_RUNNING
+
+        @current_resource.equal = @current_resource.template_equal && @current_resource.mode_equal && @current_resource.in_running_state
+      end
+
+      action :instantiate do
+        if @current_resource.exists
+          # recover and/or chmod
+          unless @current_resource.equal
+            service_id = @flow_lib.get_unique_service_id(@new_resource.name)
+            converge_by "updated service '#{@new_resource.name}'" do
+              unless @current_resource.in_running_state
+                @flow_lib.recover_service(service_id, @new_resource.name)
+              end
+              unless @current_resource.mode_equal
+                @flow_lib.chmod_service(service_id, @new_resource.mode)
+              end
+              @new_resource.updated_by_last_action(true)
+            end
+          end
+        else
+          # create and chmod
+          fail 'You must specify a Flow template to instantiate' if @new_resource.template.nil?
+          one_tpl_id = @new_resource.template.is_a?(Fixnum) ? @new_resource.template : @flow_lib.get_unique_template_id(@new_resource.template)
+          new_service_template = @flow_lib.normalize_template(@new_resource.name, driver, @flow_lib.get_template(one_tpl_id))
+          new_service_template = @flow_lib.normalize_template(@new_resource.name, driver, @flow_lib.merge_template(new_service_template, @new_resource.template_options, true))
+          new_service_template[:name] = @new_resource.name
+          converge_by "instantiated service '#{@new_resource.name}'" do
+            one_tpl_id = @new_resource.template.is_a?(Fixnum) ? @new_resource.template : @flow_lib.get_unique_template_id(@new_resource.template)
+            @flow_lib.instantiate_template(one_tpl_id, new_service_template, @new_resource.name)
+            service_id = @flow_lib.get_unique_service_id(@new_resource.name)
+            @flow_lib.chmod_service(service_id, @new_resource.mode)
+            @new_resource.updated_by_last_action(true)
+          end
+        end
+      end
+
+      action :recover do
+        service_id = @flow_lib.get_unique_service_id(@new_resource.name)
+        dont_recover = Set[
+          @flow_lib.class::SERVICE_RUNNING,
+          @flow_lib.class::SERVICE_DEPLOYING,
+          @flow_lib.class::SERVICE_PENDING,
+          @flow_lib.class::SERVICE_SCALING
+        ].include?(@flow_lib.get_service_state(service_id))
+        unless dont_recover
+          converge_by "recovered service '#{@new_resource.name}'" do
+            @flow_lib.recover_service(service_id, @new_resource.name)
+            @new_resource.updated_by_last_action(true)
+          end
+        end
+      end
+
+      action :delete do
+        if @new_resource.role.nil?
+          if @current_resource.exists
+            service_id = @flow_lib.get_unique_service_id(@new_resource.name, true)
+            converge_by "deleted service '#{@new_resource.name}'" do
+              @flow_lib.delete_service(service_id)
+              @new_resource.updated_by_last_action(true)
+            end
+          end
+        else
+          sid = @flow_lib.get_unique_service_id(@new_resource.name)
+          unless @flow_lib.get_role_state(sid, @new_resource.role) == @flow_lib.class::ROLE_NO_VMS
+            converge_by "deleted role '#{@new_resource.role}' of service '#{@new_resource.name}'" do
+              @flow_lib.role_action(sid, @new_resource.role, 'delete', @new_resource.period.to_s, @new_resource.number.to_s, @flow_lib.class::ROLE_NO_VMS)
+              @new_resource.updated_by_last_action(true)
+            end
+          end
+        end
+      end
+
+      action :shutdown do
+        if @new_resource.role.nil?
+          sid = @flow_lib.get_unique_service_id(@new_resource.name)
+          dont_shutdown = Set[
+            @flow_lib.class::SERVICE_DONE,
+            @flow_lib.class::SERVICE_UNDEPLOYING,
+            @flow_lib.class::SERVICE_FAILED_DEPLOYING
+          ].include?(@flow_lib.get_service_state(sid))
+          unless dont_shutdown
+            converge_by "shutdown service '#{@new_resource.name}'" do
+              @flow_lib.shutdown_service(@new_resource.name, sid)
+              @new_resource.updated_by_last_action(true)
+            end
+          end
+        else
+          sid = @flow_lib.get_unique_service_id(@new_resource.name)
+          unless @flow_lib.get_role_state(sid, @new_resource.role) == @flow_lib.class::ROLE_NO_VMS
+            converge_by "shutdown role '#{@new_resource.role}' of service '#{@new_resource.name}'" do
+              @flow_lib.role_action(sid, @new_resource.role, 'shutdown', @new_resource.period.to_s, @new_resource.number.to_s, @flow_lib.class::ROLE_NO_VMS)
+              @new_resource.updated_by_last_action(true)
+            end
+          end
+        end
+      end
+
+      action :scale do
+        fail 'You specified an action that is role specific, but did not provide a role.' if @new_resource.role.nil?
+        fail 'You must specify the attribute cardinality, and cardinality >= 0' if @new_resource.cardinality < 0
+
+        service_id = @flow_lib.get_unique_service_id(@new_resource.name)
+        unless @flow_lib.get_role_cardinality(service_id, @new_resource.role) == @new_resource.cardinality
+          converge_by "scaled role '#{@new_resource.role}' of service '#{@new_resource.name}' to cardinality '#{@new_resource.cardinality}'" do
+            @flow_lib.role_scale(service_id, @new_resource.name, @new_resource.role, @new_resource.cardinality, @new_resource.force_scale)
+            @new_resource.updated_by_last_action(true)
+          end
+        end
+      end
+
+      action :shutdown_hard do
+        fail 'You specified an action that is role specific, but did not provide a role.' if @new_resource.role.nil?
+        sid = @flow_lib.get_unique_service_id(@new_resource.name)
+        unless @flow_lib.get_role_state(sid, @new_resource.role) == @flow_lib.class::ROLE_NO_VMS
+          converge_by "performed hard shutdown of role '#{@new_resource.role}' of service '#{@new_resource.name}'" do
+            @flow_lib.role_action(sid, @new_resource.role, 'shutdown-hard', @new_resource.period.to_s, @new_resource.number.to_s, @flow_lib.class::ROLE_NO_VMS)
+            @new_resource.updated_by_last_action(true)
+          end
+        end
+      end
+
+      action :undeploy do
+        fail 'You specified an action that is role specific, but did not provide a role.' if @new_resource.role.nil?
+        sid = @flow_lib.get_unique_service_id(@new_resource.name)
+        unless @flow_lib.get_role_state(sid, @new_resource.role) == @flow_lib.class::ROLE_UNDEPLOYED
+          converge_by "undeployed role '#{@new_resource.role}' of service '#{@new_resource.name}'" do
+            @flow_lib.role_action(sid, @new_resource.role, 'undeploy', @new_resource.period.to_s, @new_resource.number.to_s, @flow_lib.class::ROLE_UNDEPLOYED)
+            @new_resource.updated_by_last_action(true)
+          end
+        end
+      end
+
+      action :undeploy_hard do
+        fail 'You specified an action that is role specific, but did not provide a role.' if @new_resource.role.nil?
+        sid = @flow_lib.get_unique_service_id(@new_resource.name)
+        unless @flow_lib.get_role_state(sid, @new_resource.role) == @flow_lib.class::ROLE_UNDEPLOYED
+          converge_by "hard undeployed role '#{@new_resource.role}' of service '#{@new_resource.name}'" do
+            @flow_lib.role_action(sid, @new_resource.role, 'undeploy-hard', @new_resource.period.to_s, @new_resource.number.to_s, @flow_lib.class::ROLE_UNDEPLOYED)
+            @new_resource.updated_by_last_action(true)
+          end
+        end
+      end
+
+      action :hold do
+        fail 'You specified an action that is role specific, but did not provide a role.' if @new_resource.role.nil?
+        @new_resource.override_failsafe ? @flow_lib.override_failsafe_warn : fail('UNTESTED / PARTIALLY IMPLEMENTED')
+        sid = @flow_lib.get_unique_service_id(@new_resource.name)
+        converge_by "held role '#{@new_resource.role}' of service '#{@new_resource.name}'" do
+          @flow_lib.role_action(sid, @new_resource.role, 'hold', @new_resource.period.to_s, @new_resource.number.to_s)
+          @new_resource.updated_by_last_action(true)
+        end
+      end
+
+      action :release do
+        fail 'You specified an action that is role specific, but did not provide a role.' if @new_resource.role.nil?
+        @new_resource.override_failsafe ? @flow_lib.override_failsafe_warn : fail('UNTESTED / PARTIALLY IMPLEMENTED')
+        sid = @flow_lib.get_unique_service_id(@new_resource.name)
+        converge_by "released role '#{@new_resource.role}' of service '#{@new_resource.name}'" do
+          @flow_lib.role_action(sid, @new_resource.role, 'release', @new_resource.period.to_s, @new_resource.number.to_s)
+          @new_resource.updated_by_last_action(true)
+        end
+      end
+
+      action :stop do
+        fail 'You specified an action that is role specific, but did not provide a role.' if @new_resource.role.nil?
+        sid = @flow_lib.get_unique_service_id(@new_resource.name)
+        unless @flow_lib.get_role_state(sid, @new_resource.role) == @flow_lib.class::ROLE_STOPPED
+          converge_by "stopped role '#{@new_resource.role}' of service '#{@new_resource.name}'" do
+            @flow_lib.role_action(sid, @new_resource.role, 'stop', @new_resource.period.to_s, @new_resource.number.to_s, @flow_lib.class::ROLE_STOPPED)
+            @new_resource.updated_by_last_action(true)
+          end
+        end
+      end
+
+      action :suspend do
+        fail 'You specified an action that is role specific, but did not provide a role.' if @new_resource.role.nil?
+        sid = @flow_lib.get_unique_service_id(@new_resource.name)
+        unless @flow_lib.get_role_state(sid, @new_resource.role) == @flow_lib.class::ROLE_SUSPENDED
+          converge_by "suspended role '#{@new_resource.role}' of service '#{@new_resource.name}'" do
+            @flow_lib.role_action(sid, @new_resource.role, 'suspend', @new_resource.period.to_s, @new_resource.number.to_s, @flow_lib.class::ROLE_SUSPENDED)
+            @new_resource.updated_by_last_action(true)
+          end
+        end
+      end
+
+      action :resume do
+        fail 'You specified an action that is role specific, but did not provide a role.' if @new_resource.role.nil?
+        sid = @flow_lib.get_unique_service_id(@new_resource.name)
+        unless @flow_lib.get_role_state(sid, @new_resource.role) == @flow_lib.class::ROLE_RUNNING
+          converge_by "resumed role '#{@new_resource.role}' of service '#{@new_resource.name}'" do
+            @flow_lib.role_action(sid, @new_resource.role, 'resume', @new_resource.period.to_s, @new_resource.number.to_s, @flow_lib.class::ROLE_RUNNING)
+            @new_resource.updated_by_last_action(true)
+          end
+        end
+      end
+
+      action :boot do
+        fail 'You specified an action that is role specific, but did not provide a role.' if @new_resource.role.nil?
+        @new_resource.override_failsafe ? @flow_lib.override_failsafe_warn : fail('UNTESTED / PARTIALLY IMPLEMENTED')
+        sid = @flow_lib.get_unique_service_id(@new_resource.name)
+        converge_by "booted role '#{@new_resource.role}' of service '#{@new_resource.name}'" do
+          @flow_lib.role_action(sid, @new_resource.role, 'boot', @new_resource.period.to_s, @new_resource.number.to_s)
+          @new_resource.updated_by_last_action(true)
+        end
+      end
+
+      action :delete_recreate do
+        fail 'You specified an action that is role specific, but did not provide a role.' if @new_resource.role.nil?
+        sid = @flow_lib.get_unique_service_id(@new_resource.name)
+        converge_by "deleted and recreated role '#{@new_resource.role}' of service '#{@new_resource.name}'" do
+          @flow_lib.role_action(sid, @new_resource.role, 'delete-recreate', @new_resource.period.to_s, @new_resource.number.to_s, @flow_lib.class::ROLE_RUNNING)
+          @new_resource.updated_by_last_action(true)
+        end
+      end
+
+      action :reboot do
+        fail 'You specified an action that is role specific, but did not provide a role.' if @new_resource.role.nil?
+        sid = @flow_lib.get_unique_service_id(@new_resource.name)
+        converge_by "rebooted role '#{@new_resource.role}' of service '#{@new_resource.name}'" do
+          @flow_lib.role_action(sid, @new_resource.role, 'reboot', @new_resource.period.to_s, @new_resource.number.to_s, @flow_lib.class::ROLE_RUNNING)
+          @new_resource.updated_by_last_action(true)
+        end
+      end
+
+      action :reboot_hard do
+        fail 'You specified an action that is role specific, but did not provide a role.' if @new_resource.role.nil?
+        sid = @flow_lib.get_unique_service_id(@new_resource.name)
+        converge_by "hard rebooted role '#{@new_resource.role}' of service '#{@new_resource.name}'" do
+          @flow_lib.role_action(sid, @new_resource.role, 'reboot-hard', @new_resource.period.to_s, @new_resource.number.to_s, @flow_lib.class::ROLE_RUNNING)
+          @new_resource.updated_by_last_action(true)
+        end
+      end
+
+      action :poweroff do
+        fail 'You specified an action that is role specific, but did not provide a role.' if @new_resource.role.nil?
+        sid = @flow_lib.get_unique_service_id(@new_resource.name)
+        unless @flow_lib.get_role_state(sid, @new_resource.role) == @flow_lib.class::ROLE_POWEROFF
+          converge_by "powered-off role '#{@new_resource.role}' of service '#{@new_resource.name}'" do
+            @flow_lib.role_action(sid, @new_resource.role, 'poweroff', @new_resource.period.to_s, @new_resource.number.to_s, @flow_lib.class::ROLE_POWEROFF)
+            @new_resource.updated_by_last_action(true)
+          end
+        end
+      end
+
+      action :poweroff_hard do
+        fail 'You specified an action that is role specific, but did not provide a role.' if @new_resource.role.nil?
+        sid = @flow_lib.get_unique_service_id(@new_resource.name)
+        unless @flow_lib.get_role_state(sid, @new_resource.role) == @flow_lib.class::ROLE_POWEROFF
+          converge_by "hard powered-off role '#{@new_resource.role}' of service '#{@new_resource.name}'" do
+            @flow_lib.role_action(sid, @new_resource.role, 'poweroff-hard', @new_resource.period.to_s, @new_resource.number.to_s, @flow_lib.class::ROLE_POWEROFF)
+            @new_resource.updated_by_last_action(true)
+          end
+        end
+      end
+
+      action :snapshot_create do
+        fail 'You specified an action that is role specific, but did not provide a role.' if @new_resource.role.nil?
+        sid = @flow_lib.get_unique_service_id(@new_resource.name)
+        converge_by "created a snapshot for role '#{@new_resource.role}' of service '#{@new_resource.name}'" do
+          @flow_lib.role_action(sid, @new_resource.role, 'snapshot-create', @new_resource.period.to_s, @new_resource.number.to_s)
+          @new_resource.updated_by_last_action(true)
+        end
+      end
+
+      protected
+
+      def driver
+        @new_resource.driver.nil? ? run_context.chef_provisioning.current_driver : run_context.chef_provisioning.driver_for(@new_resource.driver)
+      end
+    end
+  end
+end