/usr/lib/python2.7/dist-packages/os_faults/api/service.py is in python-os-faults 0.1.17-0ubuntu1.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 | # 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.
import abc
import six
from os_faults.api import base_driver
from os_faults.api.utils import public
@six.add_metaclass(abc.ABCMeta)
class Service(base_driver.BaseDriver):
def __init__(self, service_name, config, node_cls, cloud_management,
hosts=None):
self.service_name = service_name
self.config = config
self.node_cls = node_cls
self.cloud_management = cloud_management
self.hosts = hosts
@abc.abstractmethod
def discover_nodes(self):
"""Discover nodes where this Service is running
:returns: NodesCollection
"""
def get_nodes(self):
"""Get nodes where this Service is running
:returns: NodesCollection
"""
if self.hosts is not None:
nodes = self.cloud_management.get_nodes()
hosts = [h for h in nodes.hosts if h.ip in self.hosts]
return self.node_cls(cloud_management=self.cloud_management,
hosts=hosts)
return self.discover_nodes()
@public
def restart(self, nodes=None):
"""Restart Service on all nodes or on particular subset
:param nodes: NodesCollection
"""
raise NotImplementedError
@public
def terminate(self, nodes=None):
"""Terminate Service gracefully on all nodes or on particular subset
:param nodes: NodesCollection
"""
raise NotImplementedError
@public
def start(self, nodes=None):
"""Start Service on all nodes or on particular subset
:param nodes: NodesCollection
"""
raise NotImplementedError
@public
def kill(self, nodes=None):
"""Terminate Service abruptly on all nodes or on particular subset
:param nodes: NodesCollection
"""
raise NotImplementedError
@public
def unplug(self, nodes=None):
"""Unplug Service out of network on all nodes or on particular subset
:param nodes: NodesCollection
"""
raise NotImplementedError
@public
def plug(self, nodes=None):
"""Plug Service into network on all nodes or on particular subset
:param nodes: NodesCollection
"""
raise NotImplementedError
@public
def freeze(self, nodes=None, sec=None):
"""Pause service execution
Send SIGSTOP to Service into network on all nodes or on particular
subset. If sec is defined - it mean Service will be stopped for
a wile.
:param nodes: NodesCollection
:param sec: int
"""
raise NotImplementedError
@public
def unfreeze(self, nodes=None):
"""Resume service execution
Send SIGCONT to Service into network on all nodes or on particular
subset.
:param nodes: NodesCollection
"""
raise NotImplementedError
|