bc84272a50c47eab4285a43e368da2d3b3ece87a
2 Copyright (c) 2015 SONATA-NFV and Paderborn University
5 Licensed under the Apache License, Version 2.0 (the "License");
6 you may not use this file except in compliance with the License.
7 You may obtain a copy of the License at
9 http://www.apache.org/licenses/LICENSE-2.0
11 Unless required by applicable law or agreed to in writing, software
12 distributed under the License is distributed on an "AS IS" BASIS,
13 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 See the License for the specific language governing permissions and
15 limitations under the License.
17 Neither the name of the SONATA-NFV [, ANY ADDITIONAL AFFILIATION]
18 nor the names of its contributors may be used to endorse or promote
19 products derived from this software without specific prior written
22 This work has been performed in the framework of the SONATA project,
23 funded by the European Commission under Grant number 671517 through
24 the Horizon 2020 and 5G-PPP programmes. The authors would like to
25 acknowledge the contributions of their colleagues of the SONATA
26 partner consortium (www.sonata-nfv.eu).
29 This module implements a simple REST API that behaves like SONATA's gatekeeper.
31 It is only used to support the development of SONATA's SDK tools and to demonstrate
32 the year 1 version of the emulator until the integration with WP4's orchestrator is done.
42 from docker
import Client
as DockerClient
43 from flask
import Flask
, request
44 import flask_restful
as fr
45 from collections
import defaultdict
49 LOG
= logging
.getLogger("sonata-dummy-gatekeeper")
50 LOG
.setLevel(logging
.DEBUG
)
51 logging
.getLogger("werkzeug").setLevel(logging
.WARNING
)
53 GK_STORAGE
= "/tmp/son-dummy-gk/"
54 UPLOAD_FOLDER
= os
.path
.join(GK_STORAGE
, "uploads/")
55 CATALOG_FOLDER
= os
.path
.join(GK_STORAGE
, "catalog/")
57 # Enable Dockerfile build functionality
58 BUILD_DOCKERFILE
= False
60 # flag to indicate that we run without the emulator (only the bare API for integration testing)
61 GK_STANDALONE_MODE
= False
63 # should a new version of an image be pulled even if its available
66 # Automatically deploy SAPs (endpoints) of the service as new containers
67 # Attention: This is not a configuration switch but a global variable! Don't change its default value.
70 # flag to indicate if we use bidirectional forwarding rules in the automatic chaining process
71 BIDIRECTIONAL_CHAIN
= False
73 class Gatekeeper(object):
76 self
.services
= dict()
78 self
.vnf_counter
= 0 # used to generate short names for VNFs (Mininet limitation)
79 LOG
.info("Create SONATA dummy gatekeeper.")
81 def register_service_package(self
, service_uuid
, service
):
83 register new service package
87 self
.services
[service_uuid
] = service
88 # lets perform all steps needed to onboard the service
91 def get_next_vnf_name(self
):
93 return "vnf%d" % self
.vnf_counter
96 class Service(object):
98 This class represents a NS uploaded as a *.son package to the
100 Can have multiple running instances of this service.
107 self
.uuid
= service_uuid
108 self
.package_file_hash
= package_file_hash
109 self
.package_file_path
= package_file_path
110 self
.package_content_path
= os
.path
.join(CATALOG_FOLDER
, "services/%s" % self
.uuid
)
114 self
.local_docker_files
= dict()
115 self
.remote_docker_image_urls
= dict()
116 self
.instances
= dict()
117 self
.vnf_name2docker_name
= dict()
118 self
.sap_identifiers
= set()
119 # lets generate a set of subnet configurations used for e-line chaining setup
120 self
.eline_subnets_src
= generate_subnet_strings(50, start
=200, subnet_size
=24, ip
=1)
121 self
.eline_subnets_dst
= generate_subnet_strings(50, start
=200, subnet_size
=24, ip
=2)
125 Do all steps to prepare this service to be instantiated
128 # 1. extract the contents of the package and store them in our catalog
129 self
._unpack
_service
_package
()
130 # 2. read in all descriptor files
131 self
._load
_package
_descriptor
()
136 # 3. prepare container images (e.g. download or build Dockerfile)
138 self
._load
_docker
_files
()
139 self
._build
_images
_from
_dockerfiles
()
141 self
._load
_docker
_urls
()
142 self
._pull
_predefined
_dockerimages
()
143 LOG
.info("On-boarded service: %r" % self
.manifest
.get("name"))
145 def start_service(self
):
147 This methods creates and starts a new service instance.
148 It computes placements, iterates over all VNFDs, and starts
149 each VNFD as a Docker container in the data center selected
150 by the placement algorithm.
153 LOG
.info("Starting service %r" % self
.uuid
)
155 # 1. each service instance gets a new uuid to identify it
156 instance_uuid
= str(uuid
.uuid4())
157 # build a instances dict (a bit like a NSR :))
158 self
.instances
[instance_uuid
] = dict()
159 self
.instances
[instance_uuid
]["vnf_instances"] = list()
161 # 2. Configure the chaining of the network functions (currently only E-Line and E-LAN links supported)
162 vnf_id2vnf_name
= defaultdict(lambda: "NotExistingNode",
163 reduce(lambda x
, y
: dict(x
, **y
),
164 map(lambda d
: {d
["vnf_id"]: d
["vnf_name"]},
165 self
.nsd
["network_functions"])))
167 # 3. compute placement of this service instance (adds DC names to VNFDs)
168 if not GK_STANDALONE_MODE
:
169 #self._calculate_placement(FirstDcPlacement)
170 self
._calculate
_placement
(RoundRobinDcPlacement
)
171 # iterate over all vnfds that we have to start
172 for vnfd
in self
.vnfds
.itervalues():
174 if not GK_STANDALONE_MODE
:
175 vnfi
= self
._start
_vnfd
(vnfd
)
176 self
.instances
[instance_uuid
]["vnf_instances"].append(vnfi
)
178 vlinks
= self
.nsd
["virtual_links"]
179 fwd_links
= self
.nsd
["forwarding_graphs"][0]["constituent_virtual_links"]
180 eline_fwd_links
= [l
for l
in vlinks
if (l
["id"] in fwd_links
) and (l
["connectivity_type"] == "E-Line")]
181 elan_fwd_links
= [l
for l
in vlinks
if (l
["id"] in fwd_links
) and (l
["connectivity_type"] == "E-LAN")]
183 # 4a. deploy E-Line links
184 # cookie is used as identifier for the flowrules installed by the dummygatekeeper
185 # eg. different services get a unique cookie for their flowrules
187 for link
in eline_fwd_links
:
188 src_id
, src_if_name
= link
["connection_points_reference"][0].split(":")
189 dst_id
, dst_if_name
= link
["connection_points_reference"][1].split(":")
191 # check if there is a SAP in the link
192 if src_id
in self
.sap_identifiers
:
193 src_docker_name
= "{0}_{1}".format(src_id
, src_if_name
)
194 src_id
= src_docker_name
196 src_docker_name
= src_id
198 if dst_id
in self
.sap_identifiers
:
199 dst_docker_name
= "{0}_{1}".format(dst_id
, dst_if_name
)
200 dst_id
= dst_docker_name
202 dst_docker_name
= dst_id
204 src_name
= vnf_id2vnf_name
[src_id
]
205 dst_name
= vnf_id2vnf_name
[dst_id
]
208 "Setting up E-Line link. %s(%s:%s) -> %s(%s:%s)" % (
209 src_name
, src_id
, src_if_name
, dst_name
, dst_id
, dst_if_name
))
211 if (src_name
in self
.vnfds
) and (dst_name
in self
.vnfds
):
212 network
= self
.vnfds
[src_name
].get("dc").net
# there should be a cleaner way to find the DCNetwork
213 LOG
.debug(src_docker_name
)
214 ret
= network
.setChain(
215 src_docker_name
, dst_docker_name
,
216 vnf_src_interface
=src_if_name
, vnf_dst_interface
=dst_if_name
,
217 bidirectional
=BIDIRECTIONAL_CHAIN
, cmd
="add-flow", cookie
=cookie
, priority
=10)
219 # re-configure the VNFs IP assignment and ensure that a new subnet is used for each E-Link
220 src_vnfi
= self
._get
_vnf
_instance
(instance_uuid
, src_name
)
221 if src_vnfi
is not None:
222 self
._vnf
_reconfigure
_network
(src_vnfi
, src_if_name
, self
.eline_subnets_src
.pop(0))
223 dst_vnfi
= self
._get
_vnf
_instance
(instance_uuid
, dst_name
)
224 if dst_vnfi
is not None:
225 self
._vnf
_reconfigure
_network
(dst_vnfi
, dst_if_name
, self
.eline_subnets_dst
.pop(0))
227 # 4b. deploy E-LAN links
229 for link
in elan_fwd_links
:
230 # generate lan ip address
232 for intf
in link
["connection_points_reference"]:
233 ip_address
= generate_lan_string("10.0", base
, subnet_size
=24, ip
=ip
)
234 vnf_id
, intf_name
= intf
.split(":")
235 if vnf_id
in self
.sap_identifiers
:
236 src_docker_name
= "{0}_{1}".format(vnf_id
, intf_name
)
237 vnf_id
= src_docker_name
238 vnf_name
= vnf_id2vnf_name
[vnf_id
]
240 "Setting up E-LAN link. %s(%s:%s) -> %s" % (
241 vnf_name
, vnf_id
, intf_name
, ip_address
))
243 if vnf_name
in self
.vnfds
:
244 # re-configure the VNFs IP assignment and ensure that a new subnet is used for each E-LAN
245 # E-LAN relies on the learning switch capability of Ryu which has to be turned on in the topology
246 # (DCNetwork(controller=RemoteController, enable_learning=True)), so no explicit chaining is necessary.
247 vnfi
= self
._get
_vnf
_instance
(instance_uuid
, vnf_name
)
249 self
._vnf
_reconfigure
_network
(vnfi
, intf_name
, ip_address
)
250 # increase for the next ip address on this E-LAN
252 # increase the base ip address for the next E-LAN
255 # 5. run the emulator specific entrypoint scripts in the VNFIs of this service instance
256 self
._trigger
_emulator
_start
_scripts
_in
_vnfis
(self
.instances
[instance_uuid
]["vnf_instances"])
258 LOG
.info("Service started. Instance id: %r" % instance_uuid
)
261 def stop_service(self
, instance_uuid
):
263 This method stops a running service instance.
264 It iterates over all VNF instances, stopping them each
265 and removing them from their data center.
267 :param instance_uuid: the uuid of the service instance to be stopped
269 LOG
.info("Stopping service %r" % self
.uuid
)
270 # get relevant information
271 # instance_uuid = str(self.uuid.uuid4())
272 vnf_instances
= self
.instances
[instance_uuid
]["vnf_instances"]
274 for v
in vnf_instances
:
277 if not GK_STANDALONE_MODE
:
279 # self._remove_placement(RoundRobinPlacement)
282 # last step: remove the instance from the list of all instances
283 del self
.instances
[instance_uuid
]
285 def _start_vnfd(self
, vnfd
):
287 Start a single VNFD of this service
288 :param vnfd: vnfd descriptor dict
291 # iterate over all deployment units within each VNFDs
292 for u
in vnfd
.get("virtual_deployment_units"):
293 # 1. get the name of the docker image to start and the assigned DC
294 vnf_name
= vnfd
.get("name")
295 if vnf_name
not in self
.remote_docker_image_urls
:
296 raise Exception("No image name for %r found. Abort." % vnf_name
)
297 docker_name
= self
.remote_docker_image_urls
.get(vnf_name
)
298 target_dc
= vnfd
.get("dc")
299 # 2. perform some checks to ensure we can start the container
300 assert(docker_name
is not None)
301 assert(target_dc
is not None)
302 if not self
._check
_docker
_image
_exists
(docker_name
):
303 raise Exception("Docker image %r not found. Abort." % docker_name
)
304 # 3. do the dc.startCompute(name="foobar") call to run the container
305 # TODO consider flavors, and other annotations
306 intfs
= vnfd
.get("connection_points")
308 # TODO: get all vnf id's from the nsd for this vnfd and use those as dockername
309 # use the vnf_id in the nsd as docker name
310 # so deployed containers can be easily mapped back to the nsd
311 vnf_name2id
= defaultdict(lambda: "NotExistingNode",
312 reduce(lambda x
, y
: dict(x
, **y
),
313 map(lambda d
: {d
["vnf_name"]: d
["vnf_id"]},
314 self
.nsd
["network_functions"])))
315 self
.vnf_name2docker_name
[vnf_name
] = vnf_name2id
[vnf_name
]
316 # self.vnf_name2docker_name[vnf_name] = GK.get_next_vnf_name()
318 LOG
.info("Starting %r as %r in DC %r" % (vnf_name
, self
.vnf_name2docker_name
[vnf_name
], vnfd
.get("dc")))
319 LOG
.debug("Interfaces for %r: %r" % (vnf_name
, intfs
))
320 vnfi
= target_dc
.startCompute(self
.vnf_name2docker_name
[vnf_name
], network
=intfs
, image
=docker_name
, flavor_name
="small")
323 def _stop_vnfi(self
, vnfi
):
327 :param vnfi: vnf instance to be stopped
329 # Find the correct datacenter
330 status
= vnfi
.getStatus()
333 LOG
.info("Stopping the vnf instance contained in %r in DC %r" % (status
["name"], dc
))
334 dc
.stopCompute(status
["name"])
336 def _get_vnf_instance(self
, instance_uuid
, name
):
338 Returns the Docker object for the given VNF name (or Docker name).
339 :param instance_uuid: UUID of the service instance to search in.
340 :param name: VNF name or Docker name. We are fuzzy here.
344 if name
in self
.vnf_name2docker_name
:
345 dn
= self
.vnf_name2docker_name
[name
]
346 for vnfi
in self
.instances
[instance_uuid
]["vnf_instances"]:
349 LOG
.warning("No container with name: %r found.")
353 def _vnf_reconfigure_network(vnfi
, if_name
, net_str
):
355 Reconfigure the network configuration of a specific interface
356 of a running container.
357 :param vnfi: container instacne
358 :param if_name: interface name
359 :param net_str: network configuration string, e.g., 1.2.3.4/24
362 intf
= vnfi
.intf(intf
=if_name
)
365 LOG
.debug("Reconfigured network of %s:%s to %r" % (vnfi
.name
, if_name
, net_str
))
367 LOG
.warning("Interface not found: %s:%s. Network reconfiguration skipped." % (vnfi
.name
, if_name
))
370 def _trigger_emulator_start_scripts_in_vnfis(self
, vnfi_list
):
371 for vnfi
in vnfi_list
:
372 config
= vnfi
.dcinfo
.get("Config", dict())
373 env
= config
.get("Env", list())
375 if "SON_EMU_CMD=" in env_var
:
376 cmd
= str(env_var
.split("=")[1])
377 LOG
.info("Executing entry point script in %r: %r" % (vnfi
.name
, cmd
))
378 # execute command in new thread to ensure that GK is not blocked by VNF
379 t
= threading
.Thread(target
=vnfi
.cmdPrint
, args
=(cmd
,))
383 def _unpack_service_package(self
):
385 unzip *.son file and store contents in CATALOG_FOLDER/services/<service_uuid>/
387 LOG
.info("Unzipping: %r" % self
.package_file_path
)
388 with zipfile
.ZipFile(self
.package_file_path
, "r") as z
:
389 z
.extractall(self
.package_content_path
)
392 def _load_package_descriptor(self
):
394 Load the main package descriptor YAML and keep it as dict.
397 self
.manifest
= load_yaml(
399 self
.package_content_path
, "META-INF/MANIFEST.MF"))
403 Load the entry NSD YAML and keep it as dict.
406 if "entry_service_template" in self
.manifest
:
407 nsd_path
= os
.path
.join(
408 self
.package_content_path
,
409 make_relative_path(self
.manifest
.get("entry_service_template")))
410 self
.nsd
= load_yaml(nsd_path
)
411 LOG
.debug("Loaded NSD: %r" % self
.nsd
.get("name"))
413 def _load_vnfd(self
):
415 Load all VNFD YAML files referenced in MANIFEST.MF and keep them in dict.
418 if "package_content" in self
.manifest
:
419 for pc
in self
.manifest
.get("package_content"):
420 if pc
.get("content-type") == "application/sonata.function_descriptor":
421 vnfd_path
= os
.path
.join(
422 self
.package_content_path
,
423 make_relative_path(pc
.get("name")))
424 vnfd
= load_yaml(vnfd_path
)
425 self
.vnfds
[vnfd
.get("name")] = vnfd
426 LOG
.debug("Loaded VNFD: %r" % vnfd
.get("name"))
428 def _load_saps(self
):
429 # Each Service Access Point (connection_point) in the nsd is getting its own container
430 SAPs
= [p
["id"] for p
in self
.nsd
["connection_points"] if p
["type"] == "interface"]
432 # endpoints needed in this service
433 sap_vnf_id
, sap_vnf_interface
= sap
.split(':')
434 # set of the connection_point ids found in the nsd (in the examples this is 'ns')
435 self
.sap_identifiers
.add(sap_vnf_id
)
437 sap_docker_name
= "%s_%s" % (sap_vnf_id
, sap_vnf_interface
)
439 # add SAP to self.vnfds
440 sapfile
= pkg_resources
.resource_filename(__name__
, "sap_vnfd.yml")
441 sap_vnfd
= load_yaml(sapfile
)
442 sap_vnfd
["connection_points"][0]["id"] = sap_vnf_interface
443 sap_vnfd
["name"] = sap_docker_name
444 self
.vnfds
[sap_docker_name
] = sap_vnfd
445 # add SAP vnf to list in the NSD so it is deployed later on
446 # each SAP get a unique VNFD and vnf_id in the NSD
447 self
.nsd
["network_functions"].append({"vnf_id": sap_docker_name
, "vnf_name": sap_docker_name
})
448 LOG
.debug("Loaded SAP: %r" % sap_vnfd
.get("name"))
450 def _load_docker_files(self
):
452 Get all paths to Dockerfiles from VNFDs and store them in dict.
455 for k
, v
in self
.vnfds
.iteritems():
456 for vu
in v
.get("virtual_deployment_units"):
457 if vu
.get("vm_image_format") == "docker":
458 vm_image
= vu
.get("vm_image")
459 docker_path
= os
.path
.join(
460 self
.package_content_path
,
461 make_relative_path(vm_image
))
462 self
.local_docker_files
[k
] = docker_path
463 LOG
.debug("Found Dockerfile (%r): %r" % (k
, docker_path
))
465 def _load_docker_urls(self
):
467 Get all URLs to pre-build docker images in some repo.
470 for k
, v
in self
.vnfds
.iteritems():
471 for vu
in v
.get("virtual_deployment_units"):
472 if vu
.get("vm_image_format") == "docker":
473 url
= vu
.get("vm_image")
475 url
= url
.replace("http://", "")
476 self
.remote_docker_image_urls
[k
] = url
477 LOG
.debug("Found Docker image URL (%r): %r" % (k
, self
.remote_docker_image_urls
[k
]))
479 def _build_images_from_dockerfiles(self
):
481 Build Docker images for each local Dockerfile found in the package: self.local_docker_files
483 if GK_STANDALONE_MODE
:
484 return # do not build anything in standalone mode
486 LOG
.info("Building %d Docker images (this may take several minutes) ..." % len(self
.local_docker_files
))
487 for k
, v
in self
.local_docker_files
.iteritems():
488 for line
in dc
.build(path
=v
.replace("Dockerfile", ""), tag
=k
, rm
=False, nocache
=False):
489 LOG
.debug("DOCKER BUILD: %s" % line
)
490 LOG
.info("Docker image created: %s" % k
)
492 def _pull_predefined_dockerimages(self
):
494 If the package contains URLs to pre-build Docker images, we download them with this method.
497 for url
in self
.remote_docker_image_urls
.itervalues():
498 if not FORCE_PULL
: # only pull if not present (speedup for development)
499 if len(dc
.images(name
=url
)) > 0:
500 LOG
.debug("Image %r present. Skipping pull." % url
)
502 LOG
.info("Pulling image: %r" % url
)
504 insecure_registry
=True)
506 def _check_docker_image_exists(self
, image_name
):
508 Query the docker service and check if the given image exists
509 :param image_name: name of the docker image
512 return len(DockerClient().images(image_name
)) > 0
514 def _calculate_placement(self
, algorithm
):
516 Do placement by adding the a field "dc" to
517 each VNFD that points to one of our
518 data center objects known to the gatekeeper.
520 assert(len(self
.vnfds
) > 0)
521 assert(len(GK
.dcs
) > 0)
522 # instantiate algorithm an place
524 p
.place(self
.nsd
, self
.vnfds
, GK
.dcs
)
525 LOG
.info("Using placement algorithm: %r" % p
.__class
__.__name
__)
526 # lets print the placement result
527 for name
, vnfd
in self
.vnfds
.iteritems():
528 LOG
.info("Placed VNF %r on DC %r" % (name
, str(vnfd
.get("dc"))))
532 Some (simple) placement algorithms
536 class FirstDcPlacement(object):
538 Placement: Always use one and the same data center from the GK.dcs dict.
540 def place(self
, nsd
, vnfds
, dcs
):
541 for name
, vnfd
in vnfds
.iteritems():
542 vnfd
["dc"] = list(dcs
.itervalues())[0]
545 class RoundRobinDcPlacement(object):
547 Placement: Distribute VNFs across all available DCs in a round robin fashion.
549 def place(self
, nsd
, vnfds
, dcs
):
551 dcs_list
= list(dcs
.itervalues())
552 for name
, vnfd
in vnfds
.iteritems():
553 vnfd
["dc"] = dcs_list
[c
% len(dcs_list
)]
554 c
+= 1 # inc. c to use next DC
560 Resource definitions and API endpoints
564 class Packages(fr
.Resource
):
568 Upload a *.son service package to the dummy gatekeeper.
570 We expect request with a *.son file and store it in UPLOAD_FOLDER
576 # lets search for the package in the request
577 if "package" in request
.files
:
578 son_file
= request
.files
["package"]
579 # elif "file" in request.files:
580 # son_file = request.files["file"]
582 return {"service_uuid": None, "size": 0, "sha1": None, "error": "upload failed. file not found."}, 500
583 # generate a uuid to reference this package
584 service_uuid
= str(uuid
.uuid4())
585 file_hash
= hashlib
.sha1(str(son_file
)).hexdigest()
586 # ensure that upload folder exists
587 ensure_dir(UPLOAD_FOLDER
)
588 upload_path
= os
.path
.join(UPLOAD_FOLDER
, "%s.son" % service_uuid
)
589 # store *.son file to disk
590 son_file
.save(upload_path
)
591 size
= os
.path
.getsize(upload_path
)
592 # create a service object and register it
593 s
= Service(service_uuid
, file_hash
, upload_path
)
594 GK
.register_service_package(service_uuid
, s
)
595 # generate the JSON result
596 return {"service_uuid": service_uuid
, "size": size
, "sha1": file_hash
, "error": None}, 201
597 except Exception as ex
:
598 LOG
.exception("Service package upload failed:")
599 return {"service_uuid": None, "size": 0, "sha1": None, "error": "upload failed"}, 500
603 Return a list of UUID's of uploaded service packages.
606 LOG
.info("GET /packages")
607 return {"service_uuid_list": list(GK
.services
.iterkeys())}
610 class Instantiations(fr
.Resource
):
614 Instantiate a service specified by its UUID.
615 Will return a new UUID to identify the running service instance.
618 # try to extract the service uuid from the request
619 json_data
= request
.get_json(force
=True)
620 service_uuid
= json_data
.get("service_uuid")
622 # lets be a bit fuzzy here to make testing easier
623 if service_uuid
is None and len(GK
.services
) > 0:
624 # if we don't get a service uuid, we simple start the first service in the list
625 service_uuid
= list(GK
.services
.iterkeys())[0]
627 if service_uuid
in GK
.services
:
628 # ok, we have a service uuid, lets start the service
629 service_instance_uuid
= GK
.services
.get(service_uuid
).start_service()
630 return {"service_instance_uuid": service_instance_uuid
}
631 return "Service not found", 404
635 Returns a list of UUIDs containing all running services.
638 LOG
.info("GET /instantiations")
639 return {"service_instantiations_list": [
640 list(s
.instances
.iterkeys()) for s
in GK
.services
.itervalues()]}
644 Stops a running service specified by its service and instance UUID.
646 # try to extract the service and instance UUID from the request
647 json_data
= request
.get_json(force
=True)
648 service_uuid
= json_data
.get("service_uuid")
649 instance_uuid
= json_data
.get("instance_uuid")
652 if service_uuid
is None and len(GK
.services
) > 0:
653 #if we don't get a service uuid, we simply stop the last service in the list
654 service_uuid
= list(GK
.services
.iterkeys())[0]
655 if instance_uuid
is None and len(GK
.services
[service_uuid
].instances
) > 0:
656 instance_uuid
= list(GK
.services
[service_uuid
].instances
.iterkeys())[0]
658 if service_uuid
in GK
.services
and instance_uuid
in GK
.services
[service_uuid
].instances
:
659 # valid service and instance UUID, stop service
660 GK
.services
.get(service_uuid
).stop_service(instance_uuid
)
662 return "Service not found", 404
664 class Exit(fr
.Resource
):
668 Stop the running Containernet instance regardless of data transmitted
670 # exit the mininet CLI
673 # create a single, global GK object
676 app
= Flask(__name__
)
677 app
.config
['MAX_CONTENT_LENGTH'] = 512 * 1024 * 1024 # 512 MB max upload
680 api
.add_resource(Packages
, '/packages')
681 api
.add_resource(Instantiations
, '/instantiations')
682 api
.add_resource(Exit
, '/emulator/exit')
685 def start_rest_api(host
, port
, datacenters
=dict()):
687 # start the Flask server (not the best performance but ok for our use case)
691 use_reloader
=False # this is needed to run Flask in a non-main thread
695 def ensure_dir(name
):
696 if not os
.path
.exists(name
):
701 with
open(path
, "r") as f
:
704 except yaml
.YAMLError
as exc
:
705 LOG
.exception("YAML parse error")
710 def make_relative_path(path
):
711 if path
.startswith("file://"):
712 path
= path
.replace("file://", "", 1)
713 if path
.startswith("/"):
714 path
= path
.replace("/", "", 1)
718 def generate_lan_string(prefix
, base
, subnet_size
=24, ip
=0):
720 Helper to generate different network configuration strings.
722 r
= "%s.%d.%d/%d" % (prefix
, base
, ip
, subnet_size
)
726 def generate_subnet_strings(n
, start
=1, subnet_size
=24, ip
=0):
728 Helper to generate different network configuration strings.
731 for i
in range(start
, start
+ n
):
732 r
.append("%d.0.0.%d/%d" % (i
, ip
, subnet_size
))
736 if __name__
== '__main__':
738 Lets allow to run the API in standalone mode.
740 GK_STANDALONE_MODE
= True
741 logging
.getLogger("werkzeug").setLevel(logging
.INFO
)
742 start_rest_api("0.0.0.0", 8000)