# nvidia/mig-parted architecture

> Architecture diagram of the GitHub repository nvidia/mig-parted, 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/nvidia/mig-parted
- Repository: https://github.com/nvidia/mig-parted

## Overview

MIG Parted is an administrator-facing NVIDIA GPU partition manager. Its main workflow selects a declarative configuration, checks GPU capabilities and current MIG state, then applies MIG mode and device layout; administrators can also assert or export the result. Checkpoint/restore and generated configurations are separate CLI capabilities, while the MIG Manager watches Kubernetes configuration changes and invokes reconfiguration. The map uses sampled source and README evidence; several internal command and reconfiguration details were not excerpted, so uncertain links are omitted or marked unverified.

Main entry points: [`cmd/nvidia-mig-parted/main.go`](https://github.com/nvidia/mig-parted/blob/main/cmd/nvidia-mig-parted/main.go) (MIG Parted CLI), [`cmd/nvidia-mig-manager/main.go`](https://github.com/nvidia/mig-parted/blob/main/cmd/nvidia-mig-manager/main.go) (MIG Manager), [`pkg/mig/builder/builder.go`](https://github.com/nvidia/mig-parted/blob/main/pkg/mig/builder/builder.go) (Config Builder), [`pkg/mig/state/state.go`](https://github.com/nvidia/mig-parted/blob/main/pkg/mig/state/state.go) (State Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["Administrator CLI"]
  node_parted["MIG Parted CLI<br/>[main.go]"]
  node_apply["Apply Config<br/>[apply.go]"]
  node_assert["Assert Config<br/>[assert.go]"]
  node_export["Export Config<br/>[export.go]"]
  node_generate["Generate Config<br/>[generate_config.go]"]
  node_checkpoint["Checkpoint State<br/>[checkpoint.go]"]
  node_restore["Restore State<br/>[restore.go]"]
end

subgraph group_runtime["MIG Runtime"]
  node_discovery["Profile Discovery<br/>[discovery.go]"]
  node_builder["Config Builder<br/>[builder.go]"]
  node_config["MIG Config Manager<br/>[config.go]"]
  node_mode["MIG Mode Manager<br/>[mode.go]"]
  node_state["State Manager<br/>[state.go]"]
  node_reconfigure["Reconfiguration<br/>[reconfigure.go]"]
  node_systemd["Systemd Integration<br/>[systemd.go]"]
end

subgraph group_manager["Kubernetes Manager"]
  node_migmanager["MIG Manager<br/>[main.go]"]
end

subgraph group_model["Configuration and State"]
  node_spec["Config Specification<br/>[spec.go]"]
  node_stateformat["Checkpoint Format<br/>[state.go]"]
end

node_admin(("Administrator"))
node_gpu[("NVIDIA GPUs")]
node_kubernetes["Kubernetes API"]

node_admin -->|"runs commands"| node_parted
node_parted -->|"registers"| node_apply
node_parted -->|"registers"| node_assert
node_parted -->|"registers"| node_export
node_parted -->|"registers"| node_generate
node_parted -->|"registers"| node_checkpoint
node_parted -->|"registers"| node_restore
node_apply -->|"checks mode"| node_assert
node_apply -.->|"applies layout"| node_gpu
node_assert -.->|"checks layout"| node_gpu
node_export -.->|"exports current state"| node_gpu
node_generate -.->|"requests generation"| node_builder
node_builder -->|"uses profiles"| node_discovery
node_builder -->|"builds specification"| node_spec
node_discovery -->|"discovers profiles"| node_gpu
node_state -->|"reads mode"| node_mode
node_state -->|"reads layout"| node_config
node_state -->|"fetches state"| node_gpu
node_restore -->|"parses checkpoint"| node_stateformat
node_checkpoint -.->|"writes checkpoint"| node_stateformat
node_migmanager -->|"watches config"| node_kubernetes
node_migmanager -->|"queries profiles"| node_discovery
node_migmanager -->|"builds config"| node_builder
node_migmanager -->|"reconfigures GPUs"| node_reconfigure
node_reconfigure -->|"uses integration"| node_systemd
node_reconfigure -.->|"changes MIG state"| node_gpu

click node_parted "https://github.com/nvidia/mig-parted/blob/main/cmd/nvidia-mig-parted/main.go"
click node_apply "https://github.com/nvidia/mig-parted/blob/main/cmd/nvidia-mig-parted/apply/apply.go"
click node_assert "https://github.com/nvidia/mig-parted/blob/main/cmd/nvidia-mig-parted/assert/assert.go"
click node_export "https://github.com/nvidia/mig-parted/blob/main/cmd/nvidia-mig-parted/export/export.go"
click node_generate "https://github.com/nvidia/mig-parted/blob/main/cmd/nvidia-mig-parted/generateconfig/generate_config.go"
click node_checkpoint "https://github.com/nvidia/mig-parted/blob/main/cmd/nvidia-mig-parted/checkpoint/checkpoint.go"
click node_restore "https://github.com/nvidia/mig-parted/blob/main/cmd/nvidia-mig-parted/restore/restore.go"
click node_spec "https://github.com/nvidia/mig-parted/blob/main/api/spec/v1/spec.go"
click node_discovery "https://github.com/nvidia/mig-parted/blob/main/pkg/mig/discovery/discovery.go"
click node_builder "https://github.com/nvidia/mig-parted/blob/main/pkg/mig/builder/builder.go"
click node_config "https://github.com/nvidia/mig-parted/blob/main/pkg/mig/config/config.go"
click node_mode "https://github.com/nvidia/mig-parted/blob/main/pkg/mig/mode/mode.go"
click node_state "https://github.com/nvidia/mig-parted/blob/main/pkg/mig/state/state.go"
click node_reconfigure "https://github.com/nvidia/mig-parted/blob/main/pkg/mig/reconfigure/reconfigure.go"
click node_stateformat "https://github.com/nvidia/mig-parted/blob/main/api/checkpoint/v1/state.go"
click node_migmanager "https://github.com/nvidia/mig-parted/blob/main/cmd/nvidia-mig-manager/main.go"
click node_systemd "https://github.com/nvidia/mig-parted/blob/main/internal/systemd/systemd.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_parted,node_apply,node_assert,node_export,node_generate,node_checkpoint,node_restore toneBlue
class node_discovery,node_builder,node_config,node_mode,node_state,node_reconfigure,node_systemd,node_gpu toneAmber
class node_migmanager,node_kubernetes toneMint
class node_spec,node_stateformat toneRose
class node_admin toneIndigo
```

## Components

### Administrator CLI

- [MIG Parted CLI](https://github.com/nvidia/mig-parted/blob/main/cmd/nvidia-mig-parted/main.go): `cmd/nvidia-mig-parted/main.go`
- [Apply Config](https://github.com/nvidia/mig-parted/blob/main/cmd/nvidia-mig-parted/apply/apply.go): `cmd/nvidia-mig-parted/apply/apply.go`
- [Assert Config](https://github.com/nvidia/mig-parted/blob/main/cmd/nvidia-mig-parted/assert/assert.go): `cmd/nvidia-mig-parted/assert/assert.go`
- [Export Config](https://github.com/nvidia/mig-parted/blob/main/cmd/nvidia-mig-parted/export/export.go): `cmd/nvidia-mig-parted/export/export.go`
- [Generate Config](https://github.com/nvidia/mig-parted/blob/main/cmd/nvidia-mig-parted/generateconfig/generate_config.go): `cmd/nvidia-mig-parted/generateconfig/generate_config.go`
- [Checkpoint State](https://github.com/nvidia/mig-parted/blob/main/cmd/nvidia-mig-parted/checkpoint/checkpoint.go): `cmd/nvidia-mig-parted/checkpoint/checkpoint.go`
- [Restore State](https://github.com/nvidia/mig-parted/blob/main/cmd/nvidia-mig-parted/restore/restore.go): `cmd/nvidia-mig-parted/restore/restore.go`

### MIG Runtime

- [Profile Discovery](https://github.com/nvidia/mig-parted/blob/main/pkg/mig/discovery/discovery.go): `pkg/mig/discovery/discovery.go`
- [Config Builder](https://github.com/nvidia/mig-parted/blob/main/pkg/mig/builder/builder.go): `pkg/mig/builder/builder.go`
- [MIG Config Manager](https://github.com/nvidia/mig-parted/blob/main/pkg/mig/config/config.go): `pkg/mig/config/config.go`
- [MIG Mode Manager](https://github.com/nvidia/mig-parted/blob/main/pkg/mig/mode/mode.go): `pkg/mig/mode/mode.go`
- [State Manager](https://github.com/nvidia/mig-parted/blob/main/pkg/mig/state/state.go): `pkg/mig/state/state.go`
- [Reconfiguration](https://github.com/nvidia/mig-parted/blob/main/pkg/mig/reconfigure/reconfigure.go): `pkg/mig/reconfigure/reconfigure.go`
- [Systemd Integration](https://github.com/nvidia/mig-parted/blob/main/internal/systemd/systemd.go): `internal/systemd/systemd.go`

### Kubernetes Manager

- [MIG Manager](https://github.com/nvidia/mig-parted/blob/main/cmd/nvidia-mig-manager/main.go): `cmd/nvidia-mig-manager/main.go`

### Configuration and State

- [Config Specification](https://github.com/nvidia/mig-parted/blob/main/api/spec/v1/spec.go): `api/spec/v1/spec.go`
- [Checkpoint Format](https://github.com/nvidia/mig-parted/blob/main/api/checkpoint/v1/state.go): `api/checkpoint/v1/state.go`

### Other components

- **Administrator**
- **NVIDIA GPUs**
- **Kubernetes API**

## Connections

- Administrator → MIG Parted CLI: runs commands (evidence: `README.md`)
- MIG Parted CLI → Apply Config: registers (evidence: `cmd/nvidia-mig-parted/main.go`)
- MIG Parted CLI → Assert Config: registers (evidence: `cmd/nvidia-mig-parted/main.go`)
- MIG Parted CLI → Export Config: registers (evidence: `cmd/nvidia-mig-parted/main.go`)
- MIG Parted CLI → Generate Config: registers (evidence: `cmd/nvidia-mig-parted/main.go`)
- MIG Parted CLI → Checkpoint State: registers (evidence: `cmd/nvidia-mig-parted/main.go`)
- MIG Parted CLI → Restore State: registers (evidence: `cmd/nvidia-mig-parted/main.go`)
- Apply Config → Assert Config: checks mode (evidence: `cmd/nvidia-mig-parted/apply/apply.go`)
- Apply Config → NVIDIA GPUs: applies layout (evidence: `README.md`)
- Assert Config → NVIDIA GPUs: checks layout (evidence: `README.md`)
- Export Config → NVIDIA GPUs: exports current state (evidence: `README.md`)
- Generate Config → Config Builder: requests generation (evidence: `pkg/mig/builder/builder.go`)
- Config Builder → Profile Discovery: uses profiles (evidence: `pkg/mig/builder/builder.go`)
- Config Builder → Config Specification: builds specification (evidence: `pkg/mig/builder/builder.go`)
- Profile Discovery → NVIDIA GPUs: discovers profiles (evidence: `pkg/mig/discovery/discovery.go`)
- State Manager → MIG Mode Manager: reads mode (evidence: `pkg/mig/state/state.go`)
- State Manager → MIG Config Manager: reads layout (evidence: `pkg/mig/state/state.go`)
- State Manager → NVIDIA GPUs: fetches state (evidence: `pkg/mig/state/state.go`)
- Restore State → Checkpoint Format: parses checkpoint (evidence: `cmd/nvidia-mig-parted/restore/restore.go`)
- Checkpoint State → Checkpoint Format: writes checkpoint
- MIG Manager → Kubernetes API: watches config (evidence: `cmd/nvidia-mig-manager/main.go`)
- MIG Manager → Profile Discovery: queries profiles (evidence: `cmd/nvidia-mig-manager/main.go`)
- MIG Manager → Config Builder: builds config (evidence: `cmd/nvidia-mig-manager/main.go`)
- MIG Manager → Reconfiguration: reconfigures GPUs (evidence: `cmd/nvidia-mig-manager/main.go`)
- Reconfiguration → Systemd Integration: uses integration (evidence: `pkg/mig/reconfigure/reconfigure.go`)
- Reconfiguration → NVIDIA GPUs: changes MIG state
