mirror of
https://github.com/GNS3/gns3-server.git
synced 2026-08-30 05:50:12 +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.
60 lines
3.0 KiB
Python
60 lines
3.0 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 . import Category, TemplateBase
|
|
from ...common import ConsoleType, AuxType, CustomAdapter, ExtraConfig
|
|
|
|
from pydantic import Field
|
|
from typing import Optional, List
|
|
|
|
|
|
class DockerTemplate(TemplateBase):
|
|
|
|
category: Optional[Category] = Category.guest
|
|
default_name_format: Optional[str] = "{name}-{0}"
|
|
symbol: Optional[str] = "docker_guest"
|
|
image: str = Field(..., description="Docker image name")
|
|
adapters: Optional[int] = Field(1, ge=0, le=100, description="Number of adapters")
|
|
mac_address: Optional[str] = Field("", description="Base MAC address", pattern="^([0-9a-fA-F]{2}[:]){5}([0-9a-fA-F]{2})$|^$")
|
|
start_command: Optional[str] = Field("", description="Docker CMD entry")
|
|
environment: Optional[str] = Field("", description="Docker environment variables")
|
|
console_type: Optional[ConsoleType] = Field(ConsoleType.telnet, description="Console type")
|
|
aux_type: Optional[AuxType] = Field(AuxType.none, description="Auxiliary console type")
|
|
console_auto_start: Optional[bool] = Field(
|
|
False, description="Automatically start the console when the node has started"
|
|
)
|
|
console_http_port: Optional[int] = Field(
|
|
80, gt=0, le=65535, description="Internal port in the container for the HTTP server"
|
|
)
|
|
console_http_path: Optional[str] = Field(
|
|
"/",
|
|
description="Path of the web interface",
|
|
)
|
|
console_resolution: Optional[str] = Field(
|
|
"1024x768", pattern="^[0-9]+x[0-9]+$", description="Console resolution for VNC"
|
|
)
|
|
extra_hosts: Optional[str] = Field("", description="Docker extra hosts (added to /etc/hosts)")
|
|
extra_volumes: Optional[List] = Field([], description="Additional directories to make persistent")
|
|
extra_configs: Optional[List[ExtraConfig]] = Field(default_factory=list, description="Configuration files injected into the container (bind-mounted read-only)")
|
|
memory: Optional[int] = Field(0, ge=0, description="Maximum amount of memory the container can use in MB")
|
|
cpus: Optional[float] = Field(0, ge=0, description="Maximum amount of CPU resources the container can use")
|
|
custom_adapters: Optional[List[CustomAdapter]] = Field(default_factory=list, description="Custom adapters")
|
|
|
|
|
|
class DockerTemplateUpdate(DockerTemplate):
|
|
|
|
image: Optional[str] = Field(None, description="Docker image name") |