P1: Add ACA bootstrap contract guardrail in CI
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 35/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Stale
- Tech stack
- azure
- Domain
- cloud, devops, documentation
Research direction
Start by inspecting the workflow path for the backend ACA bootstrap contract and review recovery workflow PR #102 alongside incident #86. Add the guard and the runbook note in docs/runbooks/azd-deployment.md; done means CI classifies failures, reports affected services with expected and observed values, and documents the behavior.
Written by the indexing model from the issue text.
Description
Context\nDeployment blocker #86 showed repeated ACA revision Operation expired failures while affected apps retained placeholder bootstrap runtime settings.\n\n## Goal\nAdd a CI guardrail that validates ACA bootstrap/runtime contract assumptions early and fails with actionable diagnostics when drift/mismatch is detected.\n\n## Acceptance Criteria\n- [ ] Add automated guard step in workflow path (or dedicated reusable check) for backend ACA bootstrap contract\n- [ ] Guard emits clear classification in step summary (e.g., PortMismatch, PlaceholderStuck, ControlPlaneTimeout)\n- [ ] Guard output includes affected service names and expected vs observed values\n- [ ] Add runbook note in docs/runbooks/azd-deployment.md referencing guard behavior\n\n## Links\n- Parent incident: #86\n- Recovery workflow PR: #102
- Dominant language
- Python
- Stars
- 17
- Forks
- 8
- PR merge metrics
- No merged PRs in 30d
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.
More from Azure-Samples/tutor
-
Difficulty 4/5 3-5 days Newbie friendliness 35/100
Azure-Samples/tutor#230 ·
-
Difficulty 4/5 3-5 days Newbie friendliness 45/100
Azure-Samples/tutor#229 · 1 comment ·
-
frontend priority:P2 type:tech-debt
Difficulty 5/5 Over a week Newbie friendliness 35/100
Azure-Samples/tutor#224 · 3 comments ·
-
component:ci-cd frontend priority:P1 type:tech-debt
Difficulty 5/5 Over a week Newbie friendliness 35/100
Azure-Samples/tutor#223 · 2 comments ·
-
frontend priority:P1 type:feature
Difficulty 5/5 Over a week Newbie friendliness 30/100
Azure-Samples/tutor#222 · 1 comment ·
All issues in Azure-Samples/tutor
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100