Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions deploy/DNS.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Before deploying NICo, you must configure DNS A records that resolve each `.nico
|---|---|---|---|---|---|
| `nico-api.nico` | 443 | gRPC / TLS | DPU agents, admin CLI, PXE service, DHCP plugin, FMDS, health probe | `nico-api` pod | NICo gRPC API |
| `nico-pxe.nico` | 80 | HTTP | DPU agents, iPXE clients | `nico-pxe` pod | iPXE scripts, cloud-init payloads, boot artifacts, internal APT |
| `nico-static-pxe.nico` | 80 | HTTP | Host PXE loader (scout) | `nico-static-pxe` pod | Static boot files: `scout.cpio.zst`, `scout.efi`, BFB images |
| `nico-static-pxe.nico` | 80 | HTTP | Host PXE loader (scout) | `nico-static-pxe` pod | Static boot files: `scout.squashfs`, `scout.efi`, BFB images |
| `nico-ntp.nico` | 123 | UDP (NTP) | DPU agents, managed hosts (DHCP option 42) | `nico-ntp` pods | NTP time synchronisation |
| `unbound.nico` | 53 | UDP / TCP (DNS) | DPU agents, managed hosts (DHCP option 6) | `nico-unbound` pod | Site-local recursive DNS resolver |
| `otel-receiver.nico` | 443 | gRPC / TLS (OTLP) | DPU otel-collector sidecars | otel-receiver service | OpenTelemetry ingestion endpoint |
Expand Down Expand Up @@ -71,7 +71,7 @@ Serves dynamic per-machine iPXE boot scripts, cloud-init payloads, boot artifact
Serves pre-built, version-controlled boot assets used during host bring-up. Unlike `nico-pxe.nico`, content here is static rather than dynamically generated per machine.

**Consumers:**
- Scout host PXE loader — downloads `scout.cpio.zst` (the initramfs), `scout.efi`, and BFB images used during host network boot and DPU firmware provisioning
- Scout host PXE loader — downloads `scout.squashfs` (the initramfs), `scout.efi`, and BFB images used during host network boot and DPU firmware provisioning

**Configurability:** The URL is hardcoded in host boot shell scripts (`pxe/common_files/scout-loader-rclocal`, `pxe/common_files/check-scout-updates.sh`) that are embedded in boot images at build time. The server-side deployment can set `NICO_STATIC_PXE_URL` to override the URL used by the PXE service, but the embedded client scripts that run on hosts **cannot be reconfigured at runtime**.

Expand Down
2 changes: 1 addition & 1 deletion deploy/files/unbound/local_data.conf
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ server:
local-data: "nico-pxe.nico 300 IN A {{ NICO_PXE_IP }}"

# nico-static-pxe.nico — Static boot asset server
# Port 80 (HTTP). Accessed by the host scout PXE loader for scout.cpio.zst,
# Port 80 (HTTP). Accessed by the host scout PXE loader for scout.squashfs,
# scout.efi, and BFB images.
# WARNING: hardcoded in pxe/common_files/scout-loader-rclocal and
# pxe/common_files/check-scout-updates.sh
Expand Down
Loading