d6404d2f99
As agreed on the summit I'm renaming the python modules and doing some adjustments: * This is a breaking change, so version is bumped to 2.0.0 * Used this chance to split conf options over proper sections * RELEASES.rst is gone; it's too hard to keep it up-to-date; anyway git does better job at doing history * Dropped deprecated option ports_for_inactive_interfaces * Dropped old /v1/discover endpoint and associated client call * No longer set on_discovery and newly_discovered in Node.extra (deprecated since 1.0.0, superseded by the get status API) * Default firewall chain name is "ironic-inspector" and is configurable Notes: * Some links will be updated after real move. * Stable branches will probably use the old name. * Some usage of discovery word is left in context of "discovered data" * DIB element will probably be deprecated, so leaving it alone for now. * Some usages of word "discovery" in the README will be updated later to make this patch a bit smaller * Ramdisk code will be moved to IPA, so not touching it too much Change-Id: I59f1f5bfb1248ab69973dab845aa028df493054e
92 lines
3.4 KiB
Python
92 lines
3.4 KiB
Python
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
|
# implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
|
|
from oslo_utils import netutils
|
|
import requests
|
|
import six
|
|
|
|
from ironic_inspector.common.i18n import _
|
|
|
|
|
|
_DEFAULT_URL = 'http://' + netutils.get_my_ipv4() + ':5050/v1'
|
|
_ERROR_ENCODING = 'utf-8'
|
|
|
|
|
|
def _prepare(base_url, auth_token):
|
|
base_url = (base_url or _DEFAULT_URL).rstrip('/')
|
|
if not base_url.endswith('v1'):
|
|
base_url += '/v1'
|
|
headers = {'X-Auth-Token': auth_token} if auth_token else {}
|
|
return base_url, headers
|
|
|
|
|
|
class ClientError(requests.HTTPError):
|
|
"""Error returned from a server."""
|
|
def __init__(self, response):
|
|
# inspector returns error message in body
|
|
msg = response.content.decode(_ERROR_ENCODING)
|
|
super(ClientError, self).__init__(msg, response=response)
|
|
|
|
@classmethod
|
|
def raise_if_needed(cls, response):
|
|
"""Raise exception if response contains error."""
|
|
if response.status_code >= 400:
|
|
raise cls(response)
|
|
|
|
|
|
def introspect(uuid, base_url=None, auth_token=None,
|
|
new_ipmi_password=None, new_ipmi_username=None):
|
|
"""Start introspection for a node.
|
|
|
|
:param uuid: node uuid
|
|
:param base_url: *ironic-inspector* URL in form: http://host:port[/ver],
|
|
defaults to ``http://<current host>:5050/v1``.
|
|
:param auth_token: Keystone authentication token.
|
|
:param new_ipmi_password: if set, *ironic-inspector* will update IPMI
|
|
password to this value.
|
|
:param new_ipmi_username: if new_ipmi_password is set, this values sets
|
|
new IPMI user name. Defaults to one in
|
|
driver_info.
|
|
"""
|
|
if not isinstance(uuid, six.string_types):
|
|
raise TypeError(_("Expected string for uuid argument, got %r") % uuid)
|
|
if new_ipmi_username and not new_ipmi_password:
|
|
raise ValueError(_("Setting IPMI user name requires a new password"))
|
|
|
|
base_url, headers = _prepare(base_url, auth_token)
|
|
params = {'new_ipmi_username': new_ipmi_username,
|
|
'new_ipmi_password': new_ipmi_password}
|
|
res = requests.post("%s/introspection/%s" % (base_url, uuid),
|
|
headers=headers, params=params)
|
|
ClientError.raise_if_needed(res)
|
|
|
|
|
|
def get_status(uuid, base_url=None, auth_token=None):
|
|
"""Get introspection status for a node.
|
|
|
|
New in ironic-inspector version 1.0.0.
|
|
:param uuid: node uuid.
|
|
:param base_url: *ironic-inspector* URL in form: http://host:port[/ver],
|
|
defaults to ``http://<current host>:5050/v1``.
|
|
:param auth_token: Keystone authentication token.
|
|
:raises: *requests* library HTTP errors.
|
|
"""
|
|
if not isinstance(uuid, six.string_types):
|
|
raise TypeError(_("Expected string for uuid argument, got %r") % uuid)
|
|
|
|
base_url, headers = _prepare(base_url, auth_token)
|
|
res = requests.get("%s/introspection/%s" % (base_url, uuid),
|
|
headers=headers)
|
|
ClientError.raise_if_needed(res)
|
|
return res.json()
|