Skip to content

docs: fix multi-AIPC deployment guide gaps and align k3s endpoint port#122

Merged
KerwinTsaiii merged 1 commit into
docsfrom
docs-multi-node-pxe-example
Jun 8, 2026
Merged

docs: fix multi-AIPC deployment guide gaps and align k3s endpoint port#122
KerwinTsaiii merged 1 commit into
docsfrom
docs-multi-node-pxe-example

Conversation

@KerwinTsaiii

Copy link
Copy Markdown
Collaborator

Summary

Follow-up fixes for the 3 Node Mini-Cluster Example guide, based on a real single-machine deployment (one host running PXE controller + single-node k3s server + JupyterHub) taken end-to-end (login + GPU notebook verified).

  • Step 1 — add a passwordless root SSH prerequisite (and an ansible_connection: local alternative for the self-managed service machine) so the PXE playbook no longer fails at "Gathering Facts".
  • Step 6 — make sudo / kubectl / ansible-playbook usage consistent: run playbooks without sudo, export KUBECONFIG=~/.kube/config before the first kubectl, and drop the duplicate k3s kubectl verification line.
  • Step 11 — append the notebook NFS export to /etc/exports instead of /etc/exports.d/*.conf, which Ubuntu 24.04 silently ignores (left PVCs Pending).
  • Step 12 — use authMode: "auto-login" (the single-node default) instead of "dummy", whose login form returns 404.
  • Endpoints — align the Apache /k3s/ credential endpoint to port 8080 (pxe_web_port) so the PXE controller can co-exist with k3s Traefik / ServiceLB which owns host ports 80/443.

Notes

  • The matching role change (pxe_web_port / Apache on 8080) ships separately in the deploy/fix-pxe-config branch PR.

Test plan

  • Docs build renders the updated Steps 1, 6, 11, 12 without MyST syntax errors
  • Port references all read :8080 for the /k3s/ endpoints

Made with Cursor

Address issues found during a single-machine (PXE + k3s server + JupyterHub)
end-to-end deployment of the 3 Node Mini-Cluster example:

- Add a "passwordless root SSH" prerequisite in Step 1 (and an
  ansible_connection: local alternative for the self-managed service machine)
  so the PXE playbook does not fail at "Gathering Facts".
- Make sudo / kubectl / ansible-playbook usage consistent: run playbooks
  without sudo, export KUBECONFIG before first kubectl, and drop the
  duplicate k3s kubectl verification command.
- Step 11: append the notebook NFS export to /etc/exports instead of
  /etc/exports.d/*.conf, which is silently ignored on Ubuntu 24.04 and left
  PVCs Pending.
- Step 12: use authMode "auto-login" (the single-node default) instead of
  "dummy", whose login form 404s.
- Align the Apache /k3s/ credential endpoint to port 8080 (pxe_web_port) so
  the PXE controller can co-exist with k3s Traefik / ServiceLB on host 80/443.

Co-authored-by: Cursor <cursoragent@cursor.com>
@KerwinTsaiii KerwinTsaiii merged commit ac17816 into docs Jun 8, 2026
2 checks passed
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.

1 participant