summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJenkins <jenkins@review.openstack.org>2016-10-03 19:49:33 +0000
committerGerrit Code Review <review@openstack.org>2016-10-03 19:49:33 +0000
commitc80cea39db58086d7b8aa17cdb8317136db138f8 (patch)
tree502eedaf770868361fa80d54f9ea3ac98615cf65
parenta93189f0f319d3b74256229608246628c4be8af2 (diff)
parenta8d06381aa5c2a3343a0536caef5a4caa1207203 (diff)
Merge "Spec for ironic plugin"
-rw-r--r--doc/source/index.rst9
-rw-r--r--specs/ocata/ironic-plugin.rst60
2 files changed, 69 insertions, 0 deletions
diff --git a/doc/source/index.rst b/doc/source/index.rst
index acd5156..6d05a08 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -43,6 +43,15 @@ Mitaka
43 43
44 specs/mitaka/** 44 specs/mitaka/**
45 45
46Ocata
47=====
48
49.. toctree::
50 :glob:
51 :maxdepth: 1
52
53 specs/ocata/**
54
46================== 55==================
47Indices and tables 56Indices and tables
48================== 57==================
diff --git a/specs/ocata/ironic-plugin.rst b/specs/ocata/ironic-plugin.rst
new file mode 100644
index 0000000..e19bf0d
--- /dev/null
+++ b/specs/ocata/ironic-plugin.rst
@@ -0,0 +1,60 @@
1
2..
3 Licensed under the Apache License, Version 2.0 (the "License"); you may
4 not use this file except in compliance with the License. You may obtain
5 a copy of the License at
6
7 http://www.apache.org/licenses/LICENSE-2.0
8
9 Unless required by applicable law or agreed to in writing, software
10 distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
11 WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
12 License for the specific language governing permissions and limitations
13 under the License.
14
15==============
16Ironic plugin
17==============
18
19https://blueprints.launchpad.net/searchlight/+spec/ironic-plugin
20
21This spec is proposed to add ironic plugin for Searchlight. Ironic is OpenStack
22baremetal service. Plugin should support these baremetal resourses: nodes
23(OS::Ironic::Node), ports (OS::Ironic::Port) and chassis (OS::Ironic::Chassis).
24
25Problem Description
26===================
27
28Notifications about baremetal node state changes (power, provisioning) and
29create, update and delete of resources are proposed to ironic ([1]_, [2]_).
30Because information about node in the database can be changed quickly during
31deployment specification [2]_ provides ways to limits flow of notifications.
32Using of Searchlight API with ironic plugin can reduce load on ironic API
33from periodical polling tasks.
34
35Proposed Change
36===============
37
381. Searchlight listener should be changed because ironic can use any
39notifications message priority, not only INFO ([1]_). For possibility of use
40this feature and backward compatibility new configuration option (list type)
41``additional_priorities`` will be added to ``listener`` group. Allowed
42values are "audit", "debug", "warn", "error", "critical" and "sample". Default
43value is not set (no additional priorities).
44
452. Plugin with indexers and notification handlers for ironic nodes, ports and
46chassis shoud be implemented.
47
483. Custom Searchlight config should be used with ironic because ironic uses
49own hardcoded ``ironic_versioned_notifications`` topic ([3]_).
50
51Alternatives
52------------
53
54None
55
56References
57==========
58.. [1] http://specs.openstack.org/openstack/ironic-specs/specs/approved/notifications.html
59.. [2] https://review.openstack.org/#/c/347242
60.. [3] http://docs.openstack.org/developer/ironic/dev/notifications.html