github-samples / github-samples/pets-workshop
full-day workshop: Align Azure deployment steps with current azd infrastructure generation
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 80
- Forks
- 161
- Avg merge
- 31m
- Merged PRs (30d)
- 1
Description
Problem
Exercise 8 runs azd init --from-code and immediately tells learners to edit infra/resources.bicep. That file is not tracked in the template. The checked-in next-steps.md, generated for the current azd flow, states that azd initially generates infrastructure in memory and that learners must run azd infra gen to persist infra/main.bicep, infra/resources.bicep, and modules.
The exercise therefore assumes a generated file that may not exist. It also relies on a fixed location near line 130 and specific client/server output names, although generated azd output can vary by version and detection result.
Suggested change
Pin or state a tested azd version and document the complete, reproducible path that creates editable Bicep before asking learners to modify it.
Acceptance criteria
- A fresh run produces
infra/resources.bicepbefore the edit step, with any requiredazd infra gencommand documented. - The supported/tested azd version is stated.
- Learners validate the services detected by
azd init --from-code. - The
API_SERVER_URLedit identifies the correct resource structurally rather than by approximate line number. - Bicep validation runs before
azd pipeline config. - The generated workflow and deployed endpoints are verified using the documented flow.
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 with Exercise 8 and the checked-in next-steps.md, then run azd init --from-code and azd infra gen to compare the generated infra/main.bicep, infra/resources.bicep, and modules with the documented flow. Document a tested azd version, service validation, structural API_SERVER_URL guidance, Bicep validation, and verification of the generated workflow and deployed endpoints.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- azure, github-actions
- Domain
- cloud, devops, documentation, infrastructure
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 68/100