summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorYuriy Zveryanskyy <yzveryanskyy@mirantis.com>2016-09-01 19:45:15 +0300
committerYuriy Zveryanskyy <yzveryanskyy@mirantis.com>2016-09-21 13:08:20 +0300
commita8d06381aa5c2a3343a0536caef5a4caa1207203 (patch)
tree01d5a700f8009590b7066f5c6632ce986d99b7c5
parent0f964956c0be8ae19d6fe4b3720f0095b533dd25 (diff)
Spec for ironic plugin
Notes
Notes (review): Code-Review+2: Travis Tripp <travis.tripp@hpe.com> Code-Review+2: David Lyle <dklyle0@gmail.com> Code-Review+2: Steve McLellan <steven.j.mclellan@gmail.com> Workflow+1: Steve McLellan <steven.j.mclellan@gmail.com> Verified+2: Jenkins Submitted-by: Jenkins Submitted-at: Mon, 03 Oct 2016 19:49:33 +0000 Reviewed-on: https://review.openstack.org/364457 Project: openstack/searchlight-specs Branch: refs/heads/master
-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