mirror of
https://github.com/GNS3/gns3-server.git
synced 2026-09-04 00:55:16 +03:00
08e37a4509
Add an `extra_configs` field (list of {target, content}) to the docker
node/template/appliance schemas. For each entry GNS3 writes `content` to a
file in the node working directory and bind-mounts it read-only at `target`
inside the container.
This lets a NOS appliance seed its startup config without rebuilding the
image: XRd points XR_FIRST_BOOT_CONFIG at an injected /firstboot.cfg, FRR at
/etc/frr/frr.conf, etc. The bind is a single-file mount applied at create
time, so it works for both the generic init.sh path and vendor nodes that
skip init.sh (console_type=docker_exec). Entries are only injected when
present, so ordinary nodes are unaffected.
The content can't go through `environment` (it is line-delimited, one var per
line), hence a dedicated field -- the same plumbing shape as extra_volumes.
88 lines
2.2 KiB
Python
88 lines
2.2 KiB
Python
#
|
|
# Copyright (C) 2020 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/>.
|
|
|
|
from pydantic import BaseModel, Field
|
|
from typing import Optional
|
|
from enum import Enum
|
|
|
|
|
|
class ErrorMessage(BaseModel):
|
|
"""
|
|
Error message.
|
|
"""
|
|
|
|
message: str
|
|
|
|
|
|
class NodeStatus(str, Enum):
|
|
"""
|
|
Supported node statuses.
|
|
"""
|
|
|
|
stopped = "stopped"
|
|
started = "started"
|
|
suspended = "suspended"
|
|
|
|
|
|
class CustomAdapter(BaseModel):
|
|
"""
|
|
Custom adapter data.
|
|
"""
|
|
|
|
adapter_number: int
|
|
port_name: Optional[str] = None
|
|
adapter_type: Optional[str] = None
|
|
mac_address: Optional[str] = Field(None, pattern="^([0-9a-fA-F]{2}[:]){5}([0-9a-fA-F]{2})$")
|
|
|
|
|
|
class ExtraConfig(BaseModel):
|
|
"""
|
|
A configuration file injected into a Docker container.
|
|
|
|
GNS3 writes ``content`` to a host file and bind-mounts it read-only at
|
|
``target`` inside the container. Used to seed NOS startup configs (e.g.
|
|
XRd first-boot config, FRR frr.conf) without rebuilding the image.
|
|
"""
|
|
|
|
target: str = Field(..., description="Absolute path inside the container where the file is mounted")
|
|
content: str = Field("", description="File content written by GNS3 and bind-mounted read-only into the container")
|
|
|
|
|
|
class ConsoleType(str, Enum):
|
|
"""
|
|
Supported console types.
|
|
"""
|
|
|
|
vnc = "vnc"
|
|
telnet = "telnet"
|
|
ssh = "ssh"
|
|
http = "http"
|
|
https = "https"
|
|
spice = "spice"
|
|
spice_agent = "spice+agent"
|
|
none = "none"
|
|
docker_exec = "docker_exec"
|
|
|
|
|
|
class AuxType(str, Enum):
|
|
"""
|
|
Supported auxiliary console types.
|
|
"""
|
|
|
|
telnet = "telnet"
|
|
ssh = "ssh"
|
|
none = "none"
|