# kubeslice/netops architecture

> Architecture diagram of the GitHub repository kubeslice/netops, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kubeslice/netops
- Repository: https://github.com/kubeslice/netops

## Overview

NetOps is a Kubernetes pod that applies slice QoS using Linux Traffic Control. The workflow starts with the Slice Controller sending gRPC QoS, lifecycle, and gateway-context updates; the server validates and dispatches requests, and slice state drives TC classes and gateway filters on the selected network interface. The README documents cluster deployment, but not additional runtime capabilities. Edges reflect shown calls and registration; the handler excerpt is partial, so some internal relationships are not expanded.

Main entry points: [`server/netop_handler.go`](https://github.com/kubeslice/netops/blob/master/server/netop_handler.go) (QoS Handler), [`server/netop_grpc_server.go`](https://github.com/kubeslice/netops/blob/master/server/netop_grpc_server.go) (gRPC Service), [`main.go`](https://github.com/kubeslice/netops/blob/master/main.go) (Pod Entrypoint), [`server/status.go`](https://github.com/kubeslice/netops/blob/master/server/status.go) (Command Runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Controller API"]
  node_proto["gRPC Contract<br/>[netop.proto]"]
  node_entry["Pod Entrypoint<br/>[main.go]"]
  node_grpc["gRPC Service"]
end

subgraph group_policy["Slice QoS"]
  node_state["Slice State<br/>[common.go]"]
  node_handler["QoS Handler<br/>[netop_handler.go]"]
end

subgraph group_tc["Traffic Control"]
  node_tcconfig["TC Configuration<br/>[netop_handler.go]"]
  node_gateway["Gateway Filters<br/>[netop_handler.go]"]
end

subgraph group_support["Runtime support"]
  node_commands["Command Runner<br/>[status.go]"]
  node_logger["Logger<br/>[logger.go]"]
end

node_controller(("Slice Controller"))
node_kernel(("Linux Traffic Control"))

node_controller -->|"sends RPCs"| node_grpc
node_entry -->|"registers service"| node_grpc
node_entry -->|"uses service"| node_proto
node_entry -->|"bootstraps"| node_handler
node_entry -->|"initializes"| node_logger
node_grpc -->|"dispatches QoS"| node_handler
node_grpc -->|"updates gateway state"| node_state
node_handler -->|"maintains"| node_state
node_handler -->|"configures classes"| node_tcconfig
node_handler -->|"configures filters"| node_gateway
node_tcconfig -->|"runs commands"| node_commands
node_gateway -->|"runs commands"| node_commands
node_commands -->|"executes tc"| node_kernel
node_handler -->|"logs operations"| node_logger
node_grpc -->|"logs requests"| node_logger

click node_proto "https://github.com/kubeslice/netops/blob/master/pkg/proto/netop.proto"
click node_entry "https://github.com/kubeslice/netops/blob/master/main.go"
click node_grpc "https://github.com/kubeslice/netops/blob/master/server/netop_grpc_server.go"
click node_state "https://github.com/kubeslice/netops/blob/master/server/common.go"
click node_handler "https://github.com/kubeslice/netops/blob/master/server/netop_handler.go"
click node_tcconfig "https://github.com/kubeslice/netops/blob/master/server/netop_handler.go"
click node_gateway "https://github.com/kubeslice/netops/blob/master/server/netop_handler.go"
click node_commands "https://github.com/kubeslice/netops/blob/master/server/status.go"
click node_logger "https://github.com/kubeslice/netops/blob/master/logger/logger.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_proto,node_entry,node_grpc toneBlue
class node_state,node_handler toneAmber
class node_tcconfig,node_gateway toneMint
class node_commands,node_logger toneRose
class node_controller,node_kernel toneIndigo
```

## Components

### Controller API

- [gRPC Contract](https://github.com/kubeslice/netops/blob/master/pkg/proto/netop.proto): `pkg/proto/netop.proto`
- [Pod Entrypoint](https://github.com/kubeslice/netops/blob/master/main.go): `main.go`
- [gRPC Service](https://github.com/kubeslice/netops/blob/master/server/netop_grpc_server.go): `server/netop_grpc_server.go`

### Slice QoS

- [Slice State](https://github.com/kubeslice/netops/blob/master/server/common.go): `server/common.go`
- [QoS Handler](https://github.com/kubeslice/netops/blob/master/server/netop_handler.go): `server/netop_handler.go`

### Traffic Control

- [TC Configuration](https://github.com/kubeslice/netops/blob/master/server/netop_handler.go): `server/netop_handler.go`
- [Gateway Filters](https://github.com/kubeslice/netops/blob/master/server/netop_handler.go): `server/netop_handler.go`

### Runtime support

- [Command Runner](https://github.com/kubeslice/netops/blob/master/server/status.go): `server/status.go`
- [Logger](https://github.com/kubeslice/netops/blob/master/logger/logger.go): `logger/logger.go`

### Other components

- **Slice Controller**
- **Linux Traffic Control**

## Connections

- Slice Controller → gRPC Service: sends RPCs
- Pod Entrypoint → gRPC Service: registers service (evidence: `main.go`)
- Pod Entrypoint → gRPC Contract: uses service (evidence: `main.go`)
- Pod Entrypoint → QoS Handler: bootstraps (evidence: `main.go`)
- Pod Entrypoint → Logger: initializes (evidence: `main.go`)
- gRPC Service → QoS Handler: dispatches QoS (evidence: `server/netop_grpc_server.go`)
- gRPC Service → Slice State: updates gateway state (evidence: `server/netop_grpc_server.go`)
- QoS Handler → Slice State: maintains (evidence: `server/netop_handler.go`)
- QoS Handler → TC Configuration: configures classes (evidence: `server/netop_handler.go`)
- QoS Handler → Gateway Filters: configures filters (evidence: `server/netop_handler.go`)
- TC Configuration → Command Runner: runs commands (evidence: `server/netop_handler.go`)
- Gateway Filters → Command Runner: runs commands (evidence: `server/netop_handler.go`)
- Command Runner → Linux Traffic Control: executes tc (evidence: `server/status.go`)
- QoS Handler → Logger: logs operations (evidence: `server/netop_handler.go`)
- gRPC Service → Logger: logs requests (evidence: `server/netop_grpc_server.go`)
