916d97b5d6
Unifies haproxy reference implementation to make common agent based plugin driver which is suitable for all vendors who wants to use async mechanism. - Agent API as well as device driver API changed to handle loadbalancer objects individually; - Agent loads device drivers according to config; - LogicalDeviceCache class was removed from agent as it was used only as a list - to put and remove entries ant check whether entry is in or not. It was replaced with instance_mapping dict in agent to store known instances and corresponding device_drivers; - Agent reports which device drivers are supported (needs for scheduling on plugin side); - Agent-to-plugin API was extended to provide an ability for agent to update statuses of pools/vips/members/health_monitors; - Vendor should only implement device driver; plugin driver just needs to inherit AgentBasedPluginDriver and override device_driver member; - This patch doesn't move files to make review easier; all rename/replace will be done in a subsequent patch; DocImpact NOTE: Since the change in the agent RPC API is backward-incompatible (major RPC version change), LBaaS server-agent communications will be completely broken until both sides are upgraded so users will be unable to create new or update existing HAProxy loadbalancer instances during upgrade Implements blueprint lbaas-common-agent-driver Change-Id: I9fd90a1321611d202ef838681273081fa6c1686a
131 lines
4.4 KiB
Python
131 lines
4.4 KiB
Python
# vim: tabstop=4 shiftwidth=4 softtabstop=4
|
|
#
|
|
# Copyright 2013 Radware LTD.
|
|
#
|
|
# 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.
|
|
#
|
|
# @author: Avishay Balderman, Radware
|
|
|
|
import abc
|
|
|
|
import six
|
|
|
|
|
|
@six.add_metaclass(abc.ABCMeta)
|
|
class LoadBalancerAbstractDriver(object):
|
|
"""Abstract lbaas driver that expose ~same API as lbaas plugin.
|
|
|
|
The configuration elements (Vip,Member,etc) are the dicts that
|
|
are returned to the tenant.
|
|
Get operations are not part of the API - it will be handled
|
|
by the lbaas plugin.
|
|
"""
|
|
|
|
@abc.abstractmethod
|
|
def create_vip(self, context, vip):
|
|
"""A real driver would invoke a call to his backend
|
|
and set the Vip status to ACTIVE/ERROR according
|
|
to the backend call result
|
|
self.plugin.update_status(context, Vip, vip["id"],
|
|
constants.ACTIVE)
|
|
"""
|
|
pass
|
|
|
|
@abc.abstractmethod
|
|
def update_vip(self, context, old_vip, vip):
|
|
"""Driver may call the code below in order to update the status.
|
|
self.plugin.update_status(context, Vip, id, constants.ACTIVE)
|
|
"""
|
|
pass
|
|
|
|
@abc.abstractmethod
|
|
def delete_vip(self, context, vip):
|
|
"""A real driver would invoke a call to his backend
|
|
and try to delete the Vip.
|
|
if the deletion was successful, delete the record from the database.
|
|
if the deletion has failed, set the Vip status to ERROR.
|
|
"""
|
|
pass
|
|
|
|
@abc.abstractmethod
|
|
def create_pool(self, context, pool):
|
|
"""Driver may call the code below in order to update the status.
|
|
self.plugin.update_status(context, Pool, pool["id"],
|
|
constants.ACTIVE)
|
|
"""
|
|
pass
|
|
|
|
@abc.abstractmethod
|
|
def update_pool(self, context, old_pool, pool):
|
|
"""Driver may call the code below in order to update the status.
|
|
self.plugin.update_status(context,
|
|
Pool,
|
|
pool["id"], constants.ACTIVE)
|
|
"""
|
|
pass
|
|
|
|
@abc.abstractmethod
|
|
def delete_pool(self, context, pool):
|
|
"""Driver can call the code below in order to delete the pool.
|
|
self.plugin._delete_db_pool(context, pool["id"])
|
|
or set the status to ERROR if deletion failed
|
|
"""
|
|
pass
|
|
|
|
@abc.abstractmethod
|
|
def stats(self, context, pool_id):
|
|
pass
|
|
|
|
@abc.abstractmethod
|
|
def create_member(self, context, member):
|
|
"""Driver may call the code below in order to update the status.
|
|
self.plugin.update_status(context, Member, member["id"],
|
|
constants.ACTIVE)
|
|
"""
|
|
pass
|
|
|
|
@abc.abstractmethod
|
|
def update_member(self, context, old_member, member):
|
|
"""Driver may call the code below in order to update the status.
|
|
self.plugin.update_status(context, Member,
|
|
member["id"], constants.ACTIVE)
|
|
"""
|
|
pass
|
|
|
|
@abc.abstractmethod
|
|
def delete_member(self, context, member):
|
|
pass
|
|
|
|
@abc.abstractmethod
|
|
def update_pool_health_monitor(self, context,
|
|
old_health_monitor,
|
|
health_monitor,
|
|
pool_id):
|
|
pass
|
|
|
|
@abc.abstractmethod
|
|
def create_pool_health_monitor(self, context,
|
|
health_monitor,
|
|
pool_id):
|
|
"""Driver may call the code below in order to update the status.
|
|
self.plugin.update_pool_health_monitor(context,
|
|
health_monitor["id"],
|
|
pool_id,
|
|
constants.ACTIVE)
|
|
"""
|
|
pass
|
|
|
|
@abc.abstractmethod
|
|
def delete_pool_health_monitor(self, context, health_monitor, pool_id):
|
|
pass
|