models

package
v0.1.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Apr 17, 2025 License: Apache-2.0 Imports: 1 Imported by: 0

Documentation

Overview

internal/models/models.go

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type CACreateRequest 

type CACreateRequest struct {
	Name         string `json:"name,omitempty" example:"my-root-ca"`           // Defaults to "ca" if empty
	Expiry       string `json:"expiry,omitempty" example:"8760h"`              // Duration string, defaults to "87600h" (10 years)
	CommonName   string `json:"commonName,omitempty" example:"ca.example.com"` // Defaults to "containerlab.dev"
	Country      string `json:"country,omitempty" example:"US"`                // Defaults to "Internet"
	Locality     string `json:"locality,omitempty" example:"City"`             // Defaults to "Server"
	Organization string `json:"organization,omitempty" example:"MyOrg"`        // Defaults to "Containerlab"
	OrgUnit      string `json:"orgUnit,omitempty" example:"IT"`                // Defaults to "Containerlab Tools"

}

CACreateRequest mirrors flags for `clab tools cert ca create`

type CertResponse 

type CertResponse struct {
	Message  string `json:"message"`
	CertPath string `json:"certPath,omitempty"` // e.g., "my-root-ca/my-root-ca.pem" or "my-root-ca/node1.example.com.pem"
	KeyPath  string `json:"keyPath,omitempty"`  // e.g., "my-root-ca/my-root-ca.key" or "my-root-ca/node1.example.com.key"
	CSRPath  string `json:"csrPath,omitempty"`  // e.g., "my-root-ca/my-root-ca.csr" or "my-root-ca/node1.example.com.csr"
}

CertResponse provides paths to the generated certificate files (relative to user's cert dir)

type CertSignRequest 

type CertSignRequest struct {
	Name         string   `json:"name" binding:"required" example:"node1.example.com"` // Required
	Hosts        []string `json:"hosts" binding:"required"`                            // SANs (DNS names or IPs), comma-separated in clab, array here
	CaName       string   `json:"caName" binding:"required" example:"my-root-ca"`      // Name of the CA cert/key files (without .pem/.key) previously generated
	CommonName   string   `json:"commonName,omitempty" example:"node1.example.com"`    // Defaults to Name if empty
	Country      string   `json:"country,omitempty" example:"US"`                      // Defaults to "Internet"
	Locality     string   `json:"locality,omitempty" example:"City"`                   // Defaults to "Server"
	Organization string   `json:"organization,omitempty" example:"MyOrg"`              // Defaults to "Containerlab"
	OrgUnit      string   `json:"orgUnit,omitempty" example:"Nodes"`                   // Defaults to "Containerlab Tools"
	KeySize      int      `json:"keySize,omitempty" example:"4096"`                    // Defaults to 2048

}

CertSignRequest mirrors flags for `clab tools cert sign`

type ClabContainerInfo 

type ClabContainerInfo struct {
	Name        string `json:"name"`         // Name of the container node (e.g., "lab01-client1")
	ContainerID string `json:"container_id"` // Docker container ID (short)
	Image       string `json:"image"`        // Container image used
	Kind        string `json:"kind"`         // e.g., "linux", "nokia_srlinux"
	State       string `json:"state"`        // e.g., "running"
	Status      string `json:"status"`       // e.g., "Up 18 hours"
	IPv4Address string `json:"ipv4_address"` // Management IPv4 Address/Mask
	IPv6Address string `json:"ipv6_address"` // Management IPv6 Address/Mask
	LabName     string `json:"lab_name"`     // Name of the lab this node belongs to (redundant with map key but present)
	LabPath     string `json:"labPath"`      // Path to the topology file used (relative)
	AbsLabPath  string `json:"absLabPath"`   // Absolute path to topology file
	Group       string `json:"group"`        // Group assigned in topology (Might not always be present)
	Owner       string `json:"owner"`        // OS user from clab inspect output (Used for authorization)
}

ClabContainerInfo matches the structure of each item in the "Containers" array

type ClabExecInternalResult 

type ClabExecInternalResult struct {
	Cmd        []string `json:"cmd"`         // The command and its arguments as executed
	ReturnCode int      `json:"return-code"` // Exit code of the command inside the container
	Stdout     string   `json:"stdout"`      // Standard output of the command
	Stderr     string   `json:"stderr"`      // Standard error of the command
}

ClabExecInternalResult matches the structure within the array in clab's JSON output. It contains details about a single command execution attempt on a node.

type ClabInspectInterfacesOutput 

type ClabInspectInterfacesOutput []NodeInterfaceInfo

ClabInspectInterfacesOutput is the top-level array structure

type ClabInspectOutput 

type ClabInspectOutput map[string][]ClabContainerInfo

ClabInspectOutput matches the top-level structure of `clab inspect --all --format json`

type ClabInspectOutputDetails added in v0.1.1 

type ClabInspectOutputDetails map[string][]json.RawMessage

type DeployRequest 

type DeployRequest struct {
	// Option 1: Direct Topology Content.
	// Provide the full containerlab topology YAML as a single string.
	// If this is provided, 'topologySourceUrl' MUST be empty.
	TopologyContent string `` /* 339-byte string literal not displayed */

	// Option 2: Remote Topology Source URL.
	// Provide a URL to a Git repository, a specific .clab.yml file in Git (github/gitlab), or a raw HTTP(S) URL.
	// If this is provided, 'topologyContent' MUST be empty.
	TopologySourceUrl string `json:"topologySourceUrl,omitempty"`
}

DeployRequest represents the payload for deploying a lab. Provide EITHER 'topologyContent' OR 'topologySourceUrl', but not both.

type DisableTxOffloadRequest 

type DisableTxOffloadRequest struct {
	ContainerName string `json:"containerName" binding:"required" example:"clab-my-lab-srl1"`
}

DisableTxOffloadRequest represents the payload for disabling TX offload.

type ErrorResponse 

type ErrorResponse struct {
	Error string `json:"error"`
}

ErrorResponse represents a standard error message format

type ExecRequest 

type ExecRequest struct {
	Command string `json:"command" binding:"required" example:"ip addr show eth1"`
}

ExecRequest represents the payload for executing a command on lab nodes.

type ExecResponse 

type ExecResponse map[string][]ClabExecInternalResult // <--- Changed value to []ClabExecInternalResult

ExecResponse represents the structured output (JSON format) from the exec command. The keys are the container names. Values are arrays of results (usually one element per array).

type GenerateNodeTier 

type GenerateNodeTier struct {
	Count int    `json:"count" binding:"required,min=1" example:"4"` // Number of nodes in this tier
	Kind  string `json:"kind,omitempty" example:"nokia_srlinux"`     // Node kind (defaults to 'srl'/'nokia_srlinux' if omitted)
	Type  string `json:"type,omitempty" example:"ixrd3"`             // Node type within the kind
}

GenerateNodeTier defines a tier in the CLOS topology for generation.

type GenerateRequest 

type GenerateRequest struct {
	// Name for the generated lab topology.
	Name string `json:"name" binding:"required" example:"3-tier-clos"`

	// Definition of the CLOS tiers. Order matters (leaf -> spine -> superspine).
	// Example: [ { "count": 8, "kind": "srl", "type": "ixrd3" }, { "count": 4, "kind": "nokia_srlinux" }, { "count": 2 } ]
	Tiers []GenerateNodeTier `json:"tiers" binding:"required,min=1"`

	// Default kind to use if not specified in a tier definition. Defaults to 'srl'.
	DefaultKind string `json:"defaultKind,omitempty" example:"nokia_srlinux"`

	// Map of kind to container image. This field is MANDATORY.
	// The key is the node 'kind' (e.g., "nokia_srlinux", "ceos") and the value is the container image path.
	// @Example map[string]string{"nokia_srlinux":"ghcr.io/nokia/srlinux:latest", "linux":"ubuntu:latest"}
	Images map[string]string `json:"images" binding:"required"` // Made mandatory

	// Map of kind to license file path (accessible to the clab command).
	// The key is the node 'kind' (e.g., "srl") and the value is the path to the license file on the server.
	// @Example map[string]string{"srl":"/opt/licenses/srl.lic"}
	Licenses map[string]string `json:"licenses,omitempty"`

	// Prefix for node names (e.g., "node" -> "node-1-1", "node-2-1"). Defaults to "node".
	NodePrefix string `json:"nodePrefix,omitempty" example:"clos-node"`

	// Prefix for node groups (used in graphing). Defaults to "tier".
	GroupPrefix string `json:"groupPrefix,omitempty" example:"clos-tier"`

	// Name of the management network. Defaults to "clab".
	ManagementNetwork string `json:"managementNetwork,omitempty" example:"clos-mgmt"`

	// Management network IPv4 subnet (CIDR). Defaults based on clab default.
	IPv4Subnet string `json:"ipv4Subnet,omitempty" example:"172.20.20.0/24"`

	// Management network IPv6 subnet (CIDR). Defaults based on clab default.
	IPv6Subnet string `json:"ipv6Subnet,omitempty" example:"2001:172:20:20::/64"`

	// If true, immediately deploy the generated topology using 'clab deploy --reconfigure'.
	// The topology file will be saved in the user's ~/.clab/<labName>/ directory.
	Deploy bool `json:"deploy,omitempty"`

	// Limit concurrent workers during deployment (only applies if Deploy=true). 0 means default.
	MaxWorkers int `json:"maxWorkers,omitempty"`

	// Optional: Path where the generated file should be saved *on the server*.
	// If Deploy=true, this field is IGNORED.
	// If Deploy=false and this field is empty, YAML is returned directly in the response.
	// If Deploy=false and this field is set, the file is saved to this path on the server (API server user needs write permission).
	OutputFile string `json:"outputFile,omitempty"` // Path on the server, ignored if Deploy=true
}

GenerateRequest represents the payload for generating a topology file.

type GenerateResponse 

type GenerateResponse struct {
	// Message indicating success or failure.
	Message string `json:"message"`
	// The generated topology YAML (only if Deploy=false and OutputFile is empty).
	TopologyYAML string `json:"topologyYaml,omitempty"`
	// The output from the deploy command (only if Deploy=true). Can be JSON or plain text.
	// Use swaggertype:"object" to represent json.RawMessage in Swagger.
	DeployOutput json.RawMessage `json:"deployOutput,omitempty" swaggertype:"object"`
	// Path where the file was saved (if Deploy=true, it's the path in the user's ~/.clab dir; if Deploy=false, it's the OutputFile path if provided).
	SavedFilePath string `json:"savedFilePath,omitempty"`
}

GenerateResponse represents the result of the generate command.

type GenericSuccessResponse 

type GenericSuccessResponse struct {
	Message string `json:"message"`
}

GenericSuccessResponse for simple success messages

type InterfaceInfo 

type InterfaceInfo struct {
	Name    string `json:"name"`    // Interface name (e.g., "eth0", "e1-1")
	Alias   string `json:"alias"`   // Interface alias (e.g., "ethernet-1/1", "" if none)
	Mac     string `json:"mac"`     // MAC Address
	IfIndex int    `json:"ifindex"` // Interface index
	Mtu     int    `json:"mtu"`     // MTU size
	Type    string `json:"type"`    // Interface type (e.g., "veth", "device", "dummy")
	State   string `json:"state"`   // Interface state (e.g., "up", "down", "unknown")
}

InterfaceInfo describes a single network interface

type LoginRequest 

type LoginRequest struct {
	Username string `json:"username" binding:"required"`
	Password string `json:"password" binding:"required"`
}

LoginRequest represents the payload for the login endpoint

type LoginResponse 

type LoginResponse struct {
	Token string `json:"token"`
}

LoginResponse represents the payload returned after successful login

type NetemInterfaceInfo 

type NetemInterfaceInfo struct {
	Interface  string  `json:"interface"`            // Interface name
	Delay      string  `json:"delay"`                // Duration string or empty
	Jitter     string  `json:"jitter"`               // Duration string or empty
	PacketLoss float64 `json:"packet_loss"`          // Percentage
	Rate       uint    `json:"rate"`                 // Kbit/s
	Corruption float64 `json:"corruption,omitempty"` // Percentage (might be missing in older clab versions)
}

NetemInterfaceInfo holds the netem details for a single interface from `clab tools netem show --format json`

type NetemSetRequest 

type NetemSetRequest struct {
	Delay      string  `json:"delay,omitempty" example:"50ms"`     // Duration string (e.g., "100ms", "1s")
	Jitter     string  `json:"jitter,omitempty" example:"5ms"`     // Duration string, requires Delay
	Loss       float64 `json:"loss,omitempty" example:"10.5"`      // Percentage (0.0 to 100.0)
	Rate       uint    `json:"rate,omitempty" example:"1000"`      // Kbit/s (non-negative integer)
	Corruption float64 `json:"corruption,omitempty" example:"0.1"` // Percentage (0.0 to 100.0)
}

NetemSetRequest represents the parameters for setting network emulation. Use pointers to distinguish between unset and zero values if necessary, but clab defaults usually handle zero values correctly (meaning "unset").

type NetemShowResponse 

type NetemShowResponse map[string][]NetemInterfaceInfo

NetemShowResponse matches the JSON output of `clab tools netem show --format json` It's a map where the key is the node name (container name) and the value is a list of interface details.

type NodeInterfaceInfo 

type NodeInterfaceInfo struct {
	NodeName   string          `json:"name"` // Name of the container node
	Interfaces []InterfaceInfo `json:"interfaces"`
}

NodeInterfaceInfo holds interfaces for a single node

type RedeployRequest 

type RedeployRequest struct {
	Cleanup        bool   `json:"cleanup,omitempty"`        // Corresponds to --cleanup flag
	Graceful       bool   `json:"graceful,omitempty"`       // Corresponds to --graceful flag
	Graph          bool   `json:"graph,omitempty"`          // Corresponds to --graph flag
	Network        string `json:"network,omitempty"`        // Corresponds to --network flag
	Ipv4Subnet     string `json:"ipv4Subnet,omitempty"`     // Corresponds to --ipv4-subnet flag
	Ipv6Subnet     string `json:"ipv6Subnet,omitempty"`     // Corresponds to --ipv6-subnet flag
	MaxWorkers     int    `json:"maxWorkers,omitempty"`     // Corresponds to --max-workers flag (0 means default)
	KeepMgmtNet    bool   `json:"keepMgmtNet,omitempty"`    // Corresponds to --keep-mgmt-net flag
	SkipPostDeploy bool   `json:"skipPostDeploy,omitempty"` // Corresponds to --skip-post-deploy flag
	ExportTemplate string `json:"exportTemplate,omitempty"` // Corresponds to --export-template flag (__full is special)
	SkipLabdirAcl  bool   `json:"skipLabdirAcl,omitempty"`  // Corresponds to --skip-labdir-acl flag
}

RedeployRequest represents the payload for redeploying a lab

type SaveConfigResponse 

type SaveConfigResponse struct {
	// Message indicating overall success.
	Message string `json:"message"`
	// Detailed output from the 'clab save' command (often from stderr).
	Output string `json:"output"`
}

SaveConfigResponse represents the result of the save config command.

type VersionCheckResponse 

type VersionCheckResponse struct {
	// Raw output string from 'clab version check'.
	CheckResult string `` /* 240-byte string literal not displayed */
}

VersionCheckResponse holds the output of the 'clab version check' command.

type VersionResponse 

type VersionResponse struct {
	// Raw output string from 'clab version'.
	VersionInfo string `` /* 190-byte string literal not displayed */
}

VersionResponse holds the output of the 'clab version' command.

type VethCreateRequest 

type VethCreateRequest struct {
	// Endpoint A definition. Format: <node-name>:<interface-name> OR <kind>:<node-name>:<interface-name>
	// Example: "clab-demo-node1:eth1" or "bridge:br-1:br-eth1" or "host:veth-eth1"
	AEndpoint string `json:"aEndpoint" binding:"required" example:"clab-demo-node1:eth1"`

	// Endpoint B definition. Format: <node-name>:<interface-name> OR <kind>:<node-name>:<interface-name>
	// Example: "clab-demo-node2:eth1" or "ovs-bridge:ovsbr-1:br-eth1"
	BEndpoint string `json:"bEndpoint" binding:"required" example:"clab-demo-node2:eth1"`

	// MTU for the vEth pair. Defaults to 9500 if omitted.
	Mtu int `json:"mtu,omitempty" example:"1500"` // Use int, convert to string for command
}

VethCreateRequest represents the payload for `clab tools veth create`.

type VxlanCreateRequest 

type VxlanCreateRequest struct {
	// Remote VTEP IP address.
	Remote string `json:"remote" binding:"required" example:"10.0.0.20"`

	// Name of the existing interface in the root namespace to bridge traffic with.
	Link string `json:"link" binding:"required" example:"srl_e1-1"`

	// VxLAN Network Identifier (VNI). Defaults to 10 if omitted.
	ID int `json:"id,omitempty" example:"100"`

	// UDP port number for the VxLAN tunnel. Defaults to 4789 if omitted.
	Port int `json:"port,omitempty" example:"4789"` // Default is 4789 (IANA standard)

	// Optional: Linux device to use for the tunnel source. Auto-detected if omitted.
	Dev string `json:"dev,omitempty" example:"eth0"`

	// Optional: MTU for the VxLAN interface. Auto-calculated if omitted.
	Mtu int `json:"mtu,omitempty" example:"1400"`
}

VxlanCreateRequest represents the payload for `clab tools vxlan create`.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.