mirror of
https://github.com/GNS3/gns3-server
synced 2024-11-24 17:28:08 +00:00
689 lines
22 KiB
Python
689 lines
22 KiB
Python
# -*- coding: utf-8 -*-
|
||
#
|
||
# Copyright (C) 2015 GNS3 Technologies Inc.
|
||
#
|
||
# This program is free software: you can redistribute it and/or modify
|
||
# it under the terms of the GNU General Public License as published by
|
||
# the Free Software Foundation, either version 3 of the License, or
|
||
# (at your option) any later version.
|
||
#
|
||
# This program is distributed in the hope that it will be useful,
|
||
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
# GNU General Public License for more details.
|
||
#
|
||
# You should have received a copy of the GNU General Public License
|
||
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||
|
||
import os
|
||
import aiohttp
|
||
import shutil
|
||
import asyncio
|
||
import hashlib
|
||
import zipstream
|
||
import zipfile
|
||
import json
|
||
|
||
from uuid import UUID, uuid4
|
||
from .port_manager import PortManager
|
||
from ..config import Config
|
||
from ..utils.asyncio import wait_run_in_executor
|
||
|
||
|
||
import logging
|
||
log = logging.getLogger(__name__)
|
||
|
||
|
||
class Project:
|
||
|
||
"""
|
||
A project contains a list of VM.
|
||
In theory VM are isolated project/project.
|
||
|
||
:param project_id: force project identifier (None by default auto generate an UUID)
|
||
:param path: path of the project. (None use the standard directory)
|
||
:param location: parent path of the project. (None should create a tmp directory)
|
||
:param temporary: boolean to tell if the project is a temporary project (destroy when closed)
|
||
"""
|
||
|
||
def __init__(self, name=None, project_id=None, path=None, location=None, temporary=False):
|
||
|
||
self._name = name
|
||
if project_id is None:
|
||
self._id = str(uuid4())
|
||
else:
|
||
try:
|
||
UUID(project_id, version=4)
|
||
except ValueError:
|
||
raise aiohttp.web.HTTPBadRequest(text="{} is not a valid UUID".format(project_id))
|
||
self._id = project_id
|
||
|
||
self._location = None
|
||
if location is None:
|
||
self._location = self._config().get("project_directory", self._get_default_project_directory())
|
||
else:
|
||
self.location = location
|
||
|
||
self._vms = set()
|
||
self._vms_to_destroy = set()
|
||
self.temporary = temporary
|
||
self._used_tcp_ports = set()
|
||
self._used_udp_ports = set()
|
||
|
||
# clients listening for notifications
|
||
self._listeners = set()
|
||
|
||
if path is None:
|
||
path = os.path.join(self._location, self._id)
|
||
try:
|
||
os.makedirs(path, exist_ok=True)
|
||
except OSError as e:
|
||
raise aiohttp.web.HTTPInternalServerError(text="Could not create project directory: {}".format(e))
|
||
self.path = path
|
||
|
||
log.info("Project {id} with path '{path}' created".format(path=self._path, id=self._id))
|
||
|
||
def __json__(self):
|
||
|
||
return {
|
||
"name": self._name,
|
||
"project_id": self._id,
|
||
"location": self._location,
|
||
"temporary": self._temporary,
|
||
"path": self._path,
|
||
}
|
||
|
||
def _config(self):
|
||
|
||
return Config.instance().get_section_config("Server")
|
||
|
||
def is_local(self):
|
||
|
||
return self._config().getboolean("local", False)
|
||
|
||
@classmethod
|
||
def _get_default_project_directory(cls):
|
||
"""
|
||
Return the default location for the project directory
|
||
depending of the operating system
|
||
"""
|
||
|
||
server_config = Config.instance().get_section_config("Server")
|
||
path = os.path.expanduser(server_config.get("projects_path", "~/GNS3/projects"))
|
||
path = os.path.normpath(path)
|
||
try:
|
||
os.makedirs(path, exist_ok=True)
|
||
except OSError as e:
|
||
raise aiohttp.web.HTTPInternalServerError(text="Could not create project directory: {}".format(e))
|
||
return path
|
||
|
||
@property
|
||
def id(self):
|
||
|
||
return self._id
|
||
|
||
@property
|
||
def location(self):
|
||
|
||
return self._location
|
||
|
||
@location.setter
|
||
def location(self, location):
|
||
|
||
if location != self._location and self.is_local() is False:
|
||
raise aiohttp.web.HTTPForbidden(text="You are not allowed to modify the project directory location")
|
||
|
||
self._location = location
|
||
|
||
@property
|
||
def path(self):
|
||
|
||
return self._path
|
||
|
||
@path.setter
|
||
def path(self, path):
|
||
|
||
if hasattr(self, "_path"):
|
||
if path != self._path and self.is_local() is False:
|
||
raise aiohttp.web.HTTPForbidden(text="You are not allowed to modify the project directory path")
|
||
|
||
if '"' in path:
|
||
raise aiohttp.web.HTTPForbidden(text="You are not allowed to use \" in the project directory path. It's not supported by Dynamips.")
|
||
|
||
self._path = path
|
||
self._update_temporary_file()
|
||
|
||
@asyncio.coroutine
|
||
def clean_old_path(self, old_path):
|
||
"""
|
||
Called after a project location change. All the modules should
|
||
have been notified before
|
||
"""
|
||
if self._temporary:
|
||
try:
|
||
yield from wait_run_in_executor(shutil.rmtree, old_path)
|
||
except OSError as e:
|
||
log.warn("Can't remove temporary directory {}: {}".format(old_path, e))
|
||
|
||
@property
|
||
def name(self):
|
||
|
||
return self._name
|
||
|
||
@name.setter
|
||
def name(self, name):
|
||
|
||
if "/" in name or "\\" in name:
|
||
raise aiohttp.web.HTTPForbidden(text="Name can not contain path separator")
|
||
self._name = name
|
||
|
||
@property
|
||
def vms(self):
|
||
|
||
return self._vms
|
||
|
||
@property
|
||
def temporary(self):
|
||
|
||
return self._temporary
|
||
|
||
@temporary.setter
|
||
def temporary(self, temporary):
|
||
|
||
if hasattr(self, 'temporary') and temporary == self._temporary:
|
||
return
|
||
|
||
self._temporary = temporary
|
||
self._update_temporary_file()
|
||
|
||
def record_tcp_port(self, port):
|
||
"""
|
||
Associate a reserved TCP port number with this project.
|
||
|
||
:param port: TCP port number
|
||
"""
|
||
|
||
if port not in self._used_tcp_ports:
|
||
self._used_tcp_ports.add(port)
|
||
|
||
def record_udp_port(self, port):
|
||
"""
|
||
Associate a reserved UDP port number with this project.
|
||
|
||
:param port: UDP port number
|
||
"""
|
||
|
||
if port not in self._used_udp_ports:
|
||
self._used_udp_ports.add(port)
|
||
|
||
def remove_tcp_port(self, port):
|
||
"""
|
||
Removes an associated TCP port number from this project.
|
||
|
||
:param port: TCP port number
|
||
"""
|
||
|
||
if port in self._used_tcp_ports:
|
||
self._used_tcp_ports.remove(port)
|
||
|
||
def remove_udp_port(self, port):
|
||
"""
|
||
Removes an associated UDP port number from this project.
|
||
|
||
:param port: UDP port number
|
||
"""
|
||
|
||
if port in self._used_udp_ports:
|
||
self._used_udp_ports.remove(port)
|
||
|
||
def _update_temporary_file(self):
|
||
"""
|
||
Update the .gns3_temporary file in order to reflect current
|
||
project status.
|
||
"""
|
||
|
||
if not hasattr(self, "_path"):
|
||
return
|
||
|
||
if self._temporary:
|
||
try:
|
||
with open(os.path.join(self._path, ".gns3_temporary"), 'w+') as f:
|
||
f.write("1")
|
||
except OSError as e:
|
||
raise aiohttp.web.HTTPInternalServerError(text="Could not create temporary project: {}".format(e))
|
||
else:
|
||
if os.path.exists(os.path.join(self._path, ".gns3_temporary")):
|
||
try:
|
||
os.remove(os.path.join(self._path, ".gns3_temporary"))
|
||
except OSError as e:
|
||
raise aiohttp.web.HTTPInternalServerError(text="Could not mark project as no longer temporary: {}".format(e))
|
||
|
||
def module_working_directory(self, module_name):
|
||
"""
|
||
Returns a working directory for the module
|
||
If the directory doesn't exist, the directory is created.
|
||
|
||
:param module_name: name for the module
|
||
:returns: working directory
|
||
"""
|
||
|
||
workdir = self.module_working_path(module_name)
|
||
try:
|
||
os.makedirs(workdir, exist_ok=True)
|
||
except OSError as e:
|
||
raise aiohttp.web.HTTPInternalServerError(text="Could not create module working directory: {}".format(e))
|
||
return workdir
|
||
|
||
def module_working_path(self, module_name):
|
||
"""
|
||
Returns the working directory for the module. If you want
|
||
to be sure to have the directory on disk take a look on:
|
||
module_working_directory
|
||
"""
|
||
|
||
return os.path.join(self._path, "project-files", module_name)
|
||
|
||
def vm_working_directory(self, vm):
|
||
"""
|
||
Returns a working directory for a specific VM.
|
||
If the directory doesn't exist, the directory is created.
|
||
|
||
:param vm: VM instance
|
||
|
||
:returns: VM working directory
|
||
"""
|
||
|
||
workdir = os.path.join(self._path, "project-files", vm.manager.module_name.lower(), vm.id)
|
||
try:
|
||
os.makedirs(workdir, exist_ok=True)
|
||
except OSError as e:
|
||
raise aiohttp.web.HTTPInternalServerError(text="Could not create the VM working directory: {}".format(e))
|
||
return workdir
|
||
|
||
def capture_working_directory(self):
|
||
"""
|
||
Returns a working directory where to store packet capture files.
|
||
|
||
:returns: path to the directory
|
||
"""
|
||
|
||
workdir = os.path.join(self._path, "project-files", "captures")
|
||
try:
|
||
os.makedirs(workdir, exist_ok=True)
|
||
except OSError as e:
|
||
raise aiohttp.web.HTTPInternalServerError(text="Could not create the capture working directory: {}".format(e))
|
||
return workdir
|
||
|
||
def mark_vm_for_destruction(self, vm):
|
||
"""
|
||
:param vm: An instance of VM
|
||
"""
|
||
|
||
self.remove_vm(vm)
|
||
self._vms_to_destroy.add(vm)
|
||
|
||
def add_vm(self, vm):
|
||
"""
|
||
Adds a VM to the project.
|
||
In theory this should be called by the VM manager.
|
||
|
||
:param vm: VM instance
|
||
"""
|
||
|
||
self._vms.add(vm)
|
||
|
||
def remove_vm(self, vm):
|
||
"""
|
||
Removes a VM from the project.
|
||
In theory this should be called by the VM manager.
|
||
|
||
:param vm: VM instance
|
||
"""
|
||
|
||
if vm in self._vms:
|
||
self._vms.remove(vm)
|
||
|
||
@asyncio.coroutine
|
||
def close(self):
|
||
"""
|
||
Closes the project, but keep information on disk
|
||
"""
|
||
|
||
for module in self.modules():
|
||
yield from module.instance().project_closing(self)
|
||
yield from self._close_and_clean(self._temporary)
|
||
for module in self.modules():
|
||
yield from module.instance().project_closed(self)
|
||
|
||
@asyncio.coroutine
|
||
def _close_and_clean(self, cleanup):
|
||
"""
|
||
Closes the project, and cleanup the disk if cleanup is True
|
||
|
||
:param cleanup: If True drop the project directory
|
||
"""
|
||
|
||
tasks = []
|
||
for vm in self._vms:
|
||
tasks.append(asyncio.async(vm.manager.close_vm(vm.id)))
|
||
|
||
if tasks:
|
||
done, _ = yield from asyncio.wait(tasks)
|
||
for future in done:
|
||
try:
|
||
future.result()
|
||
except (Exception, GeneratorExit) as e:
|
||
log.error("Could not close VM or device {}".format(e), exc_info=1)
|
||
|
||
if cleanup and os.path.exists(self.path):
|
||
try:
|
||
yield from wait_run_in_executor(shutil.rmtree, self.path)
|
||
log.info("Project {id} with path '{path}' deleted".format(path=self._path, id=self._id))
|
||
except OSError as e:
|
||
raise aiohttp.web.HTTPInternalServerError(text="Could not delete the project directory: {}".format(e))
|
||
else:
|
||
log.info("Project {id} with path '{path}' closed".format(path=self._path, id=self._id))
|
||
|
||
if self._used_tcp_ports:
|
||
log.warning("Project {} has TCP ports still in use: {}".format(self.id, self._used_tcp_ports))
|
||
if self._used_udp_ports:
|
||
log.warning("Project {} has UDP ports still in use: {}".format(self.id, self._used_udp_ports))
|
||
|
||
# clean the remaining ports that have not been cleaned by their respective VM or device.
|
||
port_manager = PortManager.instance()
|
||
for port in self._used_tcp_ports.copy():
|
||
port_manager.release_tcp_port(port, self)
|
||
for port in self._used_udp_ports.copy():
|
||
port_manager.release_udp_port(port, self)
|
||
|
||
@asyncio.coroutine
|
||
def commit(self):
|
||
"""
|
||
Writes project changes on disk
|
||
"""
|
||
|
||
while self._vms_to_destroy:
|
||
vm = self._vms_to_destroy.pop()
|
||
yield from vm.delete()
|
||
self.remove_vm(vm)
|
||
for module in self.modules():
|
||
yield from module.instance().project_committed(self)
|
||
|
||
@asyncio.coroutine
|
||
def delete(self):
|
||
"""
|
||
Removes project from disk
|
||
"""
|
||
|
||
for module in self.modules():
|
||
yield from module.instance().project_closing(self)
|
||
yield from self._close_and_clean(True)
|
||
for module in self.modules():
|
||
yield from module.instance().project_closed(self)
|
||
|
||
@classmethod
|
||
def clean_project_directory(cls):
|
||
"""
|
||
At startup drop old temporary project. After a crash for example
|
||
"""
|
||
|
||
config = Config.instance().get_section_config("Server")
|
||
directory = config.get("project_directory", cls._get_default_project_directory())
|
||
if os.path.exists(directory):
|
||
for project in os.listdir(directory):
|
||
path = os.path.join(directory, project)
|
||
if os.path.exists(os.path.join(path, ".gns3_temporary")):
|
||
log.warning("Purge old temporary project {}".format(project))
|
||
shutil.rmtree(path)
|
||
|
||
def modules(self):
|
||
"""
|
||
Returns all loaded VM modules.
|
||
"""
|
||
|
||
# We import it at the last time to avoid circular dependencies
|
||
from ..modules import MODULES
|
||
return MODULES
|
||
|
||
def emit(self, action, event):
|
||
"""
|
||
Send an event to all the client listening for notifications
|
||
|
||
:param action: Action name
|
||
:param event: Event to send
|
||
"""
|
||
for listener in self._listeners:
|
||
listener.put_nowait((action, event, ))
|
||
|
||
def get_listen_queue(self):
|
||
"""Get a queue where you receive all the events related to the
|
||
project."""
|
||
|
||
queue = asyncio.Queue()
|
||
self._listeners.add(queue)
|
||
return queue
|
||
|
||
def stop_listen_queue(self, queue):
|
||
"""Stop sending notification to this clients"""
|
||
|
||
self._listeners.remove(queue)
|
||
|
||
@property
|
||
def listeners(self):
|
||
"""
|
||
List of current clients listening for event in this projects
|
||
"""
|
||
return self._listeners
|
||
|
||
@asyncio.coroutine
|
||
def list_files(self):
|
||
"""
|
||
:returns: Array of files in project without temporary files. The files are dictionnary {"path": "test.bin", "md5sum": "aaaaa"}
|
||
"""
|
||
|
||
files = []
|
||
for (dirpath, dirnames, filenames) in os.walk(self.path):
|
||
for filename in filenames:
|
||
if not filename.endswith(".ghost"):
|
||
path = os.path.relpath(dirpath, self.path)
|
||
path = os.path.join(path, filename)
|
||
path = os.path.normpath(path)
|
||
file_info = {"path": path}
|
||
|
||
try:
|
||
file_info["md5sum"] = yield from wait_run_in_executor(self._hash_file, os.path.join(dirpath, filename))
|
||
except OSError:
|
||
continue
|
||
files.append(file_info)
|
||
|
||
return files
|
||
|
||
def _hash_file(self, path):
|
||
"""
|
||
Compute and md5 hash for file
|
||
|
||
:returns: hexadecimal md5
|
||
"""
|
||
|
||
m = hashlib.md5()
|
||
with open(path, "rb") as f:
|
||
while True:
|
||
buf = f.read(128)
|
||
if not buf:
|
||
break
|
||
m.update(buf)
|
||
return m.hexdigest()
|
||
|
||
def export(self, include_images=False):
|
||
"""
|
||
Export the project as zip. It's a ZipStream object.
|
||
The file will be read chunk by chunk when you iterate on
|
||
the zip.
|
||
|
||
It will ignore some files like snapshots and
|
||
|
||
:returns: ZipStream object
|
||
"""
|
||
|
||
z = zipstream.ZipFile()
|
||
# topdown allo to modify the list of directory in order to ignore
|
||
# directory
|
||
for root, dirs, files in os.walk(self._path, topdown=True):
|
||
# Remove snapshots and capture
|
||
if os.path.split(root)[-1:][0] == "project-files":
|
||
dirs[:] = [d for d in dirs if d not in ("snapshots", "captures")]
|
||
|
||
# Ignore log files and OS noise
|
||
files = [f for f in files if not f.endswith('_log.txt') and not f.endswith('.log') and f != '.DS_Store']
|
||
|
||
for file in files:
|
||
path = os.path.join(root, file)
|
||
# We rename the .gns3 project.gns3 to avoid the task to the client to guess the file name
|
||
if file.endswith(".gns3"):
|
||
self._export_project_file(path, z, include_images)
|
||
else:
|
||
# We merge the data from all server in the same project-files directory
|
||
vm_directory = os.path.join(self._path, "servers", "vm")
|
||
if os.path.commonprefix([root, vm_directory]) == vm_directory:
|
||
z.write(path, os.path.relpath(path, vm_directory))
|
||
else:
|
||
z.write(path, os.path.relpath(path, self._path))
|
||
return z
|
||
|
||
def _export_images(self, image, type, z):
|
||
"""
|
||
Take a project file (.gns3) and export images to the zip
|
||
|
||
:param image: Image path
|
||
:param type: Type of image
|
||
:param z: Zipfile instance for the export
|
||
"""
|
||
from . import MODULES
|
||
|
||
for module in MODULES:
|
||
try:
|
||
img_directory = module.instance().get_images_directory()
|
||
except NotImplementedError:
|
||
# Some modules don't have images
|
||
continue
|
||
|
||
directory = os.path.split(img_directory)[-1:][0]
|
||
|
||
if os.path.exists(image):
|
||
path = image
|
||
else:
|
||
path = os.path.join(img_directory, image)
|
||
|
||
if os.path.exists(path):
|
||
arcname = os.path.join("images", directory, os.path.basename(image))
|
||
z.write(path, arcname)
|
||
break
|
||
|
||
def _export_project_file(self, path, z, include_images):
|
||
"""
|
||
Take a project file (.gns3) and patch it for the export
|
||
|
||
:param path: Path of the .gns3
|
||
"""
|
||
|
||
with open(path) as f:
|
||
topology = json.load(f)
|
||
if "topology" in topology and "nodes" in topology["topology"]:
|
||
for node in topology["topology"]["nodes"]:
|
||
if "properties" in node and node["type"] != "DockerVM":
|
||
for prop, value in node["properties"].items():
|
||
if prop.endswith("image"):
|
||
node["properties"][prop] = os.path.basename(value)
|
||
if include_images:
|
||
self._export_images(value, node["type"], z)
|
||
z.writestr("project.gns3", json.dumps(topology).encode())
|
||
|
||
def import_zip(self, stream, gns3vm=True):
|
||
"""
|
||
Import a project contain in a zip file
|
||
|
||
:param stream: A io.BytesIO of the zipfile
|
||
:param gns3vm: True move docker, iou and qemu to the GNS3 VM
|
||
"""
|
||
|
||
with zipfile.ZipFile(stream) as myzip:
|
||
myzip.extractall(self.path)
|
||
|
||
project_file = os.path.join(self.path, "project.gns3")
|
||
if os.path.exists(project_file):
|
||
with open(project_file) as f:
|
||
topology = json.load(f)
|
||
topology["project_id"] = self.id
|
||
topology["name"] = self.name
|
||
topology.setdefault("topology", {})
|
||
topology["topology"].setdefault("nodes", [])
|
||
topology["topology"]["servers"] = [
|
||
{
|
||
"id": 1,
|
||
"local": True,
|
||
"vm": False
|
||
}
|
||
]
|
||
|
||
# By default all node run on local server
|
||
for node in topology["topology"]["nodes"]:
|
||
node["server_id"] = 1
|
||
|
||
if gns3vm:
|
||
# Move to servers/vm directory the data that should be import on remote server
|
||
modules_to_vm = {
|
||
"qemu": "QemuVM",
|
||
"iou": "IOUDevice",
|
||
"docker": "DockerVM"
|
||
}
|
||
|
||
vm_directory = os.path.join(self.path, "servers", "vm", "project-files")
|
||
vm_server_use = False
|
||
|
||
for module, device_type in modules_to_vm.items():
|
||
module_directory = os.path.join(self.path, "project-files", module)
|
||
if os.path.exists(module_directory):
|
||
os.makedirs(vm_directory, exist_ok=True)
|
||
shutil.move(module_directory, os.path.join(vm_directory, module))
|
||
|
||
# Patch node to use the GNS3 VM
|
||
for node in topology["topology"]["nodes"]:
|
||
if node["type"] == device_type:
|
||
node["server_id"] = 2
|
||
vm_server_use = True
|
||
|
||
# We use the GNS3 VM. We need to add the server to the list
|
||
if vm_server_use:
|
||
topology["topology"]["servers"].append({
|
||
"id": 2,
|
||
"vm": True,
|
||
"local": False
|
||
})
|
||
|
||
# Write the modified topology
|
||
with open(project_file, "w") as f:
|
||
json.dump(topology, f, indent=4)
|
||
|
||
# Rename to a human distinctive name
|
||
shutil.move(project_file, os.path.join(self.path, self.name + ".gns3"))
|
||
if os.path.exists(os.path.join(self.path, "images")):
|
||
self._import_images()
|
||
|
||
def _import_images(self):
|
||
"""
|
||
Copy images to the images directory or delete them if they
|
||
already exists.
|
||
"""
|
||
image_dir = self._config().get("images_path")
|
||
|
||
root = os.path.join(self.path, "images")
|
||
for (dirpath, dirnames, filenames) in os.walk(root):
|
||
for filename in filenames:
|
||
path = os.path.join(dirpath, filename)
|
||
dst = os.path.join(image_dir, os.path.relpath(path, root))
|
||
os.makedirs(os.path.dirname(dst), exist_ok=True)
|
||
shutil.move(path, dst)
|
||
|
||
# Cleanup the project
|
||
shutil.rmtree(root)
|