github-samples / github-samples/pets-workshop

full-day workshop: Align Azure deployment steps with current azd infrastructure generation

Open
#269 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

priority: P0
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.bicep before the edit step, with any required azd infra gen command documented.
  • The supported/tested azd version is stated.
  • Learners validate the services detected by azd init --from-code.
  • The API_SERVER_URL edit 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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.