feat(deploy): add PXE controller role for multi-node netboot#112
Closed
Stanley-PH wants to merge 1 commit into
Closed
feat(deploy): add PXE controller role for multi-node netboot#112Stanley-PH wants to merge 1 commit into
Stanley-PH wants to merge 1 commit into
Conversation
Port the pxe_controller Ansible role and pb-pxe-controller.yml playbook referenced by the Multi-AIPC PXE Netboot deployment guide. - Add the mount-local-disk.service.j2 / mount-local-disk.sh.j2 agent templates (with a .gitignore negation so the "*local*" rule does not drop them) that tasks/main.yml, chroot-setup.sh.j2 and k3s-auto-join.service depend on. - Keep all site-specific values operator-supplied: blank root password, empty SSH authorized_keys, and empty PXE/k3s server IPs, with a pre-flight assert that fails fast if the required IPs are unset or still placeholders. - Print accurate post-run next steps (no references to non-existent helper scripts) and frame the optional Cloudflare WARP module preload as out of scope for the base deployment.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds the
pxe_controllerAnsible role andpb-pxe-controller.ymlplaybook for multi-node PXE netboot deployment, referenced by the Multi-AIPC PXE Netboot deployment guide. Pairs with the docs PR #111.set-hostname,k3s-auto-join,mount-local-disk).mount-local-disk.*.j2agent persistence templates with a.gitignorenegation so the*local*rule doesn't silently drop them.authorized_keys, and empty PXE/k3s server IPs, with a pre-flight assert that fails fast if the required IPs are unset or still<...>placeholders.Notes for reviewers
192.168.1.0/24,8.8.8.8,127.0.0.1).chroot-setup.sh.j2is intentionally left unpinned (documented caveat in the guide's K3s server section).nft_rejectmodule preload is framed as out of scope for this base deployment.r8125DKMS driver source (122 KB) used to build the NIC driver in the rootfs.Test plan
pre-commit run --all-files(yamllint / shellcheck / detect-private-key)ansible-lint deploy/ansible/playbooks/pb-pxe-controller.ymlansible-playbook --syntax-check deploy/ansible/playbooks/pb-pxe-controller.ymlmount-local-diskunits land in/srv/nfs/rootfsMade with Cursor