volume.rb

# (c) Copyright 2021 Hewlett Packard Enterprise Development LP
#
# 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.

my_client = {
  url: ENV['ONEVIEWSDK_URL'],
  user: ENV['ONEVIEWSDK_USER'],
  password: ENV['ONEVIEWSDK_PASSWORD'],
  api_version: 3000
}

# Example: Create a volume
# In this example, we'll set all the data necessary to create a new volume from scratch.
# You'll notice that in the OneView API docs, there is a "provisioningParameters" hash that defines
# most of the data for creating new volumes, but when you retrieve or update them, that hash is
# gone (and everything has moved to the top level). This model is a little confusing, so we've made
# it a little easier. All you have to do is define the data attributes like you would for an update,
# and and the oneview_volume resource automatically populates the provisioningParameters hash for you.
# This resource also provides some helpful properties that automatically retrieve URIs for the
# StorageSystem, StoragePool, VolumeTemplate, and SnapshotPool; all you have to do is specify the name.
oneview_volume 'CHEF_VOL_01' do
  client my_client
  data(
    description: 'Created by Chef',
    isShareable: true,
    provisioningType: 'Thin', # Or 'Full'
    size: 1024 * 1024 * 1024 # 1GB
  )
  storage_system 'ThreePAR-1' # Name of the storage system
  storage_pool 'CPG_FC-AO' # Name of the storage pool
  snapshot_pool 'CPG_FC-AO' # Name of the storage pool used for snapshots
end

# Example: Update a volume
oneview_volume 'CHEF_VOL_01' do
  client my_client
  data(description: 'Volume store serv Updated')
  storage_pool 'CPG-SSD-AO'
  storage_system 'ThreePAR-1'
end

# Example: Create a volume (using the storage system IP)
# This example is identical to the one above, except we use an IP for the the "storage_system" property
# instead of a name.
oneview_volume 'CHEF_VOL_02' do
  client my_client
  data(
    description: 'Created by Chef',
    isShareable: true,
    provisioningType: 'Thin', # Or 'Full'
    size: 1024 * 1024 * 1024 # 1GB
  )
  storage_system '<storage_system>' # IP of the storage system
  storage_pool 'CPG_FC-AO' # Name of the storage pool
  snapshot_pool 'CPG_FC-AO' # Name of the storage pool used for snapshots
end

# Example: Create a volume using a VolumeTemplate
# VolumeTemplates are very helpful when you want to (mostly) the same settings for multiple volumes.
# We can override the template options with the data property, but you really only need to provide volume_template.
oneview_volume 'CHEF_VOL_03' do
  client my_client
  data(
    description: 'Created by Chef using template', # Override the template's description
    isShareable: true,
    provisioningType: 'Thin', # Or 'Full'
    size: 1024 * 1024 * 1024 # 1GB
  )
  volume_template 'VT1' # Name of the VolumeTemplate
end

# Example: Create a snapshot from the volume created by this recipe
oneview_volume 'CHEF_VOL_01' do
  client my_client
  snapshot_data(
    name: 'CHEF_VOL_SNAP_01',
    description: 'Volume snapshot'
  )
  action :create_snapshot
end

# Example: Delete a volume snapshot
oneview_volume 'CHEF_VOL_01' do
  client my_client
  snapshot_data(
    name: 'CHEF_VOL_SNAP_01'
  )
  action :delete_snapshot
end

# Deletes the volumes created in this recipe:
# Delete action will only need the name and client
(1..3).each do |i|
  oneview_volume "CHEF_VOL_0#{i}" do
    client my_client
    action :delete
  end
end