get-started-with-ai-agents icon indicating copy to clipboard operation
get-started-with-ai-agents copied to clipboard

Updated the pre-requisite section with (optional) step to avoid bicep runtime download error while using azd up

Open ponarunkumar opened this issue 4 weeks ago • 0 comments

Instructs users to run az bicep install/az bicep version (or provide a standalone bicep binary) before invoking azd up. Reduces dependency on ad-hoc downloads during deployment and ensures consistent Bicep versions in all environments.

Why It’s Important

  • Prevents broken deployments: Installing Bicep up front avoids the common “context canceled” download errors that halt provisioning.
  • Saves developer time: Instead of waiting for azd up to fail midway, users get immediate feedback that their toolchain is incomplete.
  • Improves reproducibility: Teams can standardize on the Azure CLI-distributed Bicep version, eliminating mismatches between local dev, Codespaces, and CI pipelines.
  • Enhances documentation completeness: The deployment guide now reflects the real prerequisites for this IaC workflow, reducing friction for new adopters.

azd up must compile every file under infra/*.bicep before provisioning. When Bicep isn’t installed locally, azd tries to download a pinned binary (v0.38.33) from downloads.bicep.azure.com. In constrained environments (Codespaces, corporate networks, intermittent connectivity) that download frequently fails, producing the failed resolving IaC provider 'bicep' error and blocking all deployments. Users currently have no warning that Bicep is required upfront, so the failure surfaces only after several minutes of provisioning work, costing time and contributing to false “azd” troubleshooting reports.

ponarunkumar avatar Dec 02 '25 19:12 ponarunkumar