Skip to content

Conversation

@ponarunkumar
Copy link

@ponarunkumar ponarunkumar commented Dec 2, 2025

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant