fix(cli): improve error message when deploying Radius types with wrong API version

[officialasishkumar]

Description

When a Bicep template uses a Radius resource type with an unsupported API version (e.g., Radius.Core/applications@2023-10-01-preview), the Bicep compiler cannot resolve the type and treats it as a passthrough ARM resource. The deployment engine then routes it through Azure, producing a misleading error:

"Azure deployment failed, please ensure you have configured an Azure provider with your Radius environment"

This is confusing because the user intended to deploy a Radius resource, not an Azure resource. The actual problem is that the API version is wrong for the given resource type namespace.

This change detects the mismatch between the error (Azure-related) and the template contents (Radius-only resource types) and wraps the error with a clear, actionable message that suggests checking the API version for each resource type. After this change, users will see:

Deployment failed with an Azure provider error, but the template only contains Radius resource types.
This commonly happens when a resource type is used with an incorrect or unsupported API version,
causing it to be misrouted. Please verify that each resource uses a supported API version.

For example, Radius.Core types use API version '2025-08-01-preview' and Applications.Core types use '2023-10-01-preview'.

Changes

• pkg/cli/bicep/resources.go: Add ExtractResourceTypes, IsRadiusResourceType, and HasOnlyRadiusResourceTypes helpers for template resource type analysis
• pkg/cli/cmd/deploy/deploy.go: Add addDeploymentErrorContext to detect and contextualize misleading Azure errors for Radius-only templates
• pkg/cli/bicep/resources_test.go: Add comprehensive unit tests for resource type extraction and classification
• pkg/cli/cmd/deploy/deploy_test.go: Add unit tests for the error context wrapping logic

Type of change

• This pull request fixes a bug in Radius and has an approved issue (issue link required).

Fixes: #11462

Contributor checklist

Please verify that the PR meets the following requirements, where applicable:

• An overview of proposed schema changes is included in a linked GitHub issue.
  • Yes
  • Not applicable
• A design document PR is created in the design-notes repository, if new APIs are being introduced.
  • Yes
  • Not applicable
• The design document has been reviewed and approved by Radius maintainers/approvers.
  • Yes
  • Not applicable
• A PR for the samples repository is created, if existing samples are affected by the changes in this PR.
  • Yes
  • Not applicable
• A PR for the documentation repository is created, if the changes in this PR affect the documentation or any user facing updates are made.
  • Yes
  • Not applicable
• A PR for the recipes repository is created, if existing recipes are affected by the changes in this PR.
  • Yes
  • Not applicable

[Copilot]

Pull request overview

This PR improves the rad deploy UX when a Radius resource type is used with an unsupported/incorrect API version and is consequently misrouted through Azure, producing a misleading “configure an Azure provider” error.

Changes:

• Wrap misleading Azure-related deployment errors with actionable context when the compiled template contains only Radius resource types.
• Add Bicep template helpers to extract and classify resource types (Radius vs non-Radius).
• Add unit tests covering resource type extraction/classification and the deployment error wrapping behavior.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File	Description
pkg/cli/cmd/deploy/deploy.go	Wraps Azure-related deployment errors with additional context when the template contains only Radius types.
pkg/cli/cmd/deploy/deploy_test.go	Adds unit tests validating when deployment errors are wrapped vs returned unchanged.
pkg/cli/bicep/resources.go	Adds helpers to extract resource types and detect whether a template contains only Radius resource types.
pkg/cli/bicep/resources_test.go	Adds unit tests for resource type extraction and Radius-namespace classification.

[willdavsmith]

thanks for the contribution! added a couple of comments

[Copilot]

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.

[willdavsmith]

Looks pretty good to me. Can you address the copilot comments and add sign-offs to the commits to resolve DCO?

[officialasishkumar]

Addressed the remaining review feedback in cf1a6236a

[codecov]

Codecov Report

❌ Patch coverage is 82.14286% with 15 lines in your changes missing coverage. Please review.
✅ Project coverage is 51.45%. Comparing base (ec789e8) to head (a58fa3b).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
pkg/cli/cmd/deploy/deploy.go	70.45%	7 Missing and 6 partials ⚠️
pkg/cli/bicep/resources.go	95.00%	1 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #11557      +/-   ##
==========================================
+ Coverage   51.40%   51.45%   +0.05%     
==========================================
  Files         699      699              
  Lines       44036    44119      +83     
==========================================
+ Hits        22638    22703      +65     
- Misses      19244    19253       +9     
- Partials     2154     2163       +9     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[radius-functional-tests]

Radius functional test overview

🔍 Go to test action run

Click here to see the test run details

Name	Value
Repository	officialasishkumar/radius
Commit ref	a58fa3b
Unique ID	func0a6da1cf9e
Image tag	pr-func0a6da1cf9e

• gotestsum 1.13.0
• KinD: v0.29.0
• Dapr: 1.14.4
• Azure KeyVault CSI driver: 1.4.2
• Azure Workload identity webhook: 1.3.0
• Bicep recipe location ghcr.io/radius-project/dev/test/testrecipes/test-bicep-recipes/<name>:pr-func0a6da1cf9e
• Terraform recipe location http://tf-module-server.radius-test-tf-module-server.svc.cluster.local/<name>.zip (in cluster)
• applications-rp test image location: ghcr.io/radius-project/dev/applications-rp:pr-func0a6da1cf9e
• dynamic-rp test image location: ghcr.io/radius-project/dev/dynamic-rp:pr-func0a6da1cf9e
• controller test image location: ghcr.io/radius-project/dev/controller:pr-func0a6da1cf9e
• ucp test image location: ghcr.io/radius-project/dev/ucpd:pr-func0a6da1cf9e
• deployment-engine test image location: ghcr.io/radius-project/deployment-engine:latest

Test Status

⌛ Building Radius and pushing container images for functional tests...
✅ Container images build succeeded
⌛ Publishing Bicep Recipes for functional tests...
✅ Recipe publishing succeeded
⌛ Starting corerp-cloud functional tests...
⌛ Starting ucp-cloud functional tests...
✅ ucp-cloud functional tests succeeded
✅ corerp-cloud functional tests succeeded