microsoft-foundry / microsoft-foundry/foundry-samples
Template 19: document readiness checks and reprovisioning criteria for older deployments
Nobody has claimed this yet.
- Dominant language
- Bicep
- Stars
- 445
- Forks
- 494
- Avg merge
- 11h 35m
- Merged PRs (30d)
- 38
Description
Problem
A freshly provisioned Template 19 environment can work while an older Foundry Agent Service deployment with apparently similar networking still fails private MCP DNS or connectivity. The current guidance does not provide a compact way to determine whether the older resource is equivalent to the current reference pattern or must be recreated.
Suggested improvement
Add an "existing deployment readiness and migration" section that shows how to verify:
- Standard Agent Setup/capability host health;
networkInjections[].scenario == agent;useMicrosoftManagedNetwork == falsefor BYO VNet;- delegated agent subnet and service association link health;
- private DNS zone linkage and resolution;
- whether network injection was configured at initial account creation; and
- which configuration differences require reprovisioning rather than an in-place fix.
Please distinguish these outcomes:
- deployment matches the current pattern and should be troubleshot in place;
- DNS/subnet/capability-host configuration can be repaired;
- network injection cannot be added or changed in place and the account must be recreated.
Why this helps
It prevents a successful clean-room test from turning into a blanket "recreate everything" recommendation, while still making the true reprovisioning cases explicit.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by locating the current Template 19 guidance and compare it with the existing deployment checks listed in the issue. Add an existing-deployment readiness and migration section that distinguishes in-place troubleshooting, repairable configuration, and cases requiring account recreation.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- azure
- Domain
- cloud, documentation, networking
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 68/100