Radius.Core/environments@2025-08-01-preview

Description

The Radius.Core/environments Resource Type represents a Radius Environment: the deployment target that platform engineers configure for their developers. Every Radius Application is deployed to an Environment through its environment property.

An Environment defines three things for the Applications deployed to it:

• Where resources are deployed: the target compute platform and cloud provider accounts, set through the providers property.
• Which Recipes are used: the Recipe Packs whose Recipes provision the infrastructure backing application resources, set through the recipePacks property.
• Advanced Terraform and Bicep settings: environment-wide Recipe parameters and Terraform or Bicep engine configuration applied when Recipes run.

Defining an Environment

The simplest Environment can be created directly with the rad environment create command, without a Bicep file:

rad environment create my-environment

For more advanced configurations, define an Environment as a Radius.Core/environments resource in a Bicep file. For example:

extension radius

resource myEnvironment 'Radius.Core/environments@2025-08-01-preview' = {
  name: 'my-environment'
  properties: {
    recipePacks: [
      myRecipePack.id
    ]
    providers: {
      kubernetes: {
        namespace: 'my-namespace'
      }
    }
  }
}

resource myRecipePack 'Radius.Core/recipePacks@2025-08-01-preview' existing = {
  name: 'my-recipe-pack'
}

Both properties are optional. When you create an Environment with the Radius CLI, an omitted providers defaults to Kubernetes in the default namespace, and an omitted recipePacks defaults to the default Recipe Pack in the default resource group.

Deploying an Environment

Deploy a defined Environment with the rad deploy command:

rad deploy ./environment.bicep

Cloud providers

To use Recipes that provision resources in a cloud provider, you must configure that provider’s account details on the Environment by setting the providers property. For AWS, set the account ID and the region resources are deployed to:

extension radius

resource myEnvironment 'Radius.Core/environments@2025-08-01-preview' = {
  name: 'my-environment'
  properties: {
    providers: {
      aws: {
        accountId: '123456789012'
        region: 'us-west-2'
      }
    }
  }
}

For Azure, set the subscription ID and the name of the resource group that resources are deployed to:

extension radius

resource myEnvironment 'Radius.Core/environments@2025-08-01-preview' = {
  name: 'my-environment'
  properties: {
    providers: {
      azure: {
        subscriptionId: '00000000-0000-0000-0000-000000000000'
        resourceGroupName: 'my-resource-group'
      }
    }
  }
}

The providers property selects the target account, but the credentials Radius uses to authenticate to AWS and Azure are configured separately with the rad credential register command.

Recipe Packs

A Recipe Pack is a collection of Recipes, defined as a separate Radius.Core/recipePacks resource. A Recipe is an infrastructure-as-code module, a Terraform module or Bicep template, that provisions the infrastructure backing an application resource. Reference one or more Recipe Packs by their resource IDs in the recipePacks property to control which Recipes are used. See the Radius.Core/recipePacks documentation for details.

Use recipeParameters to pass environment-specific parameters to the Recipes defined in the referenced Recipe Packs, for example to standardize configuration such as SKUs or instance sizes across an Environment.

Advanced Terraform and Bicep settings

For advanced Terraform and Bicep settings, such as private module sources and registry authentication, reference a Radius.Core/terraformSettings or Radius.Core/bicepSettings resource from the terraformSettings and bicepSettings properties.

Top-Level Properties

Object Properties

providers

providers.aws

providers.azure

providers.kubernetes

providers.azure.identity