There were still a couple of places where the threading code was using eventlet. Cleaned them up along with some other test issues noticed during debugging. Add a definition for cancel() to HubThread class in native code as it is called when threads are stopped in the BGP peer code. Use hub.kill(thread) to kill threads instead of thread.kill() as it will use hub-specific logic. Add a stop() method to BGP Peer class so users can stop any threads that might have been started in __init__(), like the periodic stats logger. Do not use eventlet to spawn threads in BGP code, always use self._spawn() which uses hub-specific code. Use hub.Semaphore class in bgp/speaker.py which uses the hub-specific semaphore code. Change BGP peer "looped" tests to not enable the periodic stats logging thread since it is unnecessary, and would require a call to the class stop() method on exit. Related-bug: #2087939 Change-Id: Ib2a1e12a2d5d25ede1cc1678d23e88ceae822b31 Signed-off-by: Brian Haley <haleyb.dev@gmail.com>
395 lines
12 KiB
Python
395 lines
12 KiB
Python
# Copyright (C) 2013 Nippon Telegraph and Telephone Corporation.
|
|
# Copyright (C) 2013 YAMAMOTO Takashi <yamamoto at valinux co jp>
|
|
#
|
|
# 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 logging
|
|
import os
|
|
import ssl
|
|
import socket
|
|
import sys
|
|
import traceback
|
|
|
|
from os_ken.lib import ip
|
|
|
|
|
|
# We don't bother to use cfg.py because monkey patch needs to be
|
|
# called very early. Instead, we use an environment variable to
|
|
# select the type of hub.
|
|
HUB_TYPE = os.getenv('OSKEN_HUB_TYPE', 'eventlet')
|
|
|
|
LOG = logging.getLogger('os_ken.lib.hub')
|
|
|
|
|
|
class StreamServer(object):
|
|
def __init__(self, listen_info, handle=None, backlog=None,
|
|
spawn='default', **ssl_args):
|
|
assert backlog is None
|
|
assert spawn == 'default'
|
|
|
|
if ip.valid_ipv6(listen_info[0]):
|
|
self.server = listen(listen_info, family=socket.AF_INET6)
|
|
elif os.path.isdir(os.path.dirname(listen_info[0])):
|
|
# Case for Unix domain socket
|
|
self.server = listen(listen_info[0], family=socket.AF_UNIX)
|
|
else:
|
|
self.server = listen(listen_info)
|
|
|
|
if ssl_args:
|
|
ssl_args.setdefault('server_side', True)
|
|
if 'ssl_ctx' not in ssl_args:
|
|
raise RuntimeError("no SSLContext ssl_ctx in ssl_args")
|
|
ctx = ssl_args.pop('ssl_ctx')
|
|
ctx.load_cert_chain(ssl_args.pop('certfile'),
|
|
ssl_args.pop('keyfile'))
|
|
if 'cert_reqs' in ssl_args:
|
|
ctx.verify_mode = ssl_args.pop('cert_reqs')
|
|
if 'ca_certs' in ssl_args:
|
|
ctx.load_verify_locations(ssl_args.pop('ca_certs'))
|
|
|
|
def wrap_and_handle_ctx(sock, addr):
|
|
handle(ctx.wrap_socket(sock, **ssl_args), addr)
|
|
|
|
self.handle = wrap_and_handle_ctx
|
|
else:
|
|
self.handle = handle
|
|
|
|
def serve_forever(self):
|
|
while True:
|
|
sock, addr = self.server.accept()
|
|
spawn(self.handle, sock, addr)
|
|
|
|
|
|
class StreamClient(object):
|
|
def __init__(self, addr, timeout=None, **ssl_args):
|
|
assert ip.valid_ipv4(addr[0]) or ip.valid_ipv6(addr[0])
|
|
self.addr = addr
|
|
self.timeout = timeout
|
|
self.ssl_args = ssl_args
|
|
self._is_active = True
|
|
|
|
def connect(self):
|
|
try:
|
|
if self.timeout is not None:
|
|
client = socket.create_connection(self.addr,
|
|
timeout=self.timeout)
|
|
else:
|
|
client = socket.create_connection(self.addr)
|
|
except socket.error:
|
|
return None
|
|
|
|
if self.ssl_args:
|
|
ctx = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT)
|
|
ctx.load_cert_chain(self.ssl_args.pop('certfile'),
|
|
self.ssl_args.pop('keyfile'))
|
|
if 'cert_reqs' in self.ssl_args:
|
|
ctx.verify_mode = self.ssl_args.pop('cert_reqs')
|
|
if 'ca_certs' in self.ssl_args:
|
|
ctx.load_verify_location(self.ssl_args.pop('ca_certs'))
|
|
client = ctx.wrap_socket(client, **self.ssl_args)
|
|
|
|
return client
|
|
|
|
def connect_loop(self, handle, interval):
|
|
while self._is_active:
|
|
sock = self.connect()
|
|
if sock:
|
|
handle(sock, self.addr)
|
|
sleep(interval)
|
|
|
|
def stop(self):
|
|
self._is_active = False
|
|
|
|
|
|
class LoggingWrapper(object):
|
|
def write(self, message):
|
|
LOG.info(message.rstrip('\n'))
|
|
|
|
|
|
class Event(object):
|
|
def __init__(self):
|
|
self._ev = HubEvent()
|
|
self._cond = False
|
|
|
|
def _wait(self, timeout=None):
|
|
while not self._cond:
|
|
self._ev.wait()
|
|
|
|
def _broadcast(self):
|
|
self._ev.send()
|
|
# Since eventlet Event doesn't allow multiple send() operations
|
|
# on an event, re-create the underlying event.
|
|
# Note: _ev.reset() is obsolete.
|
|
self._ev = HubEvent()
|
|
|
|
def is_set(self):
|
|
return self._cond
|
|
|
|
def set(self):
|
|
self._cond = True
|
|
self._broadcast()
|
|
|
|
def clear(self):
|
|
self._cond = False
|
|
|
|
def wait(self, timeout=None):
|
|
if timeout is None:
|
|
self._wait()
|
|
else:
|
|
try:
|
|
with Timeout(timeout):
|
|
self._wait()
|
|
except Timeout:
|
|
pass
|
|
|
|
return self._cond
|
|
|
|
|
|
if HUB_TYPE == 'eventlet':
|
|
import eventlet
|
|
# HACK:
|
|
# sleep() is the workaround for the following issue.
|
|
# https://github.com/eventlet/eventlet/issues/401
|
|
eventlet.sleep()
|
|
import eventlet.event
|
|
import eventlet.queue
|
|
import eventlet.semaphore
|
|
import eventlet.timeout
|
|
import eventlet.wsgi
|
|
from eventlet import websocket
|
|
import greenlet
|
|
|
|
getcurrent = eventlet.getcurrent
|
|
sleep = eventlet.sleep
|
|
listen = eventlet.listen
|
|
connect = eventlet.connect
|
|
|
|
def patch(thread=True):
|
|
eventlet.monkey_patch(thread=thread)
|
|
|
|
def spawn(*args, **kwargs):
|
|
raise_error = kwargs.pop('raise_error', False)
|
|
|
|
def _launch(func, *args, **kwargs):
|
|
# Mimic gevent's default raise_error=False behaviour
|
|
# by not propagating an exception to the joiner.
|
|
try:
|
|
return func(*args, **kwargs)
|
|
except TaskExit:
|
|
pass
|
|
except BaseException as e:
|
|
if raise_error:
|
|
raise e
|
|
# Log uncaught exception.
|
|
# Note: this is an intentional divergence from gevent
|
|
# behaviour; gevent silently ignores such exceptions.
|
|
LOG.error('hub: uncaught exception: %s',
|
|
traceback.format_exc())
|
|
|
|
return eventlet.spawn(_launch, *args, **kwargs)
|
|
|
|
def spawn_after(seconds, *args, **kwargs):
|
|
raise_error = kwargs.pop('raise_error', False)
|
|
|
|
def _launch(func, *args, **kwargs):
|
|
# Mimic gevent's default raise_error=False behaviour
|
|
# by not propagating an exception to the joiner.
|
|
try:
|
|
return func(*args, **kwargs)
|
|
except TaskExit:
|
|
pass
|
|
except BaseException as e:
|
|
if raise_error:
|
|
raise e
|
|
# Log uncaught exception.
|
|
# Note: this is an intentional divergence from gevent
|
|
# behaviour; gevent silently ignores such exceptions.
|
|
LOG.error('hub: uncaught exception: %s',
|
|
traceback.format_exc())
|
|
|
|
return eventlet.spawn_after(seconds, _launch, *args, **kwargs)
|
|
|
|
def kill(thread):
|
|
thread.kill()
|
|
|
|
def joinall(threads):
|
|
for t in threads:
|
|
# This try-except is necessary when killing an inactive
|
|
# greenthread.
|
|
try:
|
|
t.wait()
|
|
except TaskExit:
|
|
pass
|
|
|
|
Queue = eventlet.queue.LightQueue
|
|
QueueEmpty = eventlet.queue.Empty
|
|
Semaphore = eventlet.semaphore.Semaphore
|
|
BoundedSemaphore = eventlet.semaphore.BoundedSemaphore
|
|
TaskExit = greenlet.GreenletExit
|
|
|
|
class WSGIServer(StreamServer):
|
|
def serve_forever(self):
|
|
self.logger = LoggingWrapper()
|
|
eventlet.wsgi.server(self.server, self.handle, self.logger)
|
|
|
|
WebSocketWSGI = websocket.WebSocketWSGI
|
|
|
|
Timeout = eventlet.timeout.Timeout
|
|
HubEvent = eventlet.event.Event
|
|
|
|
elif HUB_TYPE == 'native':
|
|
LOG.warning("The native implementation is incomplete "
|
|
"and should not be used in production environments.")
|
|
import threading
|
|
import queue
|
|
import time
|
|
|
|
class HubThread(threading.Thread):
|
|
def wait(self, timeout=None):
|
|
self.join(timeout)
|
|
|
|
def __init__(self, target, args=(), kwargs=None):
|
|
self.raise_error = kwargs.pop('raise_error', False)
|
|
super().__init__(target=target, args=args, kwargs=kwargs)
|
|
|
|
def run(self):
|
|
try:
|
|
super().run()
|
|
except TaskExit:
|
|
pass
|
|
except BaseException as e:
|
|
if self.raise_error:
|
|
raise e
|
|
LOG.error('HubThread uncaught exception: %s',
|
|
traceback.format_exc())
|
|
|
|
def cancel(self):
|
|
pass
|
|
|
|
def spawn(func, *args, **kwargs):
|
|
thread = HubThread(func, args, kwargs)
|
|
thread.start()
|
|
return thread
|
|
|
|
def spawn_after(seconds, func, *args, **kwargs):
|
|
def delayed_func():
|
|
time.sleep(seconds)
|
|
func(*args, **kwargs)
|
|
return spawn(delayed_func)
|
|
|
|
def joinall(threads):
|
|
for thread in threads:
|
|
thread.join()
|
|
|
|
def kill(thread):
|
|
# NOTE(sahid): There is no safe and reliable way to force
|
|
# stopping a thread in Python. It is recommended to implement
|
|
# a proper termination mechanism using a flag or an event.
|
|
pass
|
|
|
|
getcurrent = threading.current_thread()
|
|
sleep = time.sleep
|
|
|
|
Queue = queue.Queue
|
|
QueueEmpty = queue.Empty
|
|
Semaphore = threading.Semaphore
|
|
BoundedSemaphore = threading.BoundedSemaphore
|
|
TaskExit = Exception
|
|
|
|
HubEvent = threading.Event
|
|
|
|
class HubEvent(threading.Event):
|
|
def send(self):
|
|
self.set()
|
|
|
|
class Timeout(BaseException):
|
|
"""
|
|
Largely inspired by:
|
|
https://github.com/eventlet/eventlet/blob/master/eventlet/timeout.py
|
|
"""
|
|
def __init__(self, seconds=None, exception=None):
|
|
self._event = threading.Event()
|
|
self._queue = queue.Queue()
|
|
|
|
self.seconds = seconds
|
|
self.exception = exception
|
|
|
|
self.timer = None
|
|
|
|
self.start()
|
|
|
|
def start(self):
|
|
if self.seconds is None:
|
|
# "fake" timeout (never expires)
|
|
self.timer = None
|
|
else:
|
|
self.timer = threading.Timer(self.seconds, self._on_timeout)
|
|
self.timer.start()
|
|
self._wait()
|
|
return self
|
|
|
|
def __enter__(self):
|
|
if self.timer is None:
|
|
self.start()
|
|
return self
|
|
|
|
def __exit__(self, typ, value, tb):
|
|
self.cancel()
|
|
if value is self and self.exception is False:
|
|
return True
|
|
|
|
def _on_timeout(self):
|
|
if self.exception is None or isinstance(self.exception, bool):
|
|
# timeout that raises self
|
|
exc = self
|
|
else:
|
|
exc = self.exception
|
|
self._queue.put(exc)
|
|
self._event.set()
|
|
|
|
def cancel(self):
|
|
self.timer.cancel()
|
|
self._event.set()
|
|
|
|
def _wait(self):
|
|
self._event.wait()
|
|
try:
|
|
raise self._queue.get_nowait()
|
|
except queue.Empty:
|
|
pass
|
|
|
|
def listen(addr, family=socket.AF_INET, backlog=50, reuse_addr=True,
|
|
reuse_port=None):
|
|
"""
|
|
Largely inspired by:
|
|
https://github.com/eventlet/eventlet/../eventlet/convenience.py
|
|
"""
|
|
sock = socket.socket(family, socket.SOCK_STREAM)
|
|
if reuse_addr and sys.platform[:3] != 'win':
|
|
sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
|
|
elif reuse_port is None:
|
|
reuse_port = True
|
|
if reuse_port and hasattr(socket, 'SO_REUSEPORT'):
|
|
try:
|
|
sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEPORT, 1)
|
|
except Exception:
|
|
# Not supported by the platform
|
|
pass
|
|
sock.bind(addr)
|
|
sock.listen(backlog)
|
|
return sock
|
|
else:
|
|
raise NotImplementedError(
|
|
"Invalid OSKEN_HUB_TYPE. Expected one of ('eventlet', 'native').")
|