← Back to branch summary

~ubuntu-branches/ubuntu/utopic/heat/utopic-updates

« back to all changes in this revision

Viewing changes to contrib/nova_flavor/nova_flavor/README.md

  • Committer: Package Import Robot
  • Author(s): Chuck Short
  • Date: 2014-09-08 09:40:59 UTC
  • mfrom: (1.1.16)
  • Revision ID: package-import@ubuntu.com-20140908094059-pzysrm0uy4senjez
Tags: 2014.2~b3-0ubuntu1
New upstream version. 

Show diffs side-by-side

added added

removed removed

Lines of Context:
contrib/nova_flavor/nova_flavor/README.md
1
 
Nova Flavor plugin for OpenStack Heat
2
 
=====================================
3
 
 
4
 
This plugin enables using Nova Flavors as resources in a Heat template.
5
 
 
6
 
Note that the current implementation of the Nova Flavor resource does not
7
 
allow specifying the name and flavorid properties for the resource.
8
 
This is done to avoid potential naming collision upon flavor creation as
9
 
all flavor have a global scope.
10
 
 
11
 
### 1. Install the Nova Flavor plugin in Heat
12
 
 
13
 
NOTE: Heat scans several directories to find plugins. The list of directories
14
 
is specified in the configuration file "heat.conf" with the "plugin_dirs"
15
 
directive.
16
 
 
17
 
### 2. Restart heat
18
 
 
19
 
Only the process "heat-engine" needs to be restarted to load the new installed
20
 
plugin.
21
 
 
22
 
### Template Format
23
 
 
24
 
Here's an example nova flavor resource:
25
 
```yaml
26
 
heat_template_version: 2013-05-23
27
 
description:  Heat Flavor creation example
28
 
resources:
29
 
  test_flavor:
30
 
    type: OS::Nova::Flavor
31
 
    properties:
32
 
      ram: 1024
33
 
      vcpus: 1
34
 
      disk: 20
35
 
      swap: 2
36
 
      extra_specs: {"quota:disk_read_bytes_sec": "10240000"}
37
 
```
38
 
 
39
 
### Issues with the Nova Flavor plugin
40
 
 
41
 
By default only the admin tenant can manage flavors because of the default
42
 
policy in Nova: ```"compute_extension:flavormanage": "rule:admin_api"```
43
 
 
44
 
To let the possibility to all tenants to create flavors, the rule must be
45
 
replaced with the following: ```"compute_extension:flavormanage": ""```
46
 
 
47
 
The following error occurs if the policy has not been correctly set:
48
 
 ERROR: Policy doesn't allow compute_extension:flavormanage to be performed.
49
 
 
50
 
Currently all nova flavors have a global scope, which leads to several issues:
51
 
1. Per-stack flavor creation will pollute the global flavor list.
52
 
2. If two stacks create a flavor with the same name collision will occur,
53
 
which will lead to the following error:
54
 
 
55
 
 ERROR (Conflict): Flavor with name dupflavor already exists.
56