Skip to content

docs: add Multi-AIPC PXE netboot deployment guide#111

Closed
Stanley-PH wants to merge 1 commit into
docsfrom
docs-multi-node-deployment-pattern
Closed

docs: add Multi-AIPC PXE netboot deployment guide#111
Stanley-PH wants to merge 1 commit into
docsfrom
docs-multi-node-deployment-pattern

Conversation

@Stanley-PH
Copy link
Copy Markdown

Summary

Adds a runnable worked-example guide for deploying AUP Learning Cloud across three AIPCs via PXE netboot (installation/multi-node/multi-aipc-hardware-deployment), and wires it into the installation toctree and multi-node index.

The guide covers the full path end to end:

  • Architecture overview + diagram (basic-example-pxe-architecture.svg)
  • PXE controller playbook configuration (operator fills in site IPs/SSH keys; no real values in the guide)
  • Manual K3s server install + publishing token/kubeconfig for netboot agents
  • Agent netboot, hostname, local-disk persistence, and auto-join
  • AMD GPU device plugin + ROCm labeller
  • Shared NFS storage for notebook PVCs
  • JupyterHub values + chart deploy, and end-to-end validation (including spawning a course notebook)

Notes

  • Pairs with the pxe_controller Ansible role change in aup-learning-cloud (code PR).
  • Section 4 documents the shipped mount-local-disk persistence (incl. an mkfs.ext4 safety note); "Out Of Scope" carries a <!-- --> marker for future config tutorials (Cloudflare/WARP/Zot/etc.).

Test plan

  • Docs build (make html) renders the new page + toctree without warnings
  • Architecture SVG displays and cross-links resolve

Made with Cursor

Add a runnable worked-example guide for deploying AUP Learning Cloud across
three AIPCs via PXE netboot: architecture overview and diagram, PXE controller
playbook configuration, K3s server install and credential publishing, agent
netboot, AMD GPU device plugin, shared NFS storage, JupyterHub values, and
end-to-end validation. Wire it into the installation toctree.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants