ironic-specs/specs/approved/nodes-tagging.rst
Devananda van der Veen dd42ff0341 Add "Ramdisk impact" section to spec template
As per the weekly meeting today [1] we have agreed to add a
new section to the spec template for changes that affect the
IPA ramdisk.

[1] http://eavesdrop.openstack.org/meetings/ironic/2016/ironic.2016-05-23-17.00.log.txt

Change-Id: I0f62e233dc7f2ad3e9940439f8ad7740de5e65c9
2016-07-15 13:43:34 +01:00

4.2 KiB

Nodes tagging

https://bugs.launchpad.net/ironic/+bug/1526266

This aims to add support for tagging nodes.

Problem description

Ironic should have tags field for every node, which can be used to divide the nodes to some groups. then we can do list by tag to get a group of nodes with same properties like hardware specs.

Proposed change

  • Add APIs that allows a user to add, remove, and list tags for a node.
  • Add tag filter parameter to node list API to allow searching for nodes based on one or more string tags.

Alternatives

Current chassis object is kind of an alternative for grouping nodes.

Data model impact

A new ironic.objects.tags.NodeTagList object would be added to the object model.

The ironic.objects.tags.NodeTagList field in the python object model will be populated on-demand (i.e. not eager-loaded).

A tag should be defined as a Unicode string no longer than 255 characters in length, with an index on this field.

Tags are strings attached to an entity with the purpose of classification into groups. To simplify requests that specify lists of tags, the comma character is not allowed to be in a tag name.

For the database schema, the following table constructs would suffice :

CREATE TABLE node_tags (
    node_id INT(11) NOT NULL,
    tag VARCHAR(255) CHARACTER SET utf8 NOT NULL,
    PRIMARY KEY (node_id, tag),
    KEY (tag),
    FOREIGN KEY (node_id)
      REFERENCES nodes(id)
      ON DELETE CASCADE,
)

REST API impact

We will follow the API Working Group's specification for tagging, rather than invent our own.

Will support addressing individual tags.

RPC API impact

None

State Machine Impact

None

Client (CLI) impact

Add tags CRUD operations commands:

  • ironic node-tag-list <node uuid>
  • ironic node-tag-update <node uuid> <op> <tags>

<op> Operation: 'add' or 'remove'

For individual tag: * ironic node-tag-add <node uuid> <tag> * ironic node-tag-remove <node uuid> <tag>

Add tag-list filtering support to node-list command:

  • ironic node-list --tag tag1 --tag tag2
  • ironic node-list --tag-any tag1 --tag-any tag2
  • ironic node-list --not-tag tag3

Multiple --tag will be used to filter results in an AND expression, and --tag-any for OR expression, allowing for exclusionary tags via the --not-tag option.

Driver API impact

None

Nova driver impact

The tags information can be used for nova but it's not being considered as part of this spec, and may be addressed at a later time.

Ramdisk impact

N/A

Security impact

None

Other end user impact

None

Scalability impact

None

Performance Impact

None

Other deployer impact

None

Developer impact

None

Implementation

Assignee(s)

Primary assignee:

niu-zglinux

Work Items

  • Add node_tags table with a migration.
  • Add DB API layer for CRUD operations on node tags.
  • Added DB API layer for node tag-list filtering support.
  • Add NodeTag, NodeTagList objects and a new tags field to Node object.
  • Add REST API for CRUD operations on node tags.
  • Add REST API for node tag-list filtering support.
  • python-ironicclient additions and modifications.

Dependencies

None

Testing

Add unit tests. Add tempest API tests.

Upgrades and Backwards Compatibility

Add a migration script for DB.

Documentation Impact

Ironic API and python-ironicclient will need to be updated to accompany this change.

References

  1. http://specs.openstack.org/openstack/api-wg/guidelines/tags.html