Thank you for all answers.
I know that meta data tags are "free" to use with any key/value, still
there are some specific values that triggers pieces of code in nova (or
maybe even in other components). In particular I am working on one of
these key/value, in my case it should enable the

<bios rebootTimeout=value/>

parameter in libvirt. Anyway even if my code is merged, no one will know
about it (except myself and the reviewers) if it is not documented
somewhere. A DocImpact flag was added to the commit message, but I still
don't know how to proper document it. I may create/update existing wiki
pages, but I would have preferred an official documentation: I was not
able to find the wiki page proposed by Daniel Berrange, even if I had
been searching exactly to something similar :(
It is very good that there is a work to objectify image meta, anyway is
there any recommendation  how to document it in the meanwhile?

I would also know if there is any naming convention for image meta and
flavor extra-spec keys: in my case I used hw_reboot_timeoutand
hw:reboot_timeout respectively, but it is more a bios than hardware
feature and they are handled in nova/virt/libvirt/ rather than
nova/virt/ so maybe the name choice was not so good.

On 02/11/15 11:25, Bhandaru, Malini K wrote:
> Pasquale Porreca,
> The flexibility/ freedom to create meta data tags for images and Nova flavor 
> extra specs can be confusing. Even allows one to make typographical errors 
> that may be hard to detect.
> As Daniel mentions, some tags have a definite meaning/semantics, others can 
> be totally random.
> Tags with semantic significance will typically be handled by special purpose 
> filters, look in Nova/filters directory, 
> /opt/stack/nova/nova/scheduler/filters
> The filters documentation in Nova admin guide may help too.
> All the rest are just matched as strings.
> Hope that helps.
> Regards
> Malini
> -----Original Message-----
> From: Kashyap Chamarthy [] 
> Sent: Wednesday, February 11, 2015 2:14 AM
> To: OpenStack Development Mailing List (not for usage questions)
> Subject: Re: [openstack-dev] [nova] Flavor extra-spec and image metadata 
> documentation
> On Wed, Feb 11, 2015 at 10:23:54AM +0100, Pasquale Porreca wrote:
>> Hello
>> I am working on a little patch that introduce a new flavor extra-spec 
>> and image metadata key-value pair 
>> I am wondering how an openstack admin can be aware that a specific 
>> value of a flavor extra-spec or image metadata provides a feature he 
>> may desire, in other words is there a place where the flavor 
>> extra-specs and/or image metadata key-value pairs are documented?
> Unfortunately, there's none as of now. I found this the hard way that you 
> cannot trivially find all possible 'extra_spec' key values that can be set by 
> `nova flavor-key`
> I did gross things like this:
>     $ grep hw\: nova/virt/ nova/tests/unit/virt/ | 
> sort | uniq
> And, obviously the above will only find you 'hw' properties.
> Daniel Berrangé once suggested that image properties and flavor extra specs 
> need to be 'objectified' to alleviate this.
>> I found plenty of documentation on how to list, create, delete, etc.
>> flavor extra-spec and image metadata, but the only place where I found 
>> a list (is that complete?) of the accepted (i.e. that trigger specific 
>> feature in nova) key-value pairs is in horizon dashboard, when logged 
>> with admin credential.
>> I am a bit confused on how someone working to add a new key/value pair 
>> should proceed.
> --
> /kashyap
> __________________________________________________________________________
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe:
> __________________________________________________________________________
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe:

Pasquale Porreca

DEK Technologies
Via dei Castelli Romani, 22
00040 Pomezia (Roma)

Mobile +39 3394823805
Skype paskporr

OpenStack Development Mailing List (not for usage questions)

Reply via email to