Refresh AKS Flex Node documentation#165
Merged
Merged
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR refreshes AKS Flex Node documentation to reflect the current Unbounded/systemd-nspawn architecture and provides a validated bootstrap-token getting-started flow with reusable examples.
Changes:
- Reworked the top-level README getting-started flow around bootstrap tokens and added reusable config/RBAC examples under
docs/examples. - Split the previous monolithic usage guide into focused guides under
docs/usages(joining, operations, configuration) and updated design docs for the current repave model. - Updated E2E documentation and removed legacy diagram assets.
Reviewed changes
Copilot reviewed 16 out of 18 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| README.md | New bootstrap-token walkthrough and updated project overview/links. |
| hack/e2e/README.md | Updated E2E suite description, commands, options, and troubleshooting. |
| docs/usages/operations.md | New operations guide (start/service/machinectl/reset/troubleshooting). |
| docs/usages/joining-nodes.md | New joining guide covering auth mode options and bootstrap-token flow. |
| docs/usages/configuration.md | New configuration reference and sample configs. |
| docs/usage.md | Replaced old long-form usage doc with pointers to scenario guides. |
| docs/examples/bootstrap-token-rbac.yaml | Added RBAC + bootstrap token manifest template for envsubst. |
| docs/examples/bootstrap-token-config.json | Added bootstrap-token config template for envsubst. |
| docs/drift-repave.md | Removed legacy repave doc (content consolidated elsewhere). |
| docs/development.md | Updated dev docs (Go version reference, layout, links). |
| docs/design/agent-and-aks.md | Added consolidated “Current Repave Implementation” section. |
| docs/design.md | Reworked design summary; switched from static diagrams to mermaid and updated lifecycle/auth sections. |
| diagrams/system-overview.svg | Removed legacy generated SVG diagram. |
| diagrams/system-overview.mmd | Removed legacy mermaid source diagram. |
| diagrams/README.md | Removed diagram regeneration documentation. |
| diagrams/generate.sh | Removed diagram generation script. |
| diagrams/bootstrap-workflow.svg | Removed legacy generated SVG sequence diagram. |
| diagrams/bootstrap-workflow.mmd | Removed legacy mermaid source sequence diagram. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
jwilder
approved these changes
May 20, 2026
wenxuan0923
approved these changes
May 22, 2026
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
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
docs/examples.docs/usages.docs/design/agent-and-aks.md.Validation
bahe-devand joined it to thebahe-devAKS cluster using the README bootstrap-token flow.aks-flex-nodewithAKS_FLEX_NODE_VERSION=v0.1.0.alpha-4for validation.aks-flex-node-agentbecame active and the node reportedReadywithkubectl get nodes -o wide.