magnum/magnum/conductor/api.py
Spyros Trigazis (strigazi) 9b1bd5da54 Add cluster upgrade to the API
To enable the rolling upgrade ability of Kubernetes Cluster, this
patch is proposing a new API /upgrade to support upgrade the
base operating system of nodes and the version of Kubernetes, even
add-ons running on the k8s cluster:

POST <ClusterID>/actions/upgrade

And the post body will be:

{
    "cluster_template": 'dd9cc5ed-3a2b-11e9-9233-fa163e46bcc2',
    "max_batch_size": 1,
    "nodegroup": "production_group"
}

Co-Authored-By: Feilong Wang <flwang@catalyst.net.nz>

Task: 30168
Story: 2002210

Change-Id: Ia168877778aa0d473383eb06b1c8a16dc06b0576
2019-06-07 12:01:10 +12:00

156 lines
6.2 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.
"""API for interfacing with Magnum Backend."""
from magnum.common import profiler
from magnum.common import rpc_service
import magnum.conf
CONF = magnum.conf.CONF
# The Backend API class serves as a AMQP client for communicating
# on a topic exchange specific to the conductors. This allows the ReST
# API to trigger operations on the conductors
@profiler.trace_cls("rpc")
class API(rpc_service.API):
def __init__(self, transport=None, context=None, topic=None):
super(API, self).__init__(transport, context,
topic=CONF.conductor.topic)
# Cluster Operations
def cluster_create(self, cluster, master_count, node_count,
create_timeout):
return self._call('cluster_create', cluster=cluster,
master_count=master_count, node_count=node_count,
create_timeout=create_timeout)
def cluster_create_async(self, cluster, master_count, node_count,
create_timeout):
self._cast('cluster_create', cluster=cluster,
master_count=master_count, node_count=node_count,
create_timeout=create_timeout)
def cluster_delete(self, uuid):
return self._call('cluster_delete', uuid=uuid)
def cluster_delete_async(self, uuid):
self._cast('cluster_delete', uuid=uuid)
def cluster_update(self, cluster, node_count):
return self._call(
'cluster_update', cluster=cluster, node_count=node_count)
def cluster_update_async(self, cluster, node_count, rollback=False):
self._cast('cluster_update', cluster=cluster,
node_count=node_count, rollback=rollback)
def cluster_resize(self, cluster, node_count, nodes_to_remove,
nodegroup, rollback=False):
return self._call('cluster_resize',
cluster=cluster,
node_count=node_count,
nodes_to_remove=nodes_to_remove,
nodegroup=nodegroup)
def cluster_resize_async(self, cluster, node_count, nodes_to_remove,
nodegroup, rollback=False):
return self._cast('cluster_resize',
cluster=cluster,
node_count=node_count,
nodes_to_remove=nodes_to_remove,
nodegroup=nodegroup)
def cluster_upgrade(self, cluster, cluster_template, max_batch_size,
nodegroup):
return self._call('cluster_upgrade',
cluster=cluster,
cluster_template=cluster_template,
max_batch_size=max_batch_size,
nodegroup=nodegroup)
def cluster_upgrade_async(self, cluster, cluster_template, max_batch_size,
nodegroup):
return self._call('cluster_upgrade',
cluster=cluster,
cluster_template=cluster_template,
max_batch_size=max_batch_size,
nodegroup=nodegroup)
# Federation Operations
def federation_create(self, federation, create_timeout):
return self._call('federation_create', federation=federation,
create_timeout=create_timeout)
def federation_create_async(self, federation, create_timeout):
self._cast('federation_create', federation=federation,
create_timeout=create_timeout)
def federation_delete(self, uuid):
return self._call('federation_delete', uuid=uuid)
def federation_delete_async(self, uuid):
self._cast('federation_delete', uuid=uuid)
def federation_update(self, federation):
return self._call('federation_update', federation=federation)
def federation_update_async(self, federation, rollback=False):
self._cast('federation_update', federation=federation,
rollback=rollback)
# CA operations
def sign_certificate(self, cluster, certificate):
return self._call('sign_certificate', cluster=cluster,
certificate=certificate)
def get_ca_certificate(self, cluster):
return self._call('get_ca_certificate', cluster=cluster)
def rotate_ca_certificate(self, cluster):
return self._call('rotate_ca_certificate', cluster=cluster)
# Versioned Objects indirection API
def object_class_action(self, context, objname, objmethod, objver,
args, kwargs):
"Indirection API callback"
return self._client.call(context, 'object_class_action',
objname=objname, objmethod=objmethod,
objver=objver, args=args, kwargs=kwargs)
def object_action(self, context, objinst, objmethod, args, kwargs):
"Indirection API callback"
return self._client.call(context, 'object_action', objinst=objinst,
objmethod=objmethod, args=args, kwargs=kwargs)
def object_backport(self, context, objinst, target_version):
"Indirection API callback"
return self._client.call(context, 'object_backport', objinst=objinst,
target_version=target_version)
@profiler.trace_cls("rpc")
class ListenerAPI(rpc_service.API):
def __init__(self, context=None, topic=None, server=None, timeout=None):
super(ListenerAPI, self).__init__(context=context, topic=topic,
server=server, timeout=timeout)
def ping_conductor(self):
return self._call('ping_conductor')