fog-zj 0.1.28

data/examples/image/upload-test-image.rb

@@ -0,0 +1,74 @@
+require 'securerandom'
+require 'rubygems/package'
+require 'zlib'
+require 'fog/openstack'
+
+#
+# Download CirrOS 0.3.0 image from launchpad (~6.5MB) to /tmp
+# and upload it to Glance (the OpenStack Image Service).
+#
+# You will need to source OpenStack credentials since the script
+# reads the following envionment variables:
+#
+#  OS_PASSWORD
+#  OS_USERNAME
+#  OS_AUTH_URL
+#  OS_TENANT_NAME
+#
+# Should work with Fog >= 1.9, ruby 1.8.7 and 2.0
+#
+image_url = "https://launchpadlibrarian.net/83305869/cirros-0.3.0-x86_64-uec.tar.gz"
+image_out = File.open("/tmp/cirros-image-#{SecureRandom.hex}", 'wb')
+extract_path = "/tmp/cirros-#{SecureRandom.hex}-dir"
+ami = "#{extract_path}/cirros-0.3.0-x86_64-blank.img"
+aki = "#{extract_path}/cirros-0.3.0-x86_64-vmlinuz"
+ari = "#{extract_path}/cirros-0.3.0-x86_64-initrd"
+
+FileUtils.mkdir_p extract_path
+
+# Efficient image write
+puts "Downloading Cirros image..."
+streamer = lambda do |chunk, remaining_bytes, total_bytes|
+  image_out.write chunk
+end
+Excon.get image_url, :response_block => streamer
+image_out.close
+puts "Image downloaded to #{image_out.path}"
+
+puts "Extracting image contents to #{extract_path}..."
+Gem::Package::TarReader.new(Zlib::GzipReader.open(image_out.path)).each do |entry|
+  FileUtils.mkdir_p "#{extract_path}/#{File.dirname(entry.full_name)}"
+  File.open "#{extract_path}/#{entry.full_name}", 'w' do |f|
+    f.write entry.read
+  end
+end
+
+image_service = Fog::Image::OpenStack.new :openstack_api_key => ENV['OS_PASSWORD'],
+                                          :openstack_username => ENV["OS_USERNAME"],
+                                          :openstack_auth_url => ENV["OS_AUTH_URL"] + "/tokens",
+                                          :openstack_tenant => ENV["OS_TENANT_NAME"]
+
+puts "Uploading AKI..."
+aki = image_service.images.create :name => 'cirros-0.3.0-amd64-aki',
+                                  :size => File.size(aki),
+                                  :disk_format => 'aki',
+                                  :container_format => 'aki',
+                                  :location => aki
+
+puts "Uploading ARI..."
+ari = image_service.images.create :name => 'cirros-0.3.0-amd64-ari',
+                                  :size => File.size(ari),
+                                  :disk_format => 'ari',
+                                  :container_format => 'ari',
+                                  :location => ari
+
+puts "Uploading AMI..."
+image_service.images.create :name => 'cirros-0.3.0-amd64',
+                            :size => File.size(ami),
+                            :disk_format => 'ami',
+                            :container_format => 'ami',
+                            :location => ami,
+                            :properties => {
+                              'kernel_id'  => aki.id,
+                              'ramdisk_id' => ari.id
+                            }

data/examples/introspection/basics.rb

@@ -0,0 +1,75 @@
+
+require 'rubygems'
+require 'fog/openstack' # version >= 1.37
+
+auth_url = "https://example.net:5000/v3/auth/tokens"
+username = 'admin@example.net'
+password = 'secret'
+project  = 'admin'
+
+@connection_params = {
+  :openstack_auth_url     => auth_url,
+  :openstack_username     => username,
+  :openstack_api_key      => password,
+  :openstack_project_name => project,
+  :openstack_domain_id    => "default"
+}
+
+inspector = Fog::Introspection::OpenStack.new(@connection_params)
+
+# Introspection of an Ironic node
+ironic = Fog::Baremetal::OpenStack.new(@connection_params)
+nodes = ironic.list_nodes
+node1_uuid = nodes.body["nodes"][0]["uuid"]
+
+# Launch introspection
+inspector.create_introspection(node1_uuid)
+
+# Introspection status
+inspector.get_introspection(node1_uuid)
+
+# Abort introspection
+inspector.abort_introspection(node1_uuid)
+
+# Retrieve introspection data
+# Note: introspection must be finished and ended successfully
+inspector.get_introspection_details(node1_uuid)
+
+## Introspection Rules
+# Create a set of rules
+rules = {
+  "description" => "Successful Rule",
+  "actions"     => [
+    {
+      "action" => "set-attribute",
+      "path"   => "/extra/rule_success",
+      "value"  => "yes"
+    }
+  ],
+  "conditions"  => [
+    {
+      "field" => "memory_mb",
+      "op"    => "ge",
+      "value" => 256
+    },
+    {
+      "field" => "local_gb",
+      "op"    => "ge",
+      "value" => 1
+    }
+  ]
+}
+inspector.create_rules(rules)
+
+# List all rules set
+rules1 = inspector.list_rules
+
+# Show a rules set
+rules1_uuid = rules1[:body]["rules"][0]['uuid']
+inspector.get_rules(rules1_uuid)
+
+# Delete a specific rules set
+inspector.delete_rules(rules1_uuid)
+
+# Destroys all rules sets
+inspector.delete_rules_all

data/examples/metric/basics.rb

@@ -0,0 +1,42 @@
+require 'fog/openstack'
+require 'time'
+
+auth_url = "http://10.0.0.13:5000/v3/auth/tokens"
+username = 'admin'
+password = 'njXDF8bKr68RQsfbANvURzkmT'
+project  = 'admin'
+
+@connection_params = {
+    :openstack_auth_url     => auth_url,
+    :openstack_username     => username,
+    :openstack_api_key      => password,
+    :openstack_project_name => project,
+    :openstack_domain_id    => "default"
+}
+
+puts "### SERVICE CONNECTION ###"
+
+metric = Fog::Metric::OpenStack.new(@connection_params)
+
+p metric
+
+puts "### RESOURCES ###"
+
+p metric.list_resources
+
+p metric.resources.all(details: true)
+
+p metric.resources.find_by_id("3c6c53c9-25c1-4aca-984d-a20c1926b499")
+
+p metric.get_resource_metric_measures("d1f84147-d4ef-465e-a679-265df36918ed", "disk.ephemeral.size", start: 0, stop: Time.now.iso8601, granularity: 300).body
+
+
+puts "### METRICS ###"
+
+p metric.metrics.all
+
+p metric.metrics.find_by_id("7feff2ca-2edd-4ea5-96d7-2cc5262bb504")
+
+p metric.get_metric_measures("d8e5e557-e3cc-41bd-9d87-dac3eedd0df7", start: 0, stop: Time.now.iso8601, granularity: 300).body
+
+puts "### END ###"

data/examples/network/network_add_port.rb

@@ -0,0 +1,21 @@
+require 'fog/openstack'
+
+# Add additional port to an Openstack node
+
+def create_virtual_address_pairing(username, password, auth_url, tenant, device_id, device_ip_address, network_id)
+  network_driver = Fog::Network.new(:provider           => :openstack,
+                                    :openstack_api_key  => password,
+                                    :openstack_username => username,
+                                    :openstack_auth_url => auth_url,
+                                    :openstack_tenant   => tenant)
+
+  virtual_ip_address = network_driver.create_port(network_id)
+
+  server_nics = network_driver.list_ports('device_id' => device_id).data[:body]['ports']
+  port = (server_nics.select do |network_port|
+    network_port['mac_address'] == server.attributes['macaddress']
+  end).first
+
+  network_driver.update_port(port['id'], :allowed_address_pairs => [{:ip_address => device_ip_address},
+                                                                    {:ip_address => virtual_ip_address}])
+end

data/examples/network/network_rbac.rb

@@ -0,0 +1,69 @@
+require 'fog/openstack'
+require 'pp'
+
+#
+# Creates a private network and shares it with another project via RBAC policy
+#
+# Needs to be in an environment where keystone v3 is available
+#
+# You will need to source OpenStack credentials since the script
+# reads the following envionment variables:
+#
+#  OS_AUTH_URL
+#  OS_PASSWORD
+#  OS_USERNAME
+#  OS_USER_DOMAIN_NAME
+#  OS_PROJECT_NAME
+#  OS_REGION_NAME
+#
+#  optionally disable SSL verification
+#  SSL_VERIFY=false
+
+auth_options = {
+  :openstack_auth_url     => "#{ENV['OS_AUTH_URL']}/auth/tokens",
+  :openstack_api_key      => ENV['OS_PASSWORD'],
+  :openstack_username     => ENV['OS_USERNAME'],
+  :openstack_domain_name  => ENV['OS_USER_DOMAIN_NAME'],
+  :openstack_project_name => ENV['OS_PROJECT_NAME'],
+  :openstack_region       => ENV['OS_REGION_NAME'],
+  :connection_options     => {:ssl_verify_peer => ENV['SSL_VERIFY'] != 'false'}
+}
+
+identity_service = Fog::Identity::OpenStack::V3.new(auth_options)
+network_service  = Fog::Network::OpenStack.new(auth_options)
+
+own_project   = identity_service.projects.select { |p| p.name == ENV['OS_PROJECT_NAME'] }.first
+other_project = identity_service.projects.select { |p| p.name != ENV['OS_PROJECT_NAME'] }.first
+
+puts "Create network in #{own_project.name}"
+foonet = network_service.networks.create(:name => 'foo-net23', :tenant_id => own_project.id)
+
+puts "Share network with #{other_project.name}"
+rbac = network_service.rbac_policies.create(
+  :object_type   => 'network',
+  :object_id     => foonet.id,
+  :tenant_id     => own_project.id,
+  :target_tenant => other_project.id,
+  :action        => 'access_as_shared'
+)
+
+puts "Get RBAC policy"
+rbac = network_service.rbac_policies.find_by_id(rbac.id)
+pp rbac
+
+puts "Change share to own project"
+rbac.target_tenant = own_project.id
+rbac.save
+
+puts "Get network and see that it is now shared"
+foonet = network_service.networks.get(foonet.id)
+pp foonet
+
+puts "Remove the share via RBAC"
+rbac.destroy
+
+puts "Get network and see that it is no longer shared"
+foonet.reload
+pp foonet
+
+foonet.destroy

data/examples/network/network_subnets_routers.rb

@@ -0,0 +1,62 @@
+require 'fog/openstack'
+
+#
+# Quantum demo
+#
+# Create some routers, networks and subnets for
+# a couple of tenants.
+#
+# Needs Fog >= 1.11.0
+# Needs OpenStack credentials in ~/.fog
+#
+
+def create_tenant_network( tenant_name,
+                           external_net,
+                           router_name = 'router1',
+                           subnet_range = '10.0.0.0/21',
+                           subnet_gateway = '10.0.0.1',
+                           private_network_name = 'private' )
+
+  network = Fog::Network[:openstack]
+  id = Fog::Identity[:openstack]
+
+  tenant = id.tenants.find { |t| t.name == tenant_name }
+
+  # Create a router for the tenant
+  router = network.routers.create :name => router_name,
+                                  :tenant_id => tenant.id,
+                                  :external_gateway_info => {
+                                    'network_id' => external_net.id
+                                  }
+
+  # Create a private network for the tenant
+  net = network.networks.create :name => private_network_name,
+                                :tenant_id => tenant.id
+
+  # Create a subnet for the previous network and associate it
+  # with the tenant
+  subnet = network.subnets.create :name => 'net_10',
+                                  :network_id  => net.id,
+                                  :ip_version  => 4,
+                                  :gateway_ip  => subnet_gateway,
+                                  :cidr        => subnet_range,
+                                  :tenant_id => tenant.id,
+                                  :enable_dhcp => true
+
+  network.add_router_interface router.id, subnet.id
+end
+
+# Create a public shared network
+public_net = network.networks.create :name => 'nova',
+                                     :router_external => true
+
+# Create the public subnet
+public_subnet = network.subnets.create :name => 'floating_ips_net',
+                                       :network_id  => public_net.id,
+                                       :ip_version  => 4,
+                                       :cidr        => '1.2.3.0/24',
+                                       :enable_dhcp => false
+
+# Create tenant networks
+create_tenant_network 'admin@example.net', public_net
+create_tenant_network 'demo@example.net', public_net

data/examples/planning/basics.rb

@@ -0,0 +1,53 @@
+# OpenStack Planning Service (Tuskar) Example
+
+require 'fog/openstack'
+require 'pp'
+
+auth_url = "https://example.net/v2.0/tokens"
+username = 'admin@example.net'
+password = 'secret'
+tenant   = 'My Compute Tenant' # String
+
+planning ||= ::Fog::OpenStack.new(
+  :service            => :planning,
+  :openstack_api_key  => password,
+  :openstack_username => username,
+  :openstack_auth_url => auth_url,
+  :openstack_tenant   => tenant
+)
+
+pp planning
+
+#
+# Listing of Tuskar roles
+#
+roles = planning.roles.each do |role|
+  pp role
+end
+
+#
+# Listing of Tuskar plans
+#
+plans = planning.plans.each do |plan|
+  pp plan
+end
+
+#
+# Creating new Tuskar plan
+#
+plan = planning.plans.new({
+  :name        => 'New Plan Name',
+  :description => 'New Plan Description'
+})
+pp plan
+
+#
+# Assign role to plan
+#
+role_uuid = roles.first.uuid
+plan.add_role(role_uuid)
+
+#
+# Output Heat templates for plan
+#
+pp plan.templates

data/examples/shared_file_system/basics.rb

@@ -0,0 +1,68 @@
+require 'fog/openstack'
+require 'pp'
+
+#
+# Creates a share network and a share
+#
+# Needs to be in an environment where keystone v3 is available
+#
+# You will need to source OpenStack credentials since the script
+# reads the following envionment variables:
+#
+#  OS_AUTH_URL
+#  OS_PASSWORD
+#  OS_USERNAME
+#  OS_USER_DOMAIN_NAME
+#  OS_PROJECT_NAME
+#  OS_REGION_NAME
+#
+#  optionally disable SSL verification
+#  SSL_VERIFY=false
+
+auth_options = {
+  :openstack_auth_url     => "#{ENV['OS_AUTH_URL']}/auth/tokens",
+  :openstack_api_key      => ENV['OS_PASSWORD'],
+  :openstack_username     => ENV['OS_USERNAME'],
+  :openstack_domain_name  => ENV['OS_USER_DOMAIN_NAME'],
+  :openstack_project_name => ENV['OS_PROJECT_NAME'],
+  :openstack_region       => ENV['OS_REGION_NAME'],
+  :connection_options     => {:ssl_verify_peer => ENV['SSL_VERIFY'] != 'false'}
+}
+
+network_service = Fog::Network::OpenStack.new(auth_options)
+share_service   = Fog::SharedFileSystem::OpenStack.new(auth_options)
+
+net = network_service.networks.first
+raise 'no network exists' if net.nil?
+
+puts "Create share network in #{net.name}"
+share_network = share_service.networks.create(
+  :neutron_net_id    => net.id,
+  :neutron_subnet_id => net.subnets.first.id,
+  :name              => 'fog_share_net'
+)
+
+pp share_network
+
+puts 'Create share'
+example_share = share_service.shares.create(
+  :share_proto      => 'NFS',
+  :size             => 1,
+  :name             => 'fog_share',
+  :share_network_id => share_network.id
+)
+
+pp example_share
+
+puts 'Create snapshot'
+example_snap = share_service.snapshots.create(
+  :share_id => example_share.id,
+  :name     => 'fog_share_snapshot'
+)
+
+pp example_snap
+
+puts 'Removing snapshot, share and share network'
+example_snap.destroy
+example_share.destroy
+share_network.destroy