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
):
263 This method stops a running service instance.
264 It iterates over all VNFDs, stopping them each
265 and removing them from their data center.
273 def _start_vnfd(self
, vnfd
):
275 Start a single VNFD of this service
276 :param vnfd: vnfd descriptor dict
279 # iterate over all deployment units within each VNFDs
280 for u
in vnfd
.get("virtual_deployment_units"):
281 # 1. get the name of the docker image to start and the assigned DC
282 vnf_name
= vnfd
.get("name")
283 if vnf_name
not in self
.remote_docker_image_urls
:
284 raise Exception("No image name for %r found. Abort." % vnf_name
)
285 docker_name
= self
.remote_docker_image_urls
.get(vnf_name
)
286 target_dc
= vnfd
.get("dc")
287 # 2. perform some checks to ensure we can start the container
288 assert(docker_name
is not None)
289 assert(target_dc
is not None)
290 if not self
._check
_docker
_image
_exists
(docker_name
):
291 raise Exception("Docker image %r not found. Abort." % docker_name
)
292 # 3. do the dc.startCompute(name="foobar") call to run the container
293 # TODO consider flavors, and other annotations
294 intfs
= vnfd
.get("connection_points")
296 # TODO: get all vnf id's from the nsd for this vnfd and use those as dockername
297 # use the vnf_id in the nsd as docker name
298 # so deployed containers can be easily mapped back to the nsd
299 vnf_name2id
= defaultdict(lambda: "NotExistingNode",
300 reduce(lambda x
, y
: dict(x
, **y
),
301 map(lambda d
: {d
["vnf_name"]: d
["vnf_id"]},
302 self
.nsd
["network_functions"])))
303 self
.vnf_name2docker_name
[vnf_name
] = vnf_name2id
[vnf_name
]
304 # self.vnf_name2docker_name[vnf_name] = GK.get_next_vnf_name()
306 LOG
.info("Starting %r as %r in DC %r" % (vnf_name
, self
.vnf_name2docker_name
[vnf_name
], vnfd
.get("dc")))
307 LOG
.debug("Interfaces for %r: %r" % (vnf_name
, intfs
))
308 vnfi
= target_dc
.startCompute(self
.vnf_name2docker_name
[vnf_name
], network
=intfs
, image
=docker_name
, flavor_name
="small")
311 def _stop_vnfd(self
, vnf_name
):
313 Stop a VNFD specified by its name.
315 :param vnf_name: Name of the vnf to be stopped
318 if vnf_name
not in self
.vnfds
:
319 raise Exception("VNFD with name %s not found." % vnf_name
)
320 vnfd
= self
.vnfds
[vnf_name
]
322 LOG
.info("Stopping %r contained in %r in DC %r" % (vnf_name
, self
.vnf_name2docker_name
[vnf_name
], dc
)
323 dc
.stopCompute(self
.vnf_name2docker_name
[vnf_name
])
325 def _get_vnf_instance(self
, instance_uuid
, name
):
327 Returns the Docker object for the given VNF name (or Docker name).
328 :param instance_uuid: UUID of the service instance to search in.
329 :param name: VNF name or Docker name. We are fuzzy here.
333 if name
in self
.vnf_name2docker_name
:
334 dn
= self
.vnf_name2docker_name
[name
]
335 for vnfi
in self
.instances
[instance_uuid
]["vnf_instances"]:
338 LOG
.warning("No container with name: %r found.")
342 def _vnf_reconfigure_network(vnfi
, if_name
, net_str
):
344 Reconfigure the network configuration of a specific interface
345 of a running container.
346 :param vnfi: container instacne
347 :param if_name: interface name
348 :param net_str: network configuration string, e.g., 1.2.3.4/24
351 intf
= vnfi
.intf(intf
=if_name
)
354 LOG
.debug("Reconfigured network of %s:%s to %r" % (vnfi
.name
, if_name
, net_str
))
356 LOG
.warning("Interface not found: %s:%s. Network reconfiguration skipped." % (vnfi
.name
, if_name
))
359 def _trigger_emulator_start_scripts_in_vnfis(self
, vnfi_list
):
360 for vnfi
in vnfi_list
:
361 config
= vnfi
.dcinfo
.get("Config", dict())
362 env
= config
.get("Env", list())
364 if "SON_EMU_CMD=" in env_var
:
365 cmd
= str(env_var
.split("=")[1])
366 LOG
.info("Executing entry point script in %r: %r" % (vnfi
.name
, cmd
))
367 # execute command in new thread to ensure that GK is not blocked by VNF
368 t
= threading
.Thread(target
=vnfi
.cmdPrint
, args
=(cmd
,))
372 def _unpack_service_package(self
):
374 unzip *.son file and store contents in CATALOG_FOLDER/services/<service_uuid>/
376 LOG
.info("Unzipping: %r" % self
.package_file_path
)
377 with zipfile
.ZipFile(self
.package_file_path
, "r") as z
:
378 z
.extractall(self
.package_content_path
)
381 def _load_package_descriptor(self
):
383 Load the main package descriptor YAML and keep it as dict.
386 self
.manifest
= load_yaml(
388 self
.package_content_path
, "META-INF/MANIFEST.MF"))
392 Load the entry NSD YAML and keep it as dict.
395 if "entry_service_template" in self
.manifest
:
396 nsd_path
= os
.path
.join(
397 self
.package_content_path
,
398 make_relative_path(self
.manifest
.get("entry_service_template")))
399 self
.nsd
= load_yaml(nsd_path
)
400 LOG
.debug("Loaded NSD: %r" % self
.nsd
.get("name"))
402 def _load_vnfd(self
):
404 Load all VNFD YAML files referenced in MANIFEST.MF and keep them in dict.
407 if "package_content" in self
.manifest
:
408 for pc
in self
.manifest
.get("package_content"):
409 if pc
.get("content-type") == "application/sonata.function_descriptor":
410 vnfd_path
= os
.path
.join(
411 self
.package_content_path
,
412 make_relative_path(pc
.get("name")))
413 vnfd
= load_yaml(vnfd_path
)
414 self
.vnfds
[vnfd
.get("name")] = vnfd
415 LOG
.debug("Loaded VNFD: %r" % vnfd
.get("name"))
417 def _load_saps(self
):
418 # Each Service Access Point (connection_point) in the nsd is getting its own container
419 SAPs
= [p
["id"] for p
in self
.nsd
["connection_points"] if p
["type"] == "interface"]
421 # endpoints needed in this service
422 sap_vnf_id
, sap_vnf_interface
= sap
.split(':')
423 # set of the connection_point ids found in the nsd (in the examples this is 'ns')
424 self
.sap_identifiers
.add(sap_vnf_id
)
426 sap_docker_name
= "%s_%s" % (sap_vnf_id
, sap_vnf_interface
)
428 # add SAP to self.vnfds
429 sapfile
= pkg_resources
.resource_filename(__name__
, "sap_vnfd.yml")
430 sap_vnfd
= load_yaml(sapfile
)
431 sap_vnfd
["connection_points"][0]["id"] = sap_vnf_interface
432 sap_vnfd
["name"] = sap_docker_name
433 self
.vnfds
[sap_docker_name
] = sap_vnfd
434 # add SAP vnf to list in the NSD so it is deployed later on
435 # each SAP get a unique VNFD and vnf_id in the NSD
436 self
.nsd
["network_functions"].append({"vnf_id": sap_docker_name
, "vnf_name": sap_docker_name
})
437 LOG
.debug("Loaded SAP: %r" % sap_vnfd
.get("name"))
439 def _load_docker_files(self
):
441 Get all paths to Dockerfiles from VNFDs and store them in dict.
444 for k
, v
in self
.vnfds
.iteritems():
445 for vu
in v
.get("virtual_deployment_units"):
446 if vu
.get("vm_image_format") == "docker":
447 vm_image
= vu
.get("vm_image")
448 docker_path
= os
.path
.join(
449 self
.package_content_path
,
450 make_relative_path(vm_image
))
451 self
.local_docker_files
[k
] = docker_path
452 LOG
.debug("Found Dockerfile (%r): %r" % (k
, docker_path
))
454 def _load_docker_urls(self
):
456 Get all URLs to pre-build docker images in some repo.
459 for k
, v
in self
.vnfds
.iteritems():
460 for vu
in v
.get("virtual_deployment_units"):
461 if vu
.get("vm_image_format") == "docker":
462 url
= vu
.get("vm_image")
464 url
= url
.replace("http://", "")
465 self
.remote_docker_image_urls
[k
] = url
466 LOG
.debug("Found Docker image URL (%r): %r" % (k
, self
.remote_docker_image_urls
[k
]))
468 def _build_images_from_dockerfiles(self
):
470 Build Docker images for each local Dockerfile found in the package: self.local_docker_files
472 if GK_STANDALONE_MODE
:
473 return # do not build anything in standalone mode
475 LOG
.info("Building %d Docker images (this may take several minutes) ..." % len(self
.local_docker_files
))
476 for k
, v
in self
.local_docker_files
.iteritems():
477 for line
in dc
.build(path
=v
.replace("Dockerfile", ""), tag
=k
, rm
=False, nocache
=False):
478 LOG
.debug("DOCKER BUILD: %s" % line
)
479 LOG
.info("Docker image created: %s" % k
)
481 def _pull_predefined_dockerimages(self
):
483 If the package contains URLs to pre-build Docker images, we download them with this method.
486 for url
in self
.remote_docker_image_urls
.itervalues():
487 if not FORCE_PULL
: # only pull if not present (speedup for development)
488 if len(dc
.images(name
=url
)) > 0:
489 LOG
.debug("Image %r present. Skipping pull." % url
)
491 LOG
.info("Pulling image: %r" % url
)
493 insecure_registry
=True)
495 def _check_docker_image_exists(self
, image_name
):
497 Query the docker service and check if the given image exists
498 :param image_name: name of the docker image
501 return len(DockerClient().images(image_name
)) > 0
503 def _calculate_placement(self
, algorithm
):
505 Do placement by adding the a field "dc" to
506 each VNFD that points to one of our
507 data center objects known to the gatekeeper.
509 assert(len(self
.vnfds
) > 0)
510 assert(len(GK
.dcs
) > 0)
511 # instantiate algorithm an place
513 p
.place(self
.nsd
, self
.vnfds
, GK
.dcs
)
514 LOG
.info("Using placement algorithm: %r" % p
.__class
__.__name
__)
515 # lets print the placement result
516 for name
, vnfd
in self
.vnfds
.iteritems():
517 LOG
.info("Placed VNF %r on DC %r" % (name
, str(vnfd
.get("dc"))))
521 Some (simple) placement algorithms
525 class FirstDcPlacement(object):
527 Placement: Always use one and the same data center from the GK.dcs dict.
529 def place(self
, nsd
, vnfds
, dcs
):
530 for name
, vnfd
in vnfds
.iteritems():
531 vnfd
["dc"] = list(dcs
.itervalues())[0]
534 class RoundRobinDcPlacement(object):
536 Placement: Distribute VNFs across all available DCs in a round robin fashion.
538 def place(self
, nsd
, vnfds
, dcs
):
540 dcs_list
= list(dcs
.itervalues())
541 for name
, vnfd
in vnfds
.iteritems():
542 vnfd
["dc"] = dcs_list
[c
% len(dcs_list
)]
543 c
+= 1 # inc. c to use next DC
549 Resource definitions and API endpoints
553 class Packages(fr
.Resource
):
557 Upload a *.son service package to the dummy gatekeeper.
559 We expect request with a *.son file and store it in UPLOAD_FOLDER
565 # lets search for the package in the request
566 if "package" in request
.files
:
567 son_file
= request
.files
["package"]
568 # elif "file" in request.files:
569 # son_file = request.files["file"]
571 return {"service_uuid": None, "size": 0, "sha1": None, "error": "upload failed. file not found."}, 500
572 # generate a uuid to reference this package
573 service_uuid
= str(uuid
.uuid4())
574 file_hash
= hashlib
.sha1(str(son_file
)).hexdigest()
575 # ensure that upload folder exists
576 ensure_dir(UPLOAD_FOLDER
)
577 upload_path
= os
.path
.join(UPLOAD_FOLDER
, "%s.son" % service_uuid
)
578 # store *.son file to disk
579 son_file
.save(upload_path
)
580 size
= os
.path
.getsize(upload_path
)
581 # create a service object and register it
582 s
= Service(service_uuid
, file_hash
, upload_path
)
583 GK
.register_service_package(service_uuid
, s
)
584 # generate the JSON result
585 return {"service_uuid": service_uuid
, "size": size
, "sha1": file_hash
, "error": None}, 201
586 except Exception as ex
:
587 LOG
.exception("Service package upload failed:")
588 return {"service_uuid": None, "size": 0, "sha1": None, "error": "upload failed"}, 500
592 Return a list of UUID's of uploaded service packages.
595 LOG
.info("GET /packages")
596 return {"service_uuid_list": list(GK
.services
.iterkeys())}
599 class Instantiations(fr
.Resource
):
603 Instantiate a service specified by its UUID.
604 Will return a new UUID to identify the running service instance.
607 # try to extract the service uuid from the request
608 json_data
= request
.get_json(force
=True)
609 service_uuid
= json_data
.get("service_uuid")
611 # lets be a bit fuzzy here to make testing easier
612 if service_uuid
is None and len(GK
.services
) > 0:
613 # if we don't get a service uuid, we simple start the first service in the list
614 service_uuid
= list(GK
.services
.iterkeys())[0]
616 if service_uuid
in GK
.services
:
617 # ok, we have a service uuid, lets start the service
618 service_instance_uuid
= GK
.services
.get(service_uuid
).start_service()
619 return {"service_instance_uuid": service_instance_uuid
}
620 return "Service not found", 404
624 Returns a list of UUIDs containing all running services.
627 LOG
.info("GET /instantiations")
628 return {"service_instantiations_list": [
629 list(s
.instances
.iterkeys()) for s
in GK
.services
.itervalues()]}
633 Stops a running service specified by its UUID.
637 # try to extract the service UUID from the request
638 json_data
= request
.get_json(force
=True)
639 service_uuid
= json_data
.get("service_uuid")
641 if service_uuid
in GK
.services
:
642 # valid service UUID, stop service
643 GK
.services
.get(service_uuid
).stop_service()
645 return "Service not found", 404
648 # create a single, global GK object
651 app
= Flask(__name__
)
652 app
.config
['MAX_CONTENT_LENGTH'] = 512 * 1024 * 1024 # 512 MB max upload
655 api
.add_resource(Packages
, '/packages')
656 api
.add_resource(Instantiations
, '/instantiations')
659 def start_rest_api(host
, port
, datacenters
=dict()):
661 # start the Flask server (not the best performance but ok for our use case)
665 use_reloader
=False # this is needed to run Flask in a non-main thread
669 def ensure_dir(name
):
670 if not os
.path
.exists(name
):
675 with
open(path
, "r") as f
:
678 except yaml
.YAMLError
as exc
:
679 LOG
.exception("YAML parse error")
684 def make_relative_path(path
):
685 if path
.startswith("file://"):
686 path
= path
.replace("file://", "", 1)
687 if path
.startswith("/"):
688 path
= path
.replace("/", "", 1)
692 def generate_lan_string(prefix
, base
, subnet_size
=24, ip
=0):
694 Helper to generate different network configuration strings.
696 r
= "%s.%d.%d/%d" % (prefix
, base
, ip
, subnet_size
)
700 def generate_subnet_strings(n
, start
=1, subnet_size
=24, ip
=0):
702 Helper to generate different network configuration strings.
705 for i
in range(start
, start
+ n
):
706 r
.append("%d.0.0.%d/%d" % (i
, ip
, subnet_size
))
710 if __name__
== '__main__':
712 Lets allow to run the API in standalone mode.
714 GK_STANDALONE_MODE
= True
715 logging
.getLogger("werkzeug").setLevel(logging
.INFO
)
716 start_rest_api("0.0.0.0", 8000)