Skip to content

Document controller-backed E2E and cluster CNI#235

Merged
bcho merged 6 commits into
mainfrom
hbc/controller-cni-docs
Jul 14, 2026
Merged

Document controller-backed E2E and cluster CNI#235
bcho merged 6 commits into
mainfrom
hbc/controller-cni-docs

Conversation

@bcho

@bcho bcho commented Jul 10, 2026

Copy link
Copy Markdown
Member

Related PRs

This PR is intentionally based on hbc/unbounded-net-cni-e2e; review only the documentation and demo-asset diff from that branch.

Summary

  • document the ConfigMap-backed in-cluster machine endpoint
  • replace local-file E2E machine-state references with controller-backed state
  • document controller-driven repave validation
  • document the ARM-compatible machine response, ETag drift version, and separate status patch model
  • document the no-CNI AKS setup and Unbounded-Net installation
  • add the demo Site, sample application, and connectivity/latency validation script
  • update the development tree and machine-client configuration reference
  • update E2E prerequisites, commands, variables, layout, and troubleshooting

Draft follow-up

  • finish reconciling docs/design.md with the current configuration/authentication model and remove remaining local-file/test-mode wording
  • make HTTP connectivity failures fail the demo connectivity validator, not only appear in its summary

Validation

  • git diff --check
  • bash -n hack/demo/aks-flex-validate-demo-connectivity.sh

This PR contains documentation and demo assets relative to #234.

@bcho bcho force-pushed the hbc/controller-cni-docs branch from c80db43 to 0551518 Compare July 10, 2026 17:09
@bcho bcho force-pushed the hbc/unbounded-net-cni-e2e branch from 31865b3 to 0a1628b Compare July 10, 2026 17:16
@bcho bcho force-pushed the hbc/controller-cni-docs branch 2 times, most recently from 6b3cf23 to 76a3094 Compare July 10, 2026 17:24
@bcho bcho force-pushed the hbc/unbounded-net-cni-e2e branch from ea69964 to ee57ed1 Compare July 10, 2026 18:38
@bcho bcho force-pushed the hbc/controller-cni-docs branch from 76a3094 to bd2ecd8 Compare July 10, 2026 18:39
@bcho bcho force-pushed the hbc/unbounded-net-cni-e2e branch from ee57ed1 to c28c0e7 Compare July 10, 2026 18:50
@bcho bcho force-pushed the hbc/controller-cni-docs branch from bd2ecd8 to fce78ac Compare July 10, 2026 18:50
@bcho bcho force-pushed the hbc/unbounded-net-cni-e2e branch from c28c0e7 to 48c3648 Compare July 10, 2026 18:56
@bcho bcho force-pushed the hbc/controller-cni-docs branch from fce78ac to 5d1f03a Compare July 10, 2026 18:57
@bcho bcho force-pushed the hbc/unbounded-net-cni-e2e branch from 48c3648 to b2d9588 Compare July 10, 2026 19:01
@bcho bcho force-pushed the hbc/controller-cni-docs branch from 5d1f03a to fd7c62b Compare July 10, 2026 19:02
Base automatically changed from hbc/unbounded-net-cni-e2e to main July 10, 2026 21:08
# Conflicts:
#	.env.example
#	hack/e2e/lib/cleanup.sh
#	hack/e2e/lib/common.sh
#	hack/e2e/run.sh
@bcho bcho deployed to e2e-testing July 14, 2026 21:17 — with GitHub Actions Active
@bcho bcho marked this pull request as ready for review July 14, 2026 21:27
Copilot AI review requested due to automatic review settings July 14, 2026 21:27

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates AKS Flex Node documentation and demo assets to reflect the controller-backed (ConfigMap + service-proxy) machine endpoint and the no-CNI AKS + Unbounded-Net E2E/cluster networking model, and adds demo manifests/scripts for validating connectivity and drain behavior.

Changes:

  • Refresh E2E docs to describe no-CNI AKS provisioning, Unbounded-Net installation, and controller-backed machine goal/repave validation.
  • Update configuration and design docs for the in-cluster machine client, ARM-compatible machine response shape (ETag drift key), and status patch model.
  • Add demo Site + sample app manifests and a connectivity/latency validation script for demo-site nodes.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
hack/e2e/README.md Updates E2E flow/prereqs/env vars to include Unbounded-Net + in-cluster controller/registry.
hack/demo/sample-application.yaml Adds a multi-replica demo workload for drain/placement demonstrations.
hack/demo/demo-site.yaml Adds a demo Unbounded-Net Site + gateway pool assignment manifest.
hack/demo/aks-flex-validate-demo-connectivity.sh Adds a demo connectivity/latency validation script for demo-site nodes.
docs/usages/configuration.md Documents agent.machineClient.* configuration for ARM vs in-cluster mode.
docs/development.md Updates the project tree to include aks-flex-controller.
docs/design/agent-and-aks.md Updates design narrative for controller-backed machine goals and ETag-based drift.
docs/design.md Adjusts high-level design wording for cluster-CNI wiring.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread hack/demo/aks-flex-validate-demo-connectivity.sh
Comment thread docs/usages/configuration.md
@bcho bcho merged commit 31038e9 into main Jul 14, 2026
11 checks passed
@bcho bcho deleted the hbc/controller-cni-docs branch July 14, 2026 21:42
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.

3 participants